Obtener documento por ejercicio, serie y número
Descripción
Section titled “Descripción”Endpoint para obtener un documento completo con sus líneas por su ejercicio, serie y número.
Parámetros de consulta
Section titled “Parámetros de consulta”| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoDocumento | enum | ✅ | Tipo de documento (Lista seleccionable) |
ejercicioDocumento | int | ✅ | Ejercicio del documento |
numeroDocumento | int | ✅ | Número del documento |
serieDocumento | string | ❌ | Serie del documento |
generarPdf | string | ❌ | Habilita la generación del Pdf (Formato Base64) |
mascaraInforme | string | 🔶 | Permite elegir la máscara del documento, si generarPdf está en true, este campo es obligatorio |
camposCabecera | string | ❌ | Si rellenas este campo, solo devolverá los campos que indiques en la cabecera. Puedes añadir más de uno separados por comas. |
camposLineas | string | ❌ | Si rellenas este campo, solo devolverá los campos que indiques en las líneas. Puedes añadir más de uno separados por comas. |
codigoEmpresa | int | ✅ (si es multiempresa) | Código de la empresa |
Ejemplo con filtros
Section titled “Ejemplo con filtros”# Obtener documento por número y seriecurl -X GET "https://api.tandem.com/api/common/documentos/AlbaranVenta/2025/8?serieDocumento=ZZ&generarPdf=true&mascaraInforme=GES_LisAlbaranClienteExp" \ -H "Authorization: Bearer tu_access_token"Respuesta exitosa (200)
Section titled “Respuesta exitosa (200)”{ "success": true, "message": "Documento completo obtenido.", "result": { "codigoEmpresa": 9999, "idDelegacion": "", "ejercicioAlbaran": 2025, "serieAlbaran": "ZZ", "numeroAlbaran": 8, "fechaAlbaran": "2025-01-30T00:00:00", "codigoCliente": "000021", "codigoCadena_": "", "numeroLineas": 1, "siglaNacion": "ES", "cifDni": "43000002F", "cifEuropeo": "ES43000002F", "razonSocial": "CLIENTE PRUEBAS", "razonSocialEnvios": "CLIENTE PRUEBAS", "razonSocial2": "", "razonSocial2Envios": "", "nombre": "CLIENTE PRUEBAS", "nombreEnvios": "CLIENTE PRUEBAS", "domicilio": "CL/NUEVA,1", "domicilioEnvios": "CL/NUEVA,1", "domicilio2": "", "domicilio2Envios": "", "viaPublicaEnvios": "NUEVA", "codigoPostal": "14005", "codigoPostalEnvios": "14005", "codigoMunicipio": "14021", "codigoMunicipioEnvios": "14021", "municipio": "CÓRDOBA", "municipioEnvios": "CÓRDOBA", "colaMunicipio": "", "colaMunicipioEnvios": "", "codigoProvincia": "14", "codigoProvinciaEnvios": "14", "provincia": "CÓRDOBA", "provinciaEnvios": "CÓRDOBA", "codigoNacion": 108, "codigoNacionEnvios": 108, "nacion": "ESPAÑA", "nacionEnvios": "ESPAÑA", "telefonoEnvios": "", "faxEnvios": "", "codigoCondiciones": 0, "formadePago": "", "numeroPlazos": 1, "diasPrimerPlazo": 0, "diasEntrePlazos": 0, "diasFijos1": 0, "diasFijos2": 0, "diasFijos3": 0, "inicioNoPago": 0, "finNoPago": 0, "controlarFestivos": 0, "diasRetroceso": 0, "mesesComerciales": 0, "codigoTransportistaEnvios": 0, "tipoPortesEnvios": "D", "codigoTransaccion": 1, "codigoRetencion": 0, "codigoTipoEfecto": 0, "domicilioEnvio": 0, "domicilioFactura": 0, "domicilioRecibo": 0, "codigoDefinicion_": "", "codigoContable": "430000021", "remesaHabitual": "572000000", "codigoBanco": "", "codigoAgencia": "", "dc": "", "ccc": "", "iban": "", "codigoTerritorio": 0, "indicadorIva": "I", "ivaIncluido": 0, "grupoIva": 0, "tarifaPrecio": 0, "tarifaDescuento": 0, "codigoComisionista": 0, "codigoComisionista2_": 0, "codigoComisionista3_": 0, "codigoComisionista4_": 0, "codigoJefeVenta_": 0, "codigoJefeZona_": 0, "codigoZona": 0, "codigoCanal": "", "codigoRuta_": "", "codigoProyecto": "", "codigoSeccion": "", "codigoDepartamento": "", "bloqueo": 0, "statusFacturado": -1, "statusListadoAlbaran": -1, "statusEstadis": 0, "statusEtiquetaEnvio": 0, "statusAlbaranEnvio": 0, "statusAbono": 0, "statusContabilizado": 0, "statusAnalitica": 0, "albaranValorado": -1, "periodicidadFacturas": 0, "agruparAlbaranes": 0, "copiasAlbaran": 0, "copiasFactura": 0, "packingList_": 0, "mascaraAlbaran_": "", "mascaraFactura_": "", "observacionesCliente": "", "observacionesAlbaran": "", "observacionesFactura": "", "%Descuento": 0, "%ProntoPago": 0, "%Financiacion": 0, "%Retencion": 0, "%Rappel": 0, "%Comision": 0, "%Comision2_": 0, "%Comision3_": 0, "%Comision4_": 0, "comisionSobreVenta%_": 0, "comisionSobreZona%_": 0, "suPedido": "", "ejercicioPedido": 0, "seriePedido": "", "numeroPedido": 0, "fechaFactura": "2025-01-30T00:00:00", "ejercicioFactura": 2025, "serieFactura": "ZZ", "numeroFactura": 6, "enEuros_": -1, "codigoDivisa": "", "codigoIdioma_": "", "factorCambio": 0, "mantenerCambio_": -1, "bultos": 0, "importeEnvases_": 0, "importeEnvasesDivisa_": 0, "importePortes": 0, "importePortesDivisa_": 0, "importeCambio": 0, "importeCambioViejo_": 0, "importeCoste": 0, "importeBruto": 175.8, "importeBrutoDivisa_": 0, "importeDescuentoLineas": 0, "importeDtoLineasDivisa_": 0, "importeNetoLineas": 175.8, "importeNetoLineasDivisa_": 0, "importeDescuento": 0, "importeDescuentoDivisa_": 0, "baseComision": 175.8, "baseComisionDivisa_": 0, "importeComision": 0, "importeComision2_": 0, "importeComision3_": 0, "importeComision4_": 0, "importeComisionJefeVentas_": 0, "importeComisionJefeZona_": 0, "importeProntoPago": 0, "importeProntoPagoDivisa_": 0, "baseImponible": 175.8, "baseImponibleDivisa_": 0, "totalCuotaIva": 36.92, "totalCuotaIvaDivisa_": 0, "totalCuotaRecargo": 0, "totalCuotaRecargoDivisa_": 0, "totalIva": 36.92, "totalIvaDivisa_": 0, "importeFinanciacion": 0, "importeFinanciacionDivisa_": 0, "importeFactura": 212.72, "importeFacturaDivisa_": 0, "importeRetencion": 0, "importeRetencionDivisa_": 0, "importeLiquido": 212.72, "importeLiquidoDivisa_": 0, "importeRappel": 0, "importeRappelDivisa_": 0, "codigoExportacion_": "", "condicionExportacion_": "", "observacionExportacion_": "", "observacionExportacion2_": "", "puertoOrigen_": "", "puertoDestino_": "", "pesoBruto_": 0, "pesoNeto_": 0, "volumen_": 0, "importeFletes_": 0, "importeFletesDivisa_": 0, "importeSeguro_": 0, "importeSeguroDivisa_": 0, "gastosAduana_": 0, "gastosAduanaDivisa_": 0, "ejercicioFacturaOriginal": 0, "serieFacturaOriginal": "", "numeroFacturaOriginal": 0, "codigoTipoOperacionLc": "", "codigoTipoOperacionOrigenLc": "", "codigoDivisionLc": "", "codigoAmbitoClienteLc": "", "codigoClaseClienteLc": "", "codigoSubclaseClienteLc": "", "codigoTipoClienteLc": "DF", "codigoGrupoClienteLc": "", "codigoActividadLc": "", "codigoSubactividadLc": "", "comercialAsignadoLc": 0, "facturarCompletoLc": 0, "idFacturarCompletoLc": 0, "idFacturacionConjuntaLc": 0, "idDelegacionCentralLc": "", "numeroCaja": 0, "numeroInterno": 0, "referenciaEdi_": "", "codigoMotivoAbonoLc": "", "ejercicioAlbaranOriginalLc": 0, "serieAlbaranOriginalLc": "", "numeroAlbaranOriginalLc": 0, "statusEnvioXML": 0, "statusCreadoXML": 0, "tipoNuevaFra": 0, "generarFactura": " ", "importeACuentaA_": 0, "importeACuentaADivisa_": 0, "importeConsumidoA": 0, "importeConsumidoADivisa_": 0, "ejercicioAlbaranDevolucionA": 0, "serieAlbaranDevolucionA": "", "numeroAlbaranDevolucionA": 0, "importePendienteAAC": 0, "importePendienteAACDivisa_": 0, "entrega": 0, "desgloseContenido_": 1, "calculoDeBultos_": 1, "porMargenBeneficio": 100, "margenBeneficio": 175.8, "ejercicioExpediente": 0, "serieExpediente": "", "numeroExpediente": 0, "origenDespacho": 0, "importeProvisiones": 0, "importeProvisionesNF": 0, "importeSuplidos": 0, "importeProvisionesDivisa": 0, "importeProvisionesNFDivisa": 0, "importeSuplidosDivisa": 0, "codigoContableANT_": "", "remesaHabitualANT_": "", "anaLote": "", "anaCapitulo": "", "esTicket": 0, "numeroTerminalSR": 0, "numeroTurnoSR": 0, "fechaCreacion": "2025-01-30T13:10:46.647", "horaCreacion": 0, "noFacturable": 0, "movConta": "00000000-0000-0000-0000-000000000000", "observacionesWeb": "", "suPedidoWeb": 0, "idAlbaranCli": "540f0ccc-7e4c-45c1-90a0-8839142277aa", "envioEFactura": 0, "matricula": "", "matricula2": "", "referenciaMandato": "", "suContrato": "", "pagoInmediato": 0, "idAlbaranProAF": "00000000-0000-0000-0000-000000000000", "tpvIdProcesoArqueo": "00000000-0000-0000-0000-000000000000", "informeagencia": -1, "almacenContrapartida": "", "suAlbaranNo": "", "incidenciaAlbaran": "", "pesoVolumetricoO": 0, "pesoVolumetricoS": 0, "statusMailingLc": 0, "palets": 0, "tS_ExportarAgencia": -1, "tS_Retorno": 0, "tS_Sabado": 0, "tS_Acuse": 0, "tS_Valor": 0, "idImagenTPV": "00000000-0000-0000-0000-000000000000", "imagenTPV": null, "firmaDocumento": "00000000-0000-0000-0000-000000000000", "fechaFirma": null, "tS_EstadoAlbaranPDA": 0, "tS_EstadoFirma": 0, "tS_FicheroFirma": "00000000-0000-0000-0000-000000000000", "tS_FechaFirma": null, "tS_NombreFirma": "", "tS_Seguimiento": "", "tS_Expedicion": "", "lineasAlbaranCliente": [ { "codigoEmpresa": 9999, "ejercicioAlbaran": 2025, "serieAlbaran": "ZZ", "numeroAlbaran": 8, "orden": 5, "lineasPosicion": "3c58e779-92f2-444b-9343-08b27e0b9582", "lineasPosicionCompuesto": "00000000-0000-0000-0000-000000000000", "lineasPosicionRegalo": "00000000-0000-0000-0000-000000000000", "lineaPedido": "00000000-0000-0000-0000-000000000000", "fechaRegistro": "2025-01-30T13:10:53.993", "fechaAlbaran": "2025-01-30T00:00:00", "codigoArticulo": "31CREL002", "codigoAlmacen": "CEN", "almacenContrapartida": "", "partida": "", "descripcionArticulo": "100% Recycled Bin Liners, Heavy Duty 100L, 10 Bin ", "descripcion2Articulo": "", "descripcionLinea": "", "codigodelCliente": "", "codigoFamilia": "", "codigoSubfamilia": "", "unidadMedida1_": "", "unidadMedida2_": "", "factorConversion_": 1, "codigoProyecto": "", "codigoSeccion": "", "codigoDepartamento": "", "statusStock": -1, "statusEstadis": 0, "ivaIncluido": 0, "bloqueoRebaje_": 0, "acumulaEstadistica_": -1, "codigoArancelario": "", "codigoDefinicion_": "", "codigoTransaccion": 1, "fechaCaduca": null, "ubicacion": "", "suPedido": "", "ejercicioPedido": 0, "seriePedido": "", "numeroPedido": 0, "ejercicioFactura": 2025, "serieFactura": "ZZ", "numeroFactura": 6, "codigoComisionista": 0, "codigoComisionista2_": 0, "codigoComisionista3_": 0, "codigoComisionista4_": 0, "codigoJefeVenta_": 0, "codigoJefeZona_": 0, "codigoColor_": "", "grupoTalla_": 0, "codigoTalla01_": "", "grupoIva": 1, "codigoIva": 21, "formulaLote": 0, "lote_": 0, "componente": 0, "tipoEnvase_": 0, "numeroEnvases_": 0, "codigoAgrupacion": 0, "numeroAgrupaciones": 0, "unidadesAgrupacion": 0, "unidadesServidas": 0, "unidadesRegalo": 0, "unidades": 20, "unidades2_": 20, "precio": 8.79, "precioEnvase_": 0, "precioRebaje": 8.79, "precioCoste": 0, "bultos": 0, "ordenBulto_": 0, "%Descuento": 0, "%Descuento2": 0, "%Descuento3": 0, "%Iva": 21, "%Recargo": 0, "%BaseCorreccion": 0, "%Comision": 0, "%Comision2_": 0, "%Comision3_": 0, "%Comision4_": 0, "comisionSobreVenta%_": 0, "comisionSobreZona%_": 0, "pesoBrutoUnitario_": 0, "pesoBruto_": 0, "pesoNetoUnitario_": 0, "pesoNeto_": 0, "volumenUnitario_": 0, "volumen_": 0, "importeCoste": 0, "importeBruto": 175.8, "importeBrutoDivisa_": 0, "importeDescuento": 0, "importeDescuentoDivisa_": 0, "importeNeto": 175.8, "importeNetoDivisa_": 0, "importeDescuentoCliente": 0, "importeDtoClienteDivisa_": 0, "baseComision": 175.8, "baseComisionDivisa_": 0, "importeComision": 0, "importeComision2_": 0, "importeComision3_": 0, "importeComision4_": 0, "importeComisionJefeVentas_": 0, "importeComisionJefeZona_": 0, "importeProntoPago": 0, "importeProntoPagoDivisa_": 0, "baseImponible": 175.8, "baseImponibleDivisa_": 0, "baseIva": 175.8, "baseIvaDivisa_": 0, "cuotaIva": 36.918, "cuotaIvaDivisa_": 0, "cuotaRecargo": 0, "cuotaRecargoDivisa_": 0, "totalIva": 36.918, "totalIvaDivisa_": 0, "importeLiquido": 212.718, "importeLiquidoDivisa_": 0, "importeRappel": 0, "importeRappelDivisa_": 0, "importeEnvases_": 0, "importeEnvasesDivisa_": 0, "codigoCategoriaLc": "", "codigoSubcategoriaLc": "", "codigoTipoArticuloLc": "", "codigoSubtipoArticuloLc": "", "codigoGrupoArticuloLc": "", "codigoSubgrupoArticuloLc": "", "codigoModoLc": "", "codigoFabricanteLc": "", "codigoTipoPeriodicidadPrecioLc": "", "idPrecioLc": "", "codigoTipoOperacionLc": "", "codigoFamiliaFabricanteLc": "", "codigoConjuntoLc": "", "codigoSubconjuntoLc": "", "trataNumerosSerieLc": 0, "codigoAreaLc": "", "tipoArticulo": "M", "reservarStock_": 0, "abonadaLc": 0, "unidadesAbonadasLc": 0, "lineaPosAbonoLc": "00000000-0000-0000-0000-000000000000", "numeroSerieLc": "", "factorPrecioVenta_": 1, "tipoUnidadCalculo_": 0, "largo_": 0, "alto_": 0, "ancho_": 0, "dimension_": 0, "codigoDun14": "", "porMargenBeneficio": 100, "margenBeneficio": 175.8, "unidades2AbonadasLc": 0, "ediSellerNumber": "", "ediBatchNumber": "", "ediISBN": "", "ediSerialNumber": "", "ediEtiquetaEAN": "", "ejercicioExpediente": 0, "serieExpediente": "", "numeroExpediente": 0, "suplido": 0, "movOrigenSuplido": "00000000-0000-0000-0000-000000000000", "codigoPerceptor": "", "anaLote": "", "anaCapitulo": "", "precioTotal": 0, "tarifaPrecioLin": 0, "suContrato": "", "causaExencion": "", "tipoNoSujeta": "", "palet": 0, "tS_OrdenBulto": 0 } ] }}