API – Documentation

Autenticación

Tipo

Clave API — CLAVE API

Ubicación

consulta / parámetro: clave de API

Respaldo mediante el parámetro de consulta/cuerpo "apikey"

OBTENER https://api.peppox.com//sendsms/?apikey=TU_CLAVE_API

Gestión de facturas

/factura/añadir • Métodos: CORREO

Agregar un encabezado de factura de ventas

Crea un nuevo encabezado de factura en estado BORRADOR. El punto final registra toda la información del proveedor y del cliente, las fechas de emisión, las condiciones de pago y los detalles de entrega. Los datos del proveedor se cargan automáticamente desde el registro de su clave API (customer_api).

CORREO /factura/añadir • Tasa: 60 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Su clave API de Peppox (de su cuenta de proveedor registrada).
`red`	cadena	No		Identificador de red opcional (Peppol por defecto).
`inv_id`	cadena	No		Número de factura interna opcional.
`fecha de asunto`	cadena	Sí		Fecha de emisión de la factura (AAAA-MM-DD).
`fecha de vencimiento`	cadena	No		Fecha de vencimiento de la factura (AAAA-MM-DD).
`código_tipo_factura`	cadena	No	380	Código de tipo de factura de Peppol (por ejemplo, 380 = Factura, 381 = Nota de crédito).
`divisa`	cadena	No	euros	Código de moneda ISO.
`costo contable`	cadena	No		Referencia del código de contabilidad interna.
`referencia del comprador`	cadena	No		Referencia del comprador / Número de orden de compra.
`código de medios de pago`	cadena	No	1	Medios de pago (lista de códigos Peppol).
`pago.id_pago`	cadena	No		Identificador/referencia de pago.
`pago.iban`	cadena	No		IBAN del beneficiario.
`pago.nombre_de_cuenta`	cadena	No		Nombre del titular de la cuenta del beneficiario.
`pago.bic`	cadena	No		Código BIC/SWIFT del beneficiario.
`nota sobre términos de pago`	cadena	No		Nota sobre condiciones de pago.
`fecha de entrega`	cadena	No		Fecha de entrega.
`esquema de ubicación de entrega`	cadena	No	0088	Identificador del esquema de ubicación de entrega.
`entrega.location_id`	cadena	No		ID de ubicación de entrega.
`entrega.calle`	cadena	No		Dirección de entrega calle.
`entrega.ciudad`	cadena	No		Ciudad dirección de entrega.
`entrega postal`	cadena	No		Código postal de la dirección de entrega.
`país de entrega`	cadena	No		Código de país de la dirección de entrega.
`entrega.nombre_de_la_fiesta`	cadena	No		Nombre del grupo de entrega.
`cliente.endpoint_scheme`	cadena	No	0208	ID del plan Peppol del cliente.
`cliente.id del punto final`	cadena	No		ID de participante de Peppol del cliente.
`nombre del cliente`	cadena	No		Nombre del cliente.
`cliente.calle`	cadena	No		Calle del cliente.
`cliente.ciudad`	cadena	No		Ciudad del cliente.
`cliente.postal`	cadena	No		Código postal del cliente.
`cliente.país`	cadena	No		Código de país del cliente.
`cliente.vat_id`	cadena	No		Número de IVA del cliente.
`cliente.esquema_id_empresa`	cadena	No	0208	Esquema de identificación de la empresa del cliente.
`cliente.id_de_empresa`	cadena	No		ID de la empresa del cliente (número nacional).
`teléfono del cliente`	cadena	No		Teléfono de contacto del cliente.
`cliente.correo electrónico`	cadena	No		Correo electrónico de contacto del cliente.

Solicitar ejemplos

RIZO

PITÓN

curl -X POST "https://api.peppox.com/invoice/add/" \ -H "Autorización: Portador YOUR_API_KEY" \ -H "Tipo de contenido: application/json" \ -d "{ "fecha_de_emisión": "2025-10-17", "fecha_de_vencimiento": "2025-11-17", "cliente": { "id_de_punto_final": "9915:BE0123456789", "nombre": "ACME SPRL", "país": "BE" }, "pago": { "iban": "BE12345678901234", "bic": "GEBABEBB", "nombre_de_cuenta": "Proveedor de Peppox" } }"

Respuestas

Estado: 200 — Factura creada exitosamente (borrador).

JSON

{ "ok": verdadero, "invoice_guid": "inv-8c3b4a99-2025-10-17", "status": "BORRADOR" }

Estado: 400 — Campos inválidos o faltantes.

Estado: 401 — Clave API no válida o caducada.

Estado: 500 — Error interno del servidor o de la base de datos.

/línea_de_factura/añadir • Métodos: CORREO

Agregar una línea de factura a una factura existente

Añade una nueva línea a una factura existente (identificada por invoice_guid). Admite códigos de unidad, cantidad, precio, categoría de IVA y de identificación del producto.

CORREO /línea_de_factura/añadir • Tasa: 60 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Su clave API de Peppox (necesaria para la autenticación).
`guía de factura`	cadena	Sí		El GUID de factura único devuelto desde /invoice/add.
`id de línea`	cadena	No		Identificador de línea interno opcional (predeterminado: GUID generado).
`cantidad`	número	Sí		Cantidad del artículo o servicio.
`código de unidad`	cadena	No		Código de unidad según la Recomendación 20 de la CEPE (por ejemplo, H87 para “pieza”).
`precio_monto`	número	Sí		Precio unitario (sin impuestos).
`descripción del artículo`	cadena	No		Descripción del artículo o servicio.
`nombre_del_artículo`	cadena	No		Nombre o título del artículo.
`ID del artículo del vendedor`	cadena	No		ID de artículo interno del vendedor o SKU.
`esquema de id. de elemento estándar`	cadena	No	0088	Identificación de esquema estándar para identificación de artículos (por ejemplo, GTIN).
`id_del_elemento_estándar`	cadena	No		ID de artículo estandarizado (GTIN, EAN, etc.).
`país de origen`	cadena	No		País de origen (ISO 3166-1 alpha-2).
`categoría_de_impuesto`	cadena	No		Código de categoría de IVA (por ejemplo, S, Z, AE).
`porcentaje de impuestos`	número	No		Porcentaje de tasa de IVA (por ejemplo 21,00).

