API de Peppox v1

Potente API de Peppol para empresas e integradores.

Peppox Proporciona una API REST simple y potente para conectar su software de facturación, ERP, plataforma SaaS o aplicación personalizada a la Red Peppol.

Envíe facturas de venta, cree notas de crédito, genere XML UBL, adjunte archivos PDF, recupere documentos enviados y reciba facturas de compra, todo a través de una API unificada.

Crea una cuenta de desarrollador Descubra la documentación de la API pública. 
POST /invoice/add Autorización: Bearer YOUR_API_KEY Content-Type: application/json { "issue_date": "2026-04-28", "customer": { "endpoint_id": "0208:0123456789", "name": "Empresa del cliente", "country": "BE" } }

Elige la cuenta adecuada para tu integración.

Peppox está disponible para ambos integradores y empresas individualesTanto si gestionas varios clientes como si solo gestionas tu propia empresa, la misma API te da acceso a Peppol.

Misma API. Uso diferente. Los integradores pueden gestionar varias empresas, mientras que las cuentas de las empresas pueden utilizar la API para sus propios documentos de Peppol.

Todo lo que necesitas para automatizar la facturación electrónica de Peppol.

Peppox simplifica cada paso de la facturación electrónica: creación de documentos, generación de XML, adjunto de PDF, envío de Peppol, seguimiento del estado y recuperación de facturas de compra.

📤 Enviar facturas de venta

Cree encabezados de factura, agregue líneas de factura, adjunte un PDF y genere XML compatible con Peppol a partir de sus datos.

🧾 Crear notas de crédito

Genere y envíe notas de crédito con el mismo flujo de trabajo sencillo que se utiliza para las facturas de venta.

📄 Generar XML UBL

Convierta los datos de su factura o nota de crédito a formato XML UBL compatible con Peppol directamente desde la API.

📎 Adjuntar archivos PDF

Adjunte facturas o notas de crédito en formato PDF mediante la función de carga, contenido Base64 o una URL de archivo HTTPS remota.

📬 Recuperar documentos enviados

Enumere los encabezados y líneas de las facturas enviadas para verificar la entrega, el estado de Peppol, los datos del cliente y el historial del documento.

📥 Reciba facturas de compra

Recupere los encabezados y las líneas de las facturas de compra recibidas a través de Peppol de sus proveedores.

🔍 Buscar, filtrar y ordenar

Utilice filtros por fecha, estado, tipo de documento, palabra clave, paginación y ordenación en los documentos enviados y recibidos.

🔐 Autenticación con clave API

Autentícate de forma segura con tu clave API de Peppox mediante la autorización de portador o los parámetros de la clave API.

Un flujo de trabajo sencillo para desarrolladores

Peppox está diseñado para integrarse fácilmente. Simplemente creas el documento, añades las líneas, adjuntas el PDF si es necesario, generas el XML y Peppox se encarga de la conexión con Peppol.

1

Crear el documento

Agregue un encabezado de factura de venta o nota de crédito con información del cliente, pago y entrega.

2

Agregar líneas de documento

Agregue productos, servicios, cantidades, precios, tipos de IVA y referencias de artículos.

3

Adjunte un archivo PDF.

Suba un archivo PDF, envíelo como Base64 o proporcione una URL remota segura.

4

Generar XML

Peppox genera el documento XML UBL compatible con Peppol.

5

Rastrear y recuperar

Realice el seguimiento de los documentos enviados y recupere las facturas de compra recibidas a través de Peppol.

Puntos finales de la API principales

La API de Peppox está organizada en puntos de acceso claros para la gestión de facturas, notas de crédito, generación de XML, documentos enviados y facturas de compra recibidas.

CORREO

/factura/añadir

Cree un encabezado de factura de venta en estado de borrador.

CORREO

/línea_de_factura/añadir

Agregar una línea a una factura de venta existente.

CORREO

