Tengo datos de factura estructurados
Crea la cabecera, añade cada línea, adjunta opcionalmente el PDF visual y genera el documento UBL Peppol.
Ver este flujo →
Peppox Developer Platform
Envía tu primera factura por Peppol, paso a paso.
Elige la ruta adecuada para tu sistema, desde la primera llamada API hasta el seguimiento de la entrega.
PEPPOX / INTEGRATION FLOW
- 01Panel
- 02Clave API
- 03Factura
- 04Validar
- 05Peppol
READY TO BUILD
01 · Antes de la primera llamada
Cuatro elementos que se preparan una sola vez
Configura primero la cuenta y el perfil del proveedor. Después, tu aplicación reutiliza las mismas credenciales para cada documento.
- 01
Crea tu cuenta Peppox
Registra la empresa legal que enviará los documentos.
- 02
Completa el perfil del proveedor
Los datos de empresa, IVA, banco y enrutamiento Peppol proceden de tu cuenta.
- 03
Abre el entorno de integración
Prueba con seguridad desde las herramientas del panel antes de producción.
- 04
Copia tu clave API
Guárdala solo en el servidor, nunca en el navegador ni en una app móvil.
02 · Elige la ruta más corta
Empieza con los datos que ya tienes
Ya genero un PDF
Carga el PDF, deja que Peppox extraiga los datos, revísalos, confírmalos y envía por Peppol.
Ver este flujo →03 · PDF2Peppol
Un envío completo en cuatro llamadas API
La ruta documentada más directa cuando tu sistema ya produce facturas PDF.
- 01
Carga el PDF
Envía archivo, Base64 o URL y guarda queue_guid.
POST/pdf2peppol/add - 02
Revisa los datos extraídos
Consulta hasta terminar el proceso y verifica comprador, totales, IVA y líneas.
GET/pdf2peppol/check - 03
Confirma el documento
Confirma solo cuando todos los datos extraídos sean correctos.
POST/pdf2peppol/confirm - 04
Envía a Peppol
Envía el documento confirmado y guarda el GUID del documento.
POST/pdf2peppol/send - 05
Sigue la entrega
Usa la lista de documentos enviados o el panel para ver el estado final.
GET/doc-sent/header/list
Ejemplo mínimo
Upload → check → confirm → send
Sustituye los valores de ejemplo por tu identificador y los devueltos por la llamada anterior.
pdf2peppol.sh
curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
-F "supplier_id=YOUR_SUPPLIER_ID" \
-F "pdf=@invoice.pdf" \
-F "network=integration"
# Save queue_guid, then check it
curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"
curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID","confirmed":1}'
curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID"}'04 · API de factura estructurada
Crea una factura lista para Peppol con tus datos
Ideal si tu ERP ya almacena de forma estructurada todos los campos y líneas.
- 01
Crea la cabecera
Envía cliente, fechas, moneda, pago y entrega; guarda invoice_guid.
POST/invoice/add - 02
Añade las líneas
Repite la llamada para cada producto o servicio.
POST/invoice_line/add - 03
Adjunta el PDF (opcional)
Añade la factura legible por archivo, Base64 o URL.
POST/invoice_attach_pdf/add - 04
Genera el XML UBL
Peppox combina cabecera, líneas y adjunto; el éxito devuelve XML_BUILT.
POST/xml/generate - 05
Sigue y gestiona
Consulta documento y estado desde el panel o las APIs de enviados.
GET/doc-sent/header/list
API NOTE
Importante: la referencia publicada para facturas estructuradas documenta la generación XML, pero actualmente no un endpoint /send final independiente. Para una llamada final explícita usa PDF2Peppol o completa el envío mediante el flujo o panel Peppox configurado.
05 · Mapa de endpoints
Todos los endpoints explicados claramente
01Facturas
POST/invoice/addCrea la cabecera y devuelve invoice_guid.
POST/invoice_line/addAñade una línea a una factura.
POST/invoice_attach_pdf/addAdjunta o sustituye el PDF de factura.
02Generación UBL
POST/xml/generateGenera XML UBL compatible con Peppol.
03Notas de crédito
POST/creditnote/addCrea la cabecera de una nota de crédito.
POST/creditnote_line/addAñade una línea a una nota de crédito.
POST/creditnote_attach_pdf/addAdjunta o sustituye su PDF.
04Documentos enviados
GET/doc-sent/header/listLista cabeceras enviadas con filtros y paginación.
GET/doc-sent/lines/listObtiene las líneas de un documento enviado.
05Documentos recibidos
GET/doc-received/header/listLista cabeceras recibidas con filtros y paginación.
GET/doc-received/lines/listObtiene las líneas de un documento recibido.
06PDF2Peppol
POST/pdf2peppol/addCarga un PDF e inicia la extracción.
GET/pdf2peppol/checkComprueba estado y campos extraídos.
POST/pdf2peppol/confirmConfirma los datos revisados.
POST/pdf2peppol/sendEnvía el documento confirmado por Peppol.
06 · Pruebas sin código
Comprende cada solicitud en el panel antes de programarla
Los formularios guiados del panel Peppox llaman a las APIs por ti. Prueba documentos reales, descubre los parámetros obligatorios y comprende la respuesta JSON antes de conectar tu ERP.
- 01Elige un endpoint y completa sus campos
- 02Ejecuta la solicitud sin cliente de pruebas
- 03Inspecciona GUID, JSON y errores
- 04Valida el flujo en integración
- 05Reutiliza la solicitud funcional en tu backend
- 06Controla documentos enviados y recibidos
Guarda estos identificadores
El estado de integración es sencillo
invoice_guidUne cabecera, líneas, PDF y XML generado.
queue_guidUne las cuatro llamadas PDF2Peppol durante la extracción.
GUID del documentoUne el documento final con la entrega y conciliación.
Si falla una solicitud
400Revisa campos ausentes o inválidos.401Verifica la clave API y el entorno.404Verifica el GUID de la llamada anterior.429Reduce el ritmo y reintenta con espera progresiva.500Registra la solicitud, reintenta de forma segura y contacta con Peppox si persiste.