Solicitar ejemplos

RIZO

PITÓN

curl -X POST "https://api.peppox.com/invoice_line/add/" \ -H "Autorización: Portador YOUR_API_KEY" \ -H "Tipo de contenido: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "cantidad": 2, "código_unidad": "H87", "precio_importe": 49.99, "nombre_artículo": "Servicio de consultoría", "porcentaje_de_impuestos": 21 }"

Respuestas

Estado: 200 — Línea de factura agregada exitosamente.

JSON

{ "ok": verdadero, "line_guid": "line-2b4fa3c1-2025-10-17" }

Estado: 400 — Parámetros no válidos (factura_guid faltante o campos numéricos no válidos).

Estado: 401 — Clave API no válida o caducada.

Estado: 500 — Error interno de la base de datos o del servidor.

/factura_adjuntar_pdf/añadir • Métodos: CORREO

Adjuntar un PDF a una factura existente

Adjunta un documento PDF (mediante carga, Base64 o URL remota) a una factura existente identificada por invoice_guid. Solo se almacena un archivo adjunto por factura; cualquier archivo anterior se reemplaza.

CORREO /factura_adjuntar_pdf/añadir • Tasa: 30 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Su clave API de Peppox (autenticación).
`guía de factura`	cadena	Sí		El GUID de la factura a la que adjuntar el PDF.
`id_doc`	cadena	No		Identificador de documento opcional (por defecto, ID de factura o un UUID generado).
`Nombre del archivo`	cadena	No	archivo adjunto.pdf	Nombre del archivo adjunto (por ejemplo, factura.pdf).
`mímica`	cadena	No	solicitud/pdf	Tipo MIME del archivo.
`base de contenido64`	cadena	No		Contenido PDF como cadena Base64. Acepta el formato URI de datos.
`URL del archivo`	cadena	No		URL HTTPS remota de un PDF para descargar y adjuntar.
`archivo`	archivo	No		Campo de carga de archivos (multipart/form-data).

Solicitar ejemplos

RIZO

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorización: Portador YOUR_API_KEY" \ -F "invoice_guid=inv-8c3b4a99-2025-10-17" \ -F "file=@invoice.pdf"

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorización: Portador YOUR_API_KEY" \ -H "Tipo de contenido: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "filename": "invoice.pdf", "content_base64": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBlIC9QYWdl..." }"

curl -X POST "https://api.peppox.com/invoice_attach_pdf/add/" \ -H "Autorización: Portador YOUR_API_KEY" \ -H "Tipo de contenido: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17", "file_url": "https://example.com/invoice-2025.pdf" }"

Respuestas

Estado: 200 — PDF adjunto exitosamente a la factura.

JSON

{ "ok": verdadero, "invoice_guid": "inv-8c3b4a99-2025-10-17", "doc_id": "DOC-1452", "filename": "invoice-2025-10.pdf", "mime": "application/pdf", "size_bytes": 184527 }

Estado: 400 — Parámetros no válidos o contenido faltante (sin Base64, archivo o URL).

Estado: 401 — Clave API no válida o caducada.

Estado: 404 — Factura no encontrada.

Estado: 500 — Error interno del servidor o de la base de datos.

Generación de XML

/xml/generar • Métodos: CORREO

Generar un archivo XML UBL para una factura o nota de crédito.

Combina el encabezado, las líneas y el PDF adjunto (si lo hay) de la factura/nota de crédito en un documento XML UBL 3.0 compatible con Peppol. Devuelve la ruta local al archivo generado y actualiza el estado de la factura/nota de crédito a XML_BUILT.

CORREO /xml/generar • Tasa: 30 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Descripción
`clave de API`	cadena	Sí	Su clave API de Peppox para autenticación.
`guía de factura`	cadena	Sí	El identificador único de la factura a convertir a XML.
`guía`	cadena	No	Clave alternativa para invoice_guid.

Solicitar ejemplos

RIZO

PITÓN

curl -X POST "https://api.peppox.com/xml/generate/" \ -H "Autorización: Portador YOUR_API_KEY" \ -H "Tipo de contenido: application/json" \ -d "{ "invoice_guid": "inv-8c3b4a99-2025-10-17" }"

Respuestas

Estado: 200 — XML generado y almacenado exitosamente en el servidor.

JSON

{ "ok": verdadero, "estado": "XML_BUILT", "ruta_xml": "/var/www/vhosts/peppox.com/httpdocs/invoices_xml/inv-8c3b4a99-2025-10-17.xml" }

Estado: 400 — Faltan facturas_guid o líneas de factura.

Estado: 401 — Clave API no válida o caducada.

Estado: 404 — Factura no encontrada.

Estado: 500 — Error interno de generación o escritura de XML.

Notas de crédito

/nota de crédito/agregar • Métodos: CORREO

Agregar un encabezado de nota de crédito

Crea un nuevo encabezado de nota de crédito en estado BORRADOR. Los datos del proveedor se cargan automáticamente desde la cuenta de clave API, mientras que los campos de cliente, pago y entrega se obtienen de la solicitud.

