Skip to content
Documentación API

Obtener documento por número y serie

GET /api/common/documentos/{tipoDocumento}/{ejercicioDocumento}/{numeroDocumento} V4

Descripción

Section titled “Descripción”

Endpoint para obtener un documento por su número y serie de documento.

Parámetros de consulta

Section titled “Parámetros de consulta”
ParámetroTipoRequeridoDescripción
tipoDocumentoenum✅Tipo de documento (Lista seleccionable)
ejercicioDocumentoint✅Ejercicio del documento
numeroDocumentoint✅Número del documento
serieDocumentostring❌Serie del documento
generarPdfstring❌Habilita la generación del Pdf (Formato Base64)
mascaraInformestring🔶Permite elegir la máscara del documento, si generarPdf está en true, este campo es obligatorio
camposCabecerastring❌Si rellenas este campo, solo devolverá los campos que indiques en la cabecera. Puedes añadir más de uno separados por comas.
camposLineasstring❌Si rellenas este campo, solo devolverá los campos que indiques en las líneas. Puedes añadir más de uno separados por comas.
codigoEmpresaint✅ (si es multiempresa)Código de la empresa

Ejemplo con filtros

Section titled “Ejemplo con filtros”
Terminal window
# Obtener documento por número y serie
curl -X GET "https://api.tandem.com/api/common/documentos/FacturaVenta/2025/1?serieDocumento=ZZ&generarPdf=true&mascaraInforme=GES_LisDiaFacCli" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

