Integración de Peppol fácil de usar para desarrolladores
El API de Peppox Te permite integrar la facturación electrónica de Peppol en minutos, no semanas. Conecta tu ERP, sistema de contabilidad o plataforma SaaS mediante una API REST sencilla y unificada: sin SOAP ni complejidad.
Obtener acceso a la API
Con Peppox, puedes administrar todos tus clientes desde Una interfaz segura y fácil de usar.
Crear un dedicado Cuenta de empresa Para cada cliente que administre y utilice la misma API simple para enviar y recibir sus facturas y notas de crédito de Peppol — Sin convertirse o registrarse con un punto de acceso.
Ejemplo: Si su ERP aloja varias empresas/clientes, cree una cuenta de Peppox Company para cada uno y conecte nuestra API para entregar y recibir documentos en su nombre.
Conéctese a su manera: punto de acceso administrado o el suyo propio
Hacemos la vida más fácil para desarrolladores e integradoresSi aún no tienes un Punto de Acceso Peppol, empieza a enviar Facturas compatibles con Peppol Hoy en día utilizando el Punto de acceso administrado Peppox — Sin incorporación compleja.
¿Ya tienes un punto de acceso? Simplemente Vincula tus credenciales y certificados en nuestro panel seguro y listo. En ambos casos, utilice el misma API de Peppox y puntos finales: sin cambios de código.
Traiga su propio punto de acceso
Mantenga su proveedor actual y conéctelo en minutos, sin reescritura ni dolores de cabeza por migración.
- Almacene de forma segura credenciales y certificados en el panel de control
- Sin cambios de código: mismos puntos finales y cargas útiles
- Registros unificados, seguimiento de entregas y visibilidad de errores
¿Aún no tienes punto de acceso?
Utilice el Punto de acceso administrado Peppox y envía tu primera factura en dos clics.
- Sin contratos de AP separados ni largos procesos de incorporación
- Enrutamiento seguro y de alto rendimiento a la red Peppol
- Validación BIS UBL/PEPPOL y soporte para archivos adjuntos PDF
administrado o vinculado En la configuración, los puntos finales permanecen idénticos.
Cambie los puntos de acceso en cualquier momento desde el panel de control: mantenga sus llamadas API iguales, solo actualice la configuración.
Elige cómo quieres enviar documentos a Peppol.
Peppox ofrece a los desarrolladores dos formas potentes de integrar la facturación electrónica de Peppol. Puede crear documentos enviando datos de factura estructurados a través de nuestros puntos finales de API existentes o utilizar la nueva función. API de PDF2Peppol para enviar documentos más rápido desde un simple PDF.
1. API de facturas estructuradas
Este es el flujo de trabajo actual del desarrollador. Su aplicación envía manualmente la información de la factura: encabezado, cliente, proveedor, líneas, impuestos, totales, archivos adjuntos y luego genera el XML de Peppol.
- Usted controla cada campo de la factura.
- Usted envía datos JSON estructurados
- Puedes añadir líneas de factura a través de puntos finales específicos.
- Adjunte el PDF si es necesario.
- Usted genera y envía XML compatible con Peppol.
2. API de PDF2Peppol
Este es el flujo de trabajo más rápido. Su aplicación envía una factura o nota de crédito en formato PDF a Peppox. Peppox prepara los datos del documento, su sistema los verifica, los confirma y los envía a Peppol.
- No se requiere generación manual de XML.
- No es necesario mapear cada campo de la factura manualmente.
- Funciona para facturas y notas de crédito.
- Paso de verificación antes de enviar
- Ideal si tu software ya genera archivos PDF.
De PDF a Peppol en unas pocas llamadas a la API
Con PDF2Peppol, no necesita rediseñar su sistema de facturación. Si su plataforma ERP, SaaS o herramienta de contabilidad ya genera facturas o notas de crédito en formato PDF, puede usar Peppox para transformar ese documento en un flujo de trabajo de envío compatible con Peppol.
API estructurada para un control total por parte del desarrollador.
Este flujo de trabajo de API es ideal cuando su aplicación ya cuenta con datos de facturación estructurados. Usted envía JSON a Peppox; nosotros nos encargamos automáticamente de la validación XML, la autenticación de certificados y el enrutamiento del punto de acceso.
🔑 Autenticación segura
Conéctese con su clave API: cada solicitud tiene un alcance y está encriptada solo para su cuenta.
📤 Punto final de factura
Enviar facturas utilizando POST /v1/facturas/enviar —Lo entregamos al punto de acceso correcto.
📡 Webhooks
Reciba notificaciones asincrónicas de confirmaciones de entrega, rechazos o errores.
🧰 SDK
Utilice SDK listos para usar para PHP, Python o Node.js: ahorre días de desarrollo.
Ejemplo de solicitud: Envío de una factura
Un ejemplo sencillo usando rizoReemplace sus credenciales y Peppox validará y enviará automáticamente la factura al punto de acceso correcto.
curl -X POST https://api.peppox.com/v1/invoices/send \ -H "Tipo de contenido: application/json" \ -H "Autorización: Portador YOUR_API_KEY" \ -d '{ "punto_de_acceso": "auto", "factura": { "número_de_factura": "INV-2025-1001", "fecha_de_emisión": "2025-10-12", "moneda": "EUR", "comprador": { "IVA": "BE0123456789" }, "vendedor": { "IVA": "BE0987654321" }, "líneas": [ { "descripción": "Desarrollo de software", "importe": 1250,00 }, { "descripción": "Servicios de soporte", "importe": 350,00 } ], "archivos adjuntos": [ { "tipo": "pdf", "fileBase64": "JVBERi0xLjQKJeLjz9M..." } ] } }'
✅ La misma llamada funciona con cualquier punto de acceso: Peppox se encarga del enrutamiento.
Descripción general de los puntos finales de la API: API estructurada y API PDF2Peppol
| Punto final | Descripción | Método |
|---|---|---|
/v1/factura/añadir |
Cree un nuevo encabezado de factura y almacene los detalles del proveedor, el cliente y el pago. | CORREO |
/v1/línea_de_factura/add/{id} |
Agregue una o varias líneas de productos o servicios a una factura existente. | CORREO |
/v1/factura_adjuntar_pdf/agregar |
Adjunte un documento PDF a una factura existente mediante carga, Base64 o URL remota. | CORREO |
/v1/xml/generar |
Genere un archivo XML UBL compatible con Peppol que combine la factura, sus líneas y archivos adjuntos. | CORREO |
/v1/webhooks/registrarse |
Registre un webhook para recibir actualizaciones de entrega | CORREO |
| API PDF2Peppol: envía documentos más rápido desde un PDF. | ||
/pdf2peppol/add/ |
Cargue una factura o nota de crédito en formato PDF. Peppox prepara los datos del documento para su procesamiento. | CORREO |
/pdf2peppol/check/ |
Verifique los datos del documento extraídos y preparados antes de enviarlos a Peppol. | CONSEGUIR |
/pdf2peppol/confirmar/ |
Confirme que los datos del documento son correctos y están listos para su envío a Peppol. | CORREO |
/pdf2peppol/enviar/ |
Envíe la factura o nota de crédito confirmada a la red Peppol. | CORREO |