CORREO /nota de crédito/agregar • Tasa: 60 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Tu clave API de Peppox.
`red`	cadena	No		Identificador de red opcional.
`ID de la nota de crédito`	cadena	No		Número/identificador de nota de crédito preferido.
`cn_id`	cadena	No		Alias alternativo para el ID de la nota de crédito.
`ID de nota de crédito`	cadena	No		Alias alternativo para el ID de la nota de crédito.
`inv_id`	cadena	No		Identificador heredado alternativo.
`fecha de asunto`	cadena	Sí		Fecha de emisión de la nota de crédito (AAAA-MM-DD).
`fecha de vencimiento`	cadena	No		Fecha de vencimiento (AAAA-MM-DD).
`código_tipo_factura`	cadena	No	381	Código de tipo de documento. Predeterminado 381 = Nota de crédito.
`divisa`	cadena	No	euros	Código de moneda ISO.
`costo contable`	cadena	No		Referencia contable interna.
`referencia del comprador`	cadena	No		Referencia del comprador / Referencia del pedido del cliente.
`código de medios de pago`	cadena	No	1	El pago significa código.
`pago.id_pago`	cadena	No		Referencia de pago.
`pago.iban`	cadena	No		IBAN del beneficiario.
`pago.nombre_de_cuenta`	cadena	No		Nombre de la cuenta del beneficiario.
`pago.bic`	cadena	No		Código BIC/SWIFT del beneficiario.
`nota sobre términos de pago`	cadena	No		Nota sobre condiciones de pago.
`fecha de entrega`	cadena	No		Fecha de entrega.
`esquema de ubicación de entrega`	cadena	No	0088	Esquema de ubicación de entrega.
`entrega.location_id`	cadena	No		Identificador del lugar de entrega.
`entrega.calle`	cadena	No		Calle de reparto.
`entrega.ciudad`	cadena	No		Ciudad de entrega.
`entrega postal`	cadena	No		Código postal de entrega.
`país de entrega`	cadena	No		Código del país de entrega.
`entrega.nombre_de_la_fiesta`	cadena	No		Nombre del grupo de entrega.
`proveedor.esquema_punto_final`	cadena	No	0208	Esquema del punto final del proveedor. Los valores del proveedor se cargan desde la cuenta de la API.
`cliente.endpoint_scheme`	cadena	No	0208	Esquema de punto final del cliente.
`cliente.id del punto final`	cadena	No		ID del punto final del cliente.
`nombre del cliente`	cadena	No		Nombre legal del cliente.
`cliente.calle`	cadena	No		Calle del cliente.
`cliente.ciudad`	cadena	No		Ciudad del cliente.
`cliente.postal`	cadena	No		Código postal del cliente.
`cliente.país`	cadena	No		Código de país del cliente.
`cliente.vat_id`	cadena	No		Número de IVA del cliente.
`cliente.esquema_id_empresa`	cadena	No	0208	Esquema de identificación de la empresa del cliente.
`cliente.id_de_empresa`	cadena	No		Identificación de la empresa del cliente.
`teléfono del cliente`	cadena	No		Teléfono del cliente.
`cliente.correo electrónico`	cadena	No		Correo electrónico del cliente.

Solicitar ejemplos

RIZO

PITÓN

curl -X POST "https://api.peppox.com/creditnote/add/" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{ "creditnote_id": "CN-2025-001", "issue_date": "2025-10-17", "currency": "EUR", "customer": { "endpoint_id": "9915:BE0123456789", "name": "ACME SPRL", "country": "BE" } }"

Respuestas

Estado: 200 — Nota de crédito creada con éxito.

JSON

{ "ok": true, "invoice_guid": "cn-8c3b4a99-2025-10-17", "document_type": "CREDIT_NOTE", "status": "BORRADOR" }

Estado: 400 — Campos inválidos o faltantes.

Estado: 401 — Clave API no válida o caducada.

Estado: 500 — Error interno del servidor o de la base de datos.

/línea_nota_crédito/agregar • Métodos: CORREO

Agregue una línea de nota de crédito

Agrega una línea a una nota de crédito existente. Acepta automáticamente alias para creditnote_guid y calcula tax_category a partir de tax_percent cuando sea posible.

CORREO /línea_nota_crédito/agregar • Tasa: 60 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Tu clave API de Peppox.
`guía_de_nota_de_crédito`	cadena	Sí		El GUID de la nota de crédito objetivo.
`guía de factura`	cadena	No		Alias para creditnote_guid.
`guía`	cadena	No		Alias para creditnote_guid.
`id de línea`	cadena	No		Identificador de línea interna opcional.
`ID de línea de pedido`	cadena	No		Alias para line_id.
`cantidad`	número	Sí		Cantidad de línea.
`cantidad`	número	No		Alias para cantidad.
`q`	número	No		Alias para cantidad.
`código de unidad`	cadena	No		Código de unidad.
`unidad`	cadena	No		Alias para unit_code.
`tú`	cadena	No		Alias para unit_code.
`precio_monto`	número	Sí		Importe del precio unitario.
`precio`	número	No		Alias para price_amount.
`precio_unitario`	número	No		Alias para price_amount.
`descripción del artículo`	cadena	No		Descripción de la línea.
`descripción`	cadena	No		Alias para item_description.
`descripción`	cadena	No		Alias para item_description.
`nombre_del_artículo`	cadena	No		Nombre/título del artículo.
`nombre`	cadena	No		Alias para item_name.
`título`	cadena	No		Alias para item_name.
`ID del artículo del vendedor`	cadena	No		ID del artículo del vendedor / SKU.
`ID del vendedor`	cadena	No		Alias para seller_item_id.
`sku`	cadena	No		Alias para seller_item_id.
`esquema de id. de elemento estándar`	cadena	No	0088	Esquema estándar de identificación de artículos.
`esquema estándar`	cadena	No		Alias para std_item_id_scheme.
`esquema`	cadena	No		Alias para std_item_id_scheme.
`id_del_elemento_estándar`	cadena	No		Identificador estándar del artículo (EAN, GTIN, etc.).
`gtin`	cadena	No		Alias para std_item_id.
`ean`	cadena	No		Alias para std_item_id.
`país de origen`	cadena	No		País natal.
`país`	cadena	No		Alias para el país de origen.
`categoría_de_impuesto`	cadena	No		Código de categoría de IVA. Se asigna automáticamente a S o Z según el porcentaje de impuestos.
`gato de impuestos`	cadena	No		Alias para tax_category.
`categoría_IVA`	cadena	No		Alias para tax_category.
`porcentaje de impuestos`	número	No		Porcentaje de IVA.
`tasa_de_IVA`	número	No		Alias para tax_percent.
`impuesto`	número	No		Alias para tax_percent.
`tina`	número	No		Alias para tax_percent.

Solicitar ejemplos

RIZO

PITÓN

curl -X POST "https://api.peppox.com/creditnote_line/add/" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "quantity": 2, "unit_code": "H87", "price_amount": 49.99, "item_name": "Servicio de consultoría devuelto", "tax_percent": 21 }"