Section titled “Respuesta exitosa (200)”
{
  "success": true,
  "message": "Éxito",
  "result": {
    "CodigoEmpresa": 9999,
    "IdDelegacion": "",
    "EjercicioFactura": 2025,
    "SerieFactura": "ZZ",
    "NumeroFactura": 1,
    "FechaFactura": "2025-02-14T00:00:00",
    "CodigoCliente": "000001",
    "MovPosicion": "85913c42-4f91-4fed-999f-d7df21c7e347",
    "SiglaNacion": "ES",
    "CifDni": "80150811C",
    "CifEuropeo": "ES80150811C",
    "RazonSocial": "ANTONIO GONZALEZ",
    "RazonSocial2": "",
    "Nombre": "ANTONIO GONZALEZ",
    "Domicilio": "AV/Avda. de la Construccion,10",
    "Domicilio2": "",
    "CodigoPostal": "28001",
    "CodigoMunicipio": "28079",
    "Municipio": "MADRID",
    "ColaMunicipio": "",
    "CodigoProvincia": "28",
    "Provincia": "MADRID",
    "CodigoNacion": 108,
    "Nacion": "ESPAÑA",
    "CodigoContable": "430000001",
    "RemesaHabitual": "572000000",
    "CodigoDefinicion_": "",
    "CodigoBanco": "",
    "CodigoAgencia": "",
    "DC": "",
    "CCC": "",
    "IBAN": "",
    "CodigoTipoEfecto": 0,
    "CodigoTransaccion": 1,
    "CodigoRetencion": 0,
    "FormadePago": "",
    "NumeroPlazos": 1,
    "DiasPrimerPlazo": 0,
    "DiasEntrePlazos": 0,
    "DiasFijos1": 0,
    "DiasFijos2": 0,
    "DiasFijos3": 0,
    "InicioNoPago": 0,
    "FinNoPago": 0,
    "ControlarFestivos": 0,
    "DiasRetroceso": 0,
    "MesesComerciales": 0,
    "DomicilioRecibo": 0,
    "StatusAbono": 0,
    "StatusFacturaListada": -1,
    "StatusCartera": 0,
    "StatusContabilidad": 0,
    "MascaraFactura_": "",
    "CopiasFactura": 0,
    "IndicadorIva": "I",
    "IvaIncluido": 0,
    "%Descuento": 0,
    "%ProntoPago": 0,
    "%Retencion": 0,
    "%Financiacion": 0,
    "%Rappel": 0,
    "CodigoComisionista": 0,
    "CodigoComisionista2_": 0,
    "CodigoComisionista3_": 0,
    "CodigoComisionista4_": 0,
    "CodigoJefeVenta_": 0,
    "CodigoJefeZona_": 0,
    "%Comision": 0,
    "%Comision2_": 0,
    "%Comision3_": 0,
    "%Comision4_": 0,
    "ComisionSobreVenta%_": 0,
    "ComisionSobreZona%_": 0,
    "CodigoProyecto": "",
    "CodigoSeccion": "",
    "CodigoDepartamento": "",
    "CodigoTerritorio": 0,
    "CodigoZona": 0,
    "CodigoCanal": "",
    "TipoPortesEnvios": "D",
    "CodigoExportacion_": "",
    "CondicionExportacion_": "",
    "ObservacionExportacion_": "",
    "ObservacionExportacion2_": "",
    "ObservacionesCliente": "",
    "ObservacionesFactura": "",
    "PuertoOrigen_": "",
    "PuertoDestino_": "",
    "PesoBruto_": 0,
    "PesoNeto_": 0,
    "Volumen_": 0,
    "Bultos": 0,
    "EnEuros_": -1,
    "CodigoDivisa": "",
    "MantenerCambio_": -1,
    "FactorCambio": 0,
    "ImporteCambio": 0,
    "ImporteCambioViejo_": 0,
    "ImporteCoste": 0,
    "ImportePortes": 0,
    "ImportePortesDivisa_": 0,
    "ImporteBruto": 100,
    "ImporteBrutoDivisa_": 0,
    "ImporteDescuentoLineas": 0,
    "ImporteDtoLineasDivisa_": 0,
    "ImporteNetoLineas": 100,
    "ImporteNetoLineasDivisa_": 0,
    "ImporteDescuento": 0,
    "ImporteDtoClienteDivisa_": 0,
    "BaseComision": 100,
    "BaseComisionDivisa_": 0,
    "ImporteComision": 0,
    "ImporteComision2_": 0,
    "ImporteComision3_": 0,
    "ImporteComision4_": 0,
    "ImporteComisionJefeVentas_": 0,
    "ImporteComisionJefeZona_": 0,
    "ImporteProntoPago": 0,
    "ImporteProntoPagoDivisa_": 0,
    "BaseImponible": 100,
    "BaseImponibleDivisa_": 0,
    "TotalCuotaIva": 21,
    "TotalCuotaIvaDivisa_": 0,
    "TotalCuotaRecargo": 0,
    "TotalCuotaRecargoDivisa_": 0,
    "TotalIva": 21,
    "TotalIvaDivisa_": 0,
    "ImporteFinanciacion": 0,
    "ImporteFinanciacionDivisa_": 0,
    "ImporteFactura": 121,
    "ImporteFacturaDivisa_": 0,
    "ImporteRetencion": 0,
    "ImporteRetencionDivisa_": 0,
    "ImporteLiquido": 121,
    "ImporteLiquidoDivisa_": 0,
    "ImporteRappel": 0,
    "ImporteRappelDivisa_": 0,
    "ImporteFletes_": 0,
    "ImporteFletesDivisa_": 0,
    "ImporteSeguro_": 0,
    "ImporteSeguroDivisa_": 0,
    "GastosAduana_": 0,
    "GastosAduanaDivisa_": 0,
    "ImporteEnvases_": 0,
    "ImporteEnvasesDivisa_": 0,
    "EjercicioFacturaOriginal": 0,
    "SerieFacturaOriginal": "",
    "NumeroFacturaOriginal": 0,
    "StatusAnalitica": 0,
    "MovAnalitica": "00000000-0000-0000-0000-000000000000",
    "Proceso": "2010bdf1-37d1-42d2-ba91-7d9871ad515b",
    "ReferenciaEdi_": "",
    "CodigoClienteNuevoLc": "",
    "StatusEnvioXML": 0,
    "StatusCreadoXML": 0,
    "TipoNuevaFra": 0,
    "CodigoMotivoAbonoLc": "",
    "FechaOperacion": "2025-02-14T00:00:00",
    "ImporteACuentaA_": 0,
    "ImporteACuentaADivisa_": 0,
    "GenerarFactura": "0",
    "ComercialAsignadoLc": 0,
    "GuiaXMLEFactura": "",
    "StatusEnvioEFactura": 0,
    "StatusEFactura": 0,
    "PorMargenBeneficio": 100,
    "MargenBeneficio": 100,
    "OrigenDespacho": 0,
    "ImporteProvisiones": 0,
    "ImporteProvisionesNF": 0,
    "ImporteSuplidos": 0,
    "ImporteProvisionesDivisa": 0,
    "ImporteProvisionesNFDivisa": 0,
    "ImporteSuplidosDivisa": 0,
    "CuentaProvision": "438000001",
    "CodigoContableANT_": "",
    "RemesaHabitualANT_": "",
    "CuentaProvisionANT_": "",
    "FormatoEnvio": "PDF",
    "AnaLote": "",
    "AnaCapitulo": "",
    "ClaveOperacionFactura_": " ",
    "SerieAgrupacion_": "",
    "NumeroFacturaInicial_": 0,
    "NumeroFacturaFinal_": 0,
    "EsTicket": 0,
    "NumeroTerminalSR": 0,
    "NumeroTurnoSR": 0,
    "FechaCreacion": "2025-02-14T12:49:40.783",
    "HoraCreacion": 0,
    "ObservacionesWeb": "",
    "SuPedidoWeb": 0,
    "StatusNomina": 0,
    "CodigoIncidencia": 0,
    "IdFacturaCli": "702fe7df-b5ba-4872-847d-e932a75ccbdd",
    "CriterioIva": 0,
    "FechaMaxVencimiento": "2025-04-15T00:00:00",
    "FechaLiquidacion": null,
    "MovFacturaRecibida": "00000000-0000-0000-0000-000000000000",
    "ReferenciaMandato": "",
    "ImporteNetoLineasSI": 100,
    "ImporteNetoLineasSIDivisa_": 0,
    "PagoInmediato": 0,
    "IdPago": "09582809-80dd-447b-a7f3-674f94f3ef16",
    "PagoURL": "",
    "StatusTB": 0,
    "StatusListadoTB": 0,
    "StatusCertificacionTB": 1,
    "StatusAutofacturado": 0,
    "StatusZuzendu": 0,
    "TipoEnvioFactura": 0,
    "TextoIncidencia": "Error en el proceso de envío",
    "StatusEnvioVF": 0,
    "PdfBase64": "JVBERi0xLjINCjEgMCBvYmogDTw8DQovRmlsdGVyL1N0YW5kYXJkCi9SIDIgL1YgMQovTzwwZGZiOTY2MTJhZmY2MzMyNTcwMjQ3MjAyMTFmNzFlODQwZjUzNDY3OTYxM2Y0MjVhZmM2ZTBjNGNhOWVlOGQ1PgovVTxjOGM2NTdlZjA5YTIxN2Q4M2EyMjc5Yjg0MjA1ZDlmMDM5YzQzNzE4ZjhhZmZlZDVhMTIxMjU1NzA3ZTQwMzVkPgovUCA0DQo...",
    "NombreArchivoPdf": "2025ZZ1.pdf"
  }
}