/factura_adjuntar_pdf/añadir

Adjunte un archivo PDF a una factura de venta existente.

CORREO

/xml/generar

Generar un archivo XML UBL compatible con Peppol.

CORREO

/nota de crédito/agregar

Cree un encabezado para la nota de crédito.

CORREO

/línea_nota_crédito/agregar

Agregar una línea a una nota de crédito existente.

CONSEGUIR

/doc-sent/header/list

Lista de encabezados de facturas enviadas con filtros y estado de Peppol.

CONSEGUIR

/doc-sent/líneas/lista

Recuperar las líneas de una factura enviada.

CONSEGUIR

/doc-received/header/list

Lista de encabezados de facturas de compra recibidas.

CONSEGUIR

/doc-received/lines/list

Recuperar las líneas de una factura de compra recibida.

Documentación de la API pública

Explora la documentación de la API de Peppox.

La documentación de la API de Peppox está disponible públicamente para desarrolladores, integradores y empresas. Visite la página de la API para descubrir todos los puntos de acceso disponibles, ejemplos de solicitudes, parámetros y respuestas.

Tanto si desea enviar facturas de venta, crear notas de crédito, recuperar documentos enviados o recibir facturas de compra, la documentación le ayudará a comprender cómo conectar su software a Peppol con Peppox.

Consulte la documentación de la API.

JSON limpio, solicitudes sencillas

Peppox acepta cargas útiles JSON limpias y solicitudes HTTP estándar. Los desarrolladores pueden integrar rápidamente el envío y la recepción de Peppol en plataformas existentes sin necesidad de aprender múltiples API específicas de proveedores.

  • API REST con cargas útiles JSON
  • Autenticación sencilla con clave API
  • Identificadores GUID claros para el seguimiento
  • Compatible con PHP, Python, Node.js, Java, .NET y cualquier cliente HTTP.
Crear una factura de venta
curl -X POST "https://api.peppox.com/invoice/add/" \

  -H "Autorización: Portador TU_CLAVE_API" \

  -H "Content-Type: application/json" \

  -d '{

    "issue_date": "2026-04-28",

    "fecha_de_vencimiento": "2026-05-28",

    "moneda": "EUR",

    "cliente": {

      "endpoint_id": "0208:0123456789",

      "nombre": "Empresa Cliente",

      "país": "SER"

    }

  }'
Lista de facturas de compra recibidas
curl "https://api.peppox.com/doc-received/header/list/?supplier_id=YOUR_SUPPLIER_ID"

Enviar, recibir y verificar documentos de Peppol

Peppox no se limita al envío de facturas. Su aplicación también puede recuperar lo que se envió, verificar el estado de los documentos e importar las facturas de compra recibidas de los proveedores.

Para documentos salientes

Su aplicación puede enviar facturas de venta y notas de crédito, verificar el estado de la entrega y recuperar el historial de documentos cuando sea necesario.

  • Encabezados y líneas de facturas de venta
  • Encabezados y líneas de notas de crédito
  • Archivos adjuntos en formato PDF
  • Generación XML de UBL
  • Listado de documentos enviados y verificación de estado de Peppol

Para documentos entrantes

Su aplicación puede recuperar las facturas de compra recibidas a través de Peppol e importarlas a su sistema ERP, sistema contable o flujo de trabajo de validación interna.

  • Encabezados de facturas de compra recibidas
  • Líneas de factura de compra recibidas
  • Información sobre proveedores y clientes
  • Totales del IVA, importe a pagar y detalles del pago.
  • Buscar por fecha, estado, tipo de documento y palabra clave
Empiece a construir hoy mismo.

Conecta tu software a Peppol con una sola API.

Crea una cuenta de integrador para conectar varias empresas, o crea una cuenta de empresa para enviar y recibir tus propios documentos de Peppol directamente a través de Peppox.

Crear una cuenta de integrador Crear una cuenta de empresa