Respuestas

Estado: 200 — Línea de nota de crédito añadida correctamente.

JSON

{ "ok": verdadero, "line_guid": "line-2b4fa3c1-2025-10-17" }

Estado: 400 — Faltan valores obligatorios como creditnote_guid, cantidad o importe del precio.

Estado: 401 — Clave API no válida o caducada.

Estado: 500 — Error interno de la base de datos.

/adjuntar nota de crédito_pdf/agregar • Métodos: CORREO

Adjunte un PDF a una nota de crédito.

Adjunta un documento PDF a una nota de crédito existente mediante carga multiparte, carga útil Base64 o URL remota. El archivo adjunto anterior se reemplaza.

CORREO /adjuntar nota de crédito_pdf/agregar • Tasa: 30 solicitudes/min • Se requiere autorización

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`clave de API`	cadena	Sí		Tu clave API de Peppox.
`guía_de_nota_de_crédito`	cadena	Sí		El GUID de la nota de crédito al que se adjuntará el PDF.
`guía de factura`	cadena	No		Alias para creditnote_guid.
`guía`	cadena	No		Alias para creditnote_guid.
`id_doc`	cadena	No		Identificador de documento opcional. Por defecto, se utiliza inv_id o un UUID generado.
`Nombre del archivo`	cadena	No	archivo adjunto.pdf	Nombre del archivo adjunto.
`mímica`	cadena	No	solicitud/pdf	Tipo MIME del archivo adjunto.
`base de contenido64`	cadena	No		Contenido PDF codificado en Base64.
`pdf_base64`	cadena	No		Alias para content_base64.
`URL del archivo`	cadena	No		URL HTTP/HTTPS del PDF que se debe descargar y adjuntar.
`URL del PDF`	cadena	No		Alias para file_url.
`archivo`	archivo	No		Archivo subido en varias partes.

Solicitar ejemplos

RIZO

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Authorization: Bearer YOUR_API_KEY" -F "creditnote_guid=cn-8c3b4a99-2025-10-17" -F "file=@creditnote.pdf"

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "filename": "creditnote.pdf", "content_base64": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9UeXBlIC9QYWdl..." }"

curl -X POST "https://api.peppox.com/creditnote_attach_pdf/add/" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{ "creditnote_guid": "cn-8c3b4a99-2025-10-17", "file_url": "https://example.com/creditnote-2025.pdf" }"

Respuestas

Estado: 200 — El archivo PDF se ha adjuntado correctamente a la nota de crédito.

JSON

{ "ok": true, "creditnote_guid": "cn-8c3b4a99-2025-10-17", "doc_id": "CN-2025-001", "filename": "creditnote.pdf", "mime": "application/pdf", "size_bytes": 184527 }

Estado: 400 — Solicitud no válida: falta creditnote_guid, Base64 no válido, URL no válida o no se ha proporcionado contenido.

Estado: 401 — Clave API no válida o caducada.

Estado: 404 — Nota de crédito no encontrada.

Estado: 500 — Error interno de la base de datos o del manejo de archivos.

Documentos enviados

/doc-sent/header/list • Métodos: CONSEGUIR

Lista de encabezados de facturas enviadas

Lista los encabezados de las facturas de venta enviadas a un proveedor. Admite búsqueda por palabras clave, filtros de fecha, filtros de estado de Peppol, filtros de estado local, inclusión de respuestas sin procesar, ordenación y paginación.

CONSEGUIR /doc-sent/header/list • Tasa: 300 requerimientos/min

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`	cadena	Sí		Identificador de proveedor obligatorio. Este valor se corresponde con invoices.apikey.
`q`	cadena	No		Búsqueda por palabras clave en los campos del encabezado de la factura.
`página`	entero	No	1	Número de página.
`por página`	entero	No	300	Filas por página. Máximo: 300.
`fecha`	cadena	No		Filtro de fecha exacta en formato AAAA-MM-DD.
`fecha_desde`	cadena	No		Fecha de inicio del filtro de período en formato AAAA-MM-DD.
`fecha_a`	cadena	No		Fecha de finalización del filtro de período en formato AAAA-MM-DD.
`campo_fecha`	cadena	No	enviado_a	Campo de fecha utilizado para fecha/fecha_desde/fecha_hasta. Permitido: issue_date, due_date, delivery_date, xml_built_at, sent_at, created_at, updated_at, status_from_peppol_date.
`estado_de_peppol`	cadena	No		Filtrar por estado de Peppol. Admite valores CSV.
`estado_peppol`	cadena	No		Alias para status_from_peppol.
`estado`	cadena	No		Alias para status_from_peppol.
`estado_local`	cadena	No		Filtra por estado de factura local desde invoices.status. Admite valores CSV.
`incluir_raw`	booleano	No	0	Establezca el valor en 1 para incluir sent_reply_api y all_response_api en la respuesta.
`búsqueda_raw`	booleano	No	0	Establézcalo en 1 para incluir sent_reply_api y all_response_api en la búsqueda por palabra clave.
`Ordenar por`	cadena	No	enviado_a	Columna de ordenación. Permitido: id, invoice_guid, inv_id, issue_date, due_date, xml_built_at, sent_at, status, created_at, updated_at, status_from_peppol, status_from_peppol_date, c_name, s_name, currency, network.
`directorio de ordenación`	cadena	No	DESC	Dirección de ordenación: ASC o DESC.

Solicitar ejemplos

RIZO

PITÓN

curl "https://api.peppox.com/doc-sent/header/list/?supplier_id=YOUR_SUPPLIER_ID"

curl "https://api.peppox.com/doc-sent/header/list/?supplier_id=YOUR_SUPPLIER_ID&date_from=2025-10-01&date_to=2025-10-31&date_field=sent_at&status_from_peppol=sent&page=1&per_page=100"

curl "https://api.peppox.com/doc-sent/header/list/?supplier_id=YOUR_SUPPLIER_ID&q=INV-2025&include_raw=1&search_raw=1"

import requests url = "https://api.peppox.com/doc-sent/header/list/" params = { "supplier_id": "YOUR_SUPPLIER_ID", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "sent_at", "status_from_peppox": "sent", "page": 1, "per_page": 100 } r = requests.get(url, params=params) print(r.json())

Respuestas

Estado: 200 — Éxito: devuelve los encabezados de las facturas con filtros, información de ordenación, paginación y filas de datos.

JSON

{ "ok": true, "endpoint": "doc-sent/header/list", "method": "GET", "filters": { "supplier_id": "YOUR_SUPPLIER_ID", "q": "", "date": "", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "sent_at", "status_from_peppol": "sent", "local_status": "", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "sent_at", "sort_dir": "DESC" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 125, "invoice_guid": "inv-8c3b4a99-2025-10-17", "inv_id": "INV-2025-001", "issue_date": "2025-10-17", "due_date": "2025-11-17", "invoice_type_code": "380", "currency": "EUR", "buyer_reference": "PO-12345", "s_name": "Empresa proveedora", "s_endpoint_id": "0208:0123456789", "c_name": "Empresa cliente", "c_endpoint_id": "0208:0987654321", "status": "SENT", "sent_at": "2025-10-17 14:30:00", "sent_http_code": 200, "network": "peppol", "status_from_peppol": "sent", "status_from_peppol_date": "2025-10-17 14:31:00", "status_from_peppol_error": null, "flowin_invoice_id_from_sent_reply_api": "flowin-doc-id-123", "flowin_document_endpoint_used": "/peppol/suppliers/.../invoices" } ] }

Estado: 400 — Falta el ID de proveedor requerido.

Estado: 500 — Error del servidor.

/doc-sent/líneas/lista • Métodos: CONSEGUIR

Lista de líneas de factura enviadas

Muestra las líneas de una factura enviada utilizando supplier_id e invoice_guid. El supplier_id debe coincidir con invoices.apikey por motivos de seguridad.

CONSEGUIR /doc-sent/líneas/lista • Tasa: 300 requerimientos/min

Parámetros

Nombre	En	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`	consulta	cadena	Sí		Identificador de proveedor obligatorio. Este valor debe coincidir con invoices.apikey.
`guía de factura`	consulta	cadena	Sí		El GUID de la factura se utiliza para listar las líneas de la factura.
`q`	consulta	cadena	No		Búsqueda opcional por palabras clave en todos los campos de la línea de factura.
`página`	consulta	entero	No	1	Número de página.
`por página`	consulta	entero	No	300	Filas por página. Máximo: 300.

Solicitar ejemplos

RIZO

PITÓN

curl "https://api.peppox.com/doc-sent/lines/list/?supplier_id=YOUR_SUPPLIER_ID&invoice_guid=inv-8c3b4a99-2025-10-17"

curl "https://api.peppox.com/doc-sent/lines/list/?supplier_id=YOUR_SUPPLIER_ID&invoice_guid=inv-8c3b4a99-2025-10-17&q=consulting&page=1&per_page=100"

import requests url = "https://api.peppox.com/doc-sent/lines/list/" params = { "supplier_id": "YOUR_SUPPLIER_ID", "invoice_guid": "inv-8c3b4a99-2025-10-17", "q": "consulting", "page": 1, "per_page": 100 } r = requests.get(url, params=params) print(r.json())

Respuestas

Estado: 200 — Éxito: devuelve los metadatos de la factura, los filtros, la paginación y las líneas de la factura.

JSON

{ "ok": true, "endpoint": "doc-send/lines/list", "invoice": { "invoice_guid": "inv-8c3b4a99-2025-10-17", "inv_id": "INV-2025-001", "status": "SENT", "sent_at": "2025-10-17 14:30:00" }, "filters": { "supplier_id": "YOUR_SUPPLIER_ID", "invoice_guid": "inv-8c3b4a99-2025-10-17", "q": "consulting" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 1, "invoice_guid": "inv-8c3b4a99-2025-10-17", "line_guid": "line-001", "line_id": "1", "quantity": "2.00", "unit_code": "H87", "price_amount": "49.99", "item_description": "Servicio de consultoría", "item_name": "Consulting", "seller_item_id": "SKU-001", "std_item_id_scheme": "0088", "std_item_id": null, "origin_country": "BE", "tax_category": "S", "tax_percent": "21.00", "created_at": "2025-10-17 14:00:00", "updated_at": null } ] }

Estado: 400 — Falta el ID de proveedor o el GUID de factura requeridos.

Estado: 404 — Factura no encontrada o no permitida para este ID de proveedor.

Estado: 500 — Error del servidor.

Documentos recibidos

/doc-received/header/list • Métodos: CONSEGUIR

Lista de encabezados de facturas de compra recibidas

Muestra los encabezados de las facturas de compra recibidas por un proveedor a través de Peppol. Admite búsqueda por palabras clave, filtros de fecha, estado de importación, código de tipo de documento, campos sin formato, ordenación y paginación.

CONSEGUIR /doc-received/header/list • Tasa: 300 requerimientos/min

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`	cadena	Sí		Identificador de proveedor obligatorio. Este valor se corresponde con peppox_inbound_purchase_invoices.supplier_id.
`q`	cadena	No		Búsqueda por palabras clave en los campos del encabezado de la factura recibida.
`página`	entero	No	1	Número de página.
`por página`	entero	No	300	Filas por página. Máximo: 300.
`fecha`	cadena	No		Filtro de fecha exacta en formato AAAA-MM-DD.
`fecha_desde`	cadena	No		Fecha de inicio del filtro de período en formato AAAA-MM-DD.
`fecha_a`	cadena	No		Fecha de finalización del filtro de período en formato AAAA-MM-DD.
`campo_fecha`	cadena	No	api_created_at	Campo de fecha utilizado para fecha/fecha_desde/fecha_hasta. Permitido: api_created_at, issue_date, due_date, tax_point_date, created_at, updated_at.
`estado_de_importación`	cadena	No		Filtrar por estado de importación. Admite valores CSV.
`estado`	cadena	No		Alias para import_status.
`código_tipo_documento`	cadena	No		Filtrar por código de tipo de documento. Admite valores CSV. Ejemplo: 380 factura, 381 nota de crédito.
`código_de_tipo`	cadena	No		Alias para el código de tipo de documento.
`incluir_raw`	booleano	No	0	Establezca el valor en 1 para incluir customization_id, profile_id, xml_without_pdf, api_attributes_json, parser_json y notification_sent_by_email_response.
`búsqueda_raw`	booleano	No	0	Establezca el valor en 1 para buscar dentro de campos sin formato/largos.
`Ordenar por`	cadena	No	api_created_at	Columna de ordenación. Permitido: id, customer_id, supplier_id, flowin_document_id, api_created_at, document_type_code, document_number, issue_date, due_date, tax_point_date, currency, supplier_name, customer_name, total_excl_vat, total_vat, total_incl_vat, payable_amount, import_status, created_at, updated_at.
`directorio de ordenación`	cadena	No	DESC	Dirección de ordenación: ASC o DESC.

Solicitar ejemplos

RIZO

PITÓN

curl "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148"

curl "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-4c56-ae75-327c58916148&date_from=2025-10-01&date_to=2025-10-31&date_field=api_created_at&document_type_code=380&page=1&per_page=100"

curl "https://api.peppox.com/doc-received/header/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&q=INV-2025&include_raw=1&search_raw=1"

import requests url = "https://api.peppox.com/doc-received/header/list/" params = { "supplier_id": "327c58aa-f3e1-4c56-ae75-327c58916148", "date_from": "2025-10-01", "date_to": "2025-10-31", "document_type_code": "380", "page": 1, "per_page": 100 } r = requests.get(url, params=params) print(r.json())

Respuestas

Estado: 200 — Éxito: devuelve los encabezados de las facturas de compra recibidas con filtros, ordenación, paginación y filas de datos.

JSON

{ "ok": true, "endpoint": "doc-received/header/list", "method": "GET", "filters": { "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "q": "", "date": "", "date_from": "2025-10-01", "date_to": "2025-10-31", "date_field": "api_created_at", "import_status": "imported", "document_type_code": "380", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "api_created_at", "sort_dir": "DESC" }, "pagination": { "page": 1, "per_page": 300, "total": 1, "total_pages": 1, "has_prev": false, "has_next": false }, "count": 1, "data": [ { "id": 25, "customer_id": 7, "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "flowin-doc-id-123", "environment": "production", "api_created_at": "2025-10-17 14:30:00", "document_type_label": "Invoice", "document_type_code": "380", "document_number": "INV-2025-001", "issue_date": "2025-10-17", "due_date": "2025-11-17", "tax_point_date": "2025-10-17", "moneda": "EUR", "referencia_comprador": "PO-12345", "referencia_pedido": "ORD-987", "nombre_proveedor": "Empresa proveedora", "id_empresa_proveedor": "0123456789", "id_punto_final_proveedor": "0208:0123456789", "id_IVA_proveedor": "BE0123456789", "calle_proveedor": "Calle_proveedor 1", "ciudad_proveedor": "Bruselas", "código_postal_proveedor": "1000", "país_proveedor": "BE", "nombre_cliente": "Empresa_cliente", "id_empresa_cliente": "0987654321", "id_punto_final_cliente": "0208:0987654321", "customer_vat_id": "BE0987654321", "customer_street": "Calle del cliente 2", "customer_city": "Namur", "customer_zip": "5000", "customer_country": "BE", "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00", "payable_amount": "121.00", "line_extension_amount": "100.00", "tax_exclusive_amount": "100.00", "tax_inclusive_amount": "121.00", "allowance_total_amount": "0.00", "charge_total_amount": "0.00", "prepaid_amount": "0.00", "payment_means_code": "30", "payment_id": "INV-2025-001", "iban": "BE12345678901234", "bic": "GEBABEBB", "has_embedded_pdf": 1, "created_at": "2025-10-17 14:31:00" } ] }

Estado: 400 — Falta el ID de proveedor requerido.

Estado: 500 — Error del servidor.

/doc-received/lines/list • Métodos: CONSEGUIR

Lista de líneas de facturas de compra recibidas

Muestra las líneas de una factura de compra recibida utilizando supplier_id y document_id. El document_id se corresponde con peppox_inbound_purchase_invoices.flowin_document_id.

CONSEGUIR /doc-received/lines/list • Tasa: 300 requerimientos/min

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`	cadena	Sí		Identificador de proveedor requerido.
`ID del documento`	cadena	Sí		Se requiere el ID del documento recibido. Se corresponde con flowin_document_id.
`q`	cadena	No		Búsqueda por palabras clave en los campos de las líneas de la factura recibida.
`página`	entero	No	1	Número de página.
`por página`	entero	No	300	Filas por página. Máximo: 300.
`incluir_raw`	booleano	No	0	Establezca el valor en 1 para incluir raw_line_xml y parser_json.
`búsqueda_raw`	booleano	No	0	Establezca el valor en 1 para buscar dentro de raw_line_xml y parser_json.
`Ordenar por`	cadena	No	número_de_línea	Columna de ordenación. Permitido: id, invoice_header_id, customer_id, supplier_id, flowin_document_id, line_no, line_id, item_name, quantity, unit_code, unit_price, vat_rate, line_total_excl_vat, line_total_vat, line_total_incl_vat, currency, created_at.
`directorio de ordenación`	cadena	No	ASC	Dirección de ordenación: ASC o DESC.

Solicitar ejemplos

RIZO

PITÓN

curl "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9"

curl "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-f3e1-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9&q=consulting&page=1&per_page=100"

curl "https://api.peppox.com/doc-received/lines/list/?supplier_id=327c58aa-4c56-ae75-327c58916148&document_id=e1de8615-ce41-425a-ba88-0b834bf3ccf9&include_raw=1&search_raw=1"

import requests url = "https://api.peppox.com/doc-received/lines/list/" params = { "supplier_id": "327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "q": "consulting", "page": 1, "per_page": 100 } r = requests.get(url, params=params) print(r.json())

Respuestas

Estado: 200 — Éxito: devuelve los metadatos de la factura recibida, filtros, ordenación, paginación y filas de línea.

JSON

{ "ok": true, "endpoint": "doc-received/lines/list", "method": "GET", "invoice": { "id": 25, "customer_id": 7, "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "document_number": "INV-2025-001", "document_type_code": "380", "document_type_label": "Invoice", "issue_date": "2025-10-17", "due_date": "2025-11-17", "currency": "EUR", "supplier_name": "Supplier Company", "customer_name": "Customer Company", "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00", "payable_amount": "121.00", "import_status": "imported", "api_created_at": "2025-10-17 14:30:00" }, "filters": { "supplier_id": 327c58aa-f3e1-4c56-ae75-327c58916148", "document_id": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "q": "", "include_raw": "0", "search_raw": "0" }, "sort": { "sort_by": "line_no", "sort_dir": "ASC" }, "paginación": { "página": 1, "por_página": 300, "total": 1, "páginas_totales": 1, "tiene_anterior": falso, "tiene_siguiente": falso }, "conteo": 1, "datos": [ { "id_proveedor": 327c58aa-f3e1-4c56-ae75-327c58916148", "id_documento": "e1de8615-ce41-425a-ba88-0b834bf3ccf9", "id_línea": "1", "descripción": "Servicio de consultoría", "nombre_artículo": "Consultoría", "id_vendedor_artículo": "SKU-001", "id_comprador_artículo": nulo, "cantidad": "2.00", "código_unidad": "H87", "precio_unidad": "50.00", "cantidad_base": "1.00", "id_categoría_IVA": "S", "tipo_IVA": "21.00", "esquema_IVA": "IVA", "total_línea_sin_IVA": "100.00", "total_línea_IVA": "21.00", "total_línea_con_IVA": "121.00", "moneda": "EUR", "created_at": "2025-10-17 14:31:00" } ] }

Estado: 400 — Falta el ID de proveedor o el ID de documento requeridos.

Estado: 404 — No se encontró la factura recibida o no está permitida para este ID de proveedor/ID de documento.

Estado: 500 — Error del servidor.

PDF a Peppol

/pdf2peppol/add • Métodos: CORREO

Sube un PDF para la conversión de Peppol

Recibe un documento PDF mediante carga de archivo, base64 o URL. Peppox lo almacena en la cola de conversión de PDF a Peppol e inicia el proceso de conversión. El documento no se envía inmediatamente a Peppol: primero debe procesarse, revisarse, confirmarse y, finalmente, enviarse.

CORREO /pdf2peppol/add • Tasa: 50 PDF/mes por defecto

Parámetros

Nombre	En	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`		cadena	Sí		Identificador del proveedor. Alias aceptados: apikey o api_key.
`URL del PDF`		cadena	No		URL pública del PDF a importar. Alias: file_url, document_url, url.
`pdf_base64`	cuerpo	cadena	No		Contenido PDF codificado en base64. Alias: content_base64, file_base64, document_base64, base64.
`PDF`		archivo	No		Carga de archivos PDF. Nombres de campo aceptados: pdf, file, invoice_pdf, document, pdf_file.
`Nombre del archivo`		cadena	No	documento.pdf	Nombre de archivo original. Se utiliza al enviar bases64 o URL.
`red`		cadena	No	producción	Red Peppol. Permitido: producción o integración. Alias: net_work, environment.
`código_tipo_documento`		cadena	No	380	Tipo de documento. 380 = factura de venta, 381 = nota de crédito. Alias: invoice_type_code, document_type, type.

Solicitar ejemplos

RIZO

curl "https://api.peppox.com/pdf2peppol/add/?supplier_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e&pdf_url=https://peppox.com/invoice2.pdf"

curl -X POST "https://api.peppox.com/pdf2peppol/add/" -F "supplier_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e" -F "pdf=@invoice.pdf"

curl -X POST "https://api.peppox.com/pdf2peppol/add/" -H "Content-Type: application/json" -d "{"supplier_id":"de5c7119-0f03-4058-9d3b-9f9520c2a46e","pdf_base64":"JVBERi0xLjQ...","filename":"invoice.pdf"}"

Respuestas

Estado: 200 — El PDF fue aceptado y añadido a la cola de conversión.

JSON

{ "success": true, "message": "Documento PDF recibido. Ahora está esperando procesamiento.", "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "status": "pending", "from_api": 1, "supplier_id": "de5c569-0f03-4248-9dae-9f9520c2a477e", "queue_customer_id": 12, "document_type_code": "380", "document_type_label": "Factura de venta", "network": "production", "pdf_source": "url", "filename": "invoice2.pdf", "monthly_limit": { "limit": 50, "used": 4, "remaining_before_upload": 46 } }

Estado: 400 — Solicitud no válida, proveedor no válido, PDF no válido, archivo demasiado grande o límite mensual alcanzado.

/pdf2peppol/check • Métodos: CONSEGUIR

Comprueba la conversión de PDF a Peppol.

Devuelve el estado de conversión, los datos de encabezado extraídos, las líneas extraídas, el enlace PDF y las comprobaciones de preparación de Peppol para un documento PDF en cola.

CONSEGUIR /pdf2peppol/check • Tasa: 300 requerimientos/min

Parámetros

Nombre	En	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`		cadena	Sí		Identificador del proveedor. Alias aceptados: apikey o api_key.
`guide_cola`		cadena	Sí		GUID de cola devuelto por /pdf2peppol/add. Alias: guid.
`descargar_pdf`	consulta	booleano	No	0	Si se establece en 1, devuelve el PDF original en lugar de JSON.

Solicitar ejemplos

RIZO

curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=de5c7119-0f03-4058-9d3b-9f9520c2a46e&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Respuestas

Estado: 200 — Conversión cargada correctamente.

JSON

{ "éxito": verdadero, "mensaje": "Conversión de PDF a Peppol cargada correctamente.", "cola": { "guid_cola": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "id_proveedor": "de5c569-0f03-4248-9dae-9f9520c2a477e", "código_tipo_documento": "380", "etiqueta_tipo_documento": "Factura de venta", "red": "producción", "nombre_archivo": "factura.pdf", "url_pdf": "https://api.peppox.com/pdf2peppol/check/?download_pdf=1&supplier_id=de5c569-0f03-4248-9dae-9f9520c2a477e&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa", "procesamiento": { "estado": "analizado", "está_esperando": falso, "está_terminado": verdadero, "tiene_error": falso }, "verificación": { "confirmado": falso, "confirmado_en": "" }, "envío_peppol": { "estado": "bloqueado", "solicitado_en": "", "completado_en": "", "guid_factura_peppox": "", "error": "" } }, "disponibilidad_peppol": { "ready_for_peppol": true, "can_be_verified": true, "verification_confirmed": false, "can_be_sent_now": false, "send_block_reason": "El documento debe verificarse antes de poder enviarse." }, "converted_data": { "header": { "document": { "document_number": "INV-2025-001", "document_date": "2025-10-17", "document_type_code": "380", "document_type_label": "Factura de venta", "currency": "EUR", "peppol_ready": true }, "buyer": { "name": "Empresa cliente", "company_number": "0123456789", "country": "BE" }, "totals": { "total_excl_vat": "100.00", "total_vat": "21.00", "total_incl_vat": "121.00" } }, "lines_count": 1, "lines": [ { "line_no": 1, "description": "Servicio de consultoría", "quantity": "1", "unit_price": "100.00", "vat_rate": "21" } ] } }

Estado: 400 — ID de proveedor no válido, queue_guid o conversión no encontrada.

/pdf2peppol/confirm • Métodos: CORREO

Confirmar la información del PDF convertido

Confirma que la información de la factura o nota de crédito extraída es correcta. Esta confirmación es necesaria antes de que el documento pueda enviarse a Peppol.

CORREO /pdf2peppol/confirm • Tasa: 300 requerimientos/min

Parámetros

Nombre	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`	cadena	Sí		Identificador del proveedor. Alias aceptados: apikey o api_key.
`guide_cola`	cadena	Sí		GUID de cola devuelto por /pdf2peppol/add. Alias: guid.
`confirmado`	booleano	No	1	Indicador de confirmación opcional. El punto final confirma que el documento está disponible si todos los campos obligatorios de Peppol están disponibles.

Solicitar ejemplos

RIZO

curl "https://api.peppox.com/pdf2peppol/confirm/?supplier_id=ed751d5a-661e-4f6e-9d74-2d7447be4a9d&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Respuestas

Estado: 200 — Verificación de documentos confirmada y listo para ser enviado.

JSON

{ "success": true, "message": "Verificación del documento confirmada. El documento está listo para ser enviado a Peppol.", "supplier_id": "ed751d5a-661e-4f6e-9d74-2d7447be4a9d", "queue_guid": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "document_type_code": "380", "document_type_label": "Factura de venta", "verification_confirmed": true, "verification_confirmed_at": "2025-10-17 15:10:00", "send_status": "ready", "ready_for_peppol": true, "checks": { "document_number": true, "document_date": true, "buyer_name": true, "buyer_identifier": true, "buyer_street": true, "buyer_city": true, "buyer_postal": true, "buyer_country": true, "document_lines": true }, "missing_fields": [] }

Estado: 400 — El documento no se puede confirmar porque faltan datos o la conversión no está lista.

/pdf2peppol/enviar • Métodos: CORREO

Enviar el documento PDF confirmado a Peppol.

Envía un PDF confirmado a Peppol. Peppox crea la factura o nota de crédito, añade líneas, adjunta el PDF original, genera el XML de Peppol e inicia el proceso de envío. Importante: tras llamar a este endpoint, espere unos minutos, ya que varios procesos internos completan y validan el documento antes de la entrega final a Peppol.

CORREO /pdf2peppol/enviar • Tasa: 300 requerimientos/min

Parámetros

Nombre	En	Tipo	Requerido	Por defecto	Descripción
`ID del proveedor`		cadena	Sí		Identificador del proveedor. Alias aceptados: apikey o api_key.
`guide_cola`		cadena	Sí		GUID de cola devuelto por /pdf2peppol/add. Alias: guid.

Solicitar ejemplos

RIZO

curl "https://api.peppox.com/pdf2peppol/send/?supplier_id=ed751d5a-661e-4f6e-9d74-2d7447be4a9d&queue_guid=pdf-6e9466501393cfbb32b1ec80498a1dfa"

Respuestas

Estado: 200 — Documento enviado o ya enviado. El estado final de entrega de Peppol puede tardar unos minutos, ya que el procesamiento interno continúa después de la solicitud.

JSON

{ "éxito": verdadero, "mensaje": "Factura de venta enviada a Peppol correctamente.", "id_proveedor": "ed751d5a-661e-4f6e-9d74-2d7447be4a9d", "guid_cola": "pdf-6e9466501393cfbb32b1ec80498a1dfa", "guid_documento_peppox": "0e8b3c9d-1111-4444-9999-aabbccddeeff", "código_tipo_documento": "380", "etiqueta_tipo_documento": "Factura de venta", "red": "producción", "estado_envío": "enviado", "referencia_pago": "INV-2025-001", "comprador": { "nombre": "Empresa cliente", "id_IVA": "BE0123456789", "company_id": "0123456789", "street": "Customer Street 1", "city": "Brussels", "postal": "1000", "country": "BE", "phone": "+32123456789", "email": "customer@example.com" }, "steps": { "document_create": "ok", "document_lines": "ok", "pdf_attachment": "ok", "xml_generate": "ok" }, "peppox_responses": { "invoice_add": { "ok": true, "invoice_guid": "0e8b3c9d-1111-4444-9999-aabbccddeeff", "status": "BORRADOR" }, "xml_generate": { "ok": true, "status": "XML_BUILT", "xml_path": "created" } } }

Estado: 400 — No se puede enviar el documento. Es posible que no se haya procesado correctamente, que no se haya confirmado, que ya se esté enviando, que falten datos o que la API de Peppox haya devuelto un error.

Estado: 405 — Método no permitido.

Webhooks

No hay webhooks documentados.

SDK

No hay SDK listados.

Catálogo de errores

No hay errores definidos.

Registro de cambios

Aún no hay lanzamientos