Ir al contenido

Enviar facturas (de extremo a extremo)

Esta guía muestra un flujo de API limpio para enviar facturas: crear o reutilizar un contact, crear o importar una factura, enviarla y recuperar los archivos finales.

Requisitos previos

Clave API: X-B2B-API-Key
Versión de la API: X-B2B-API-Version
ACCOUNT_ID: la cuenta que emite la factura.

IDs importantes:

ACCOUNT_ID: cuenta propietaria (parámetro de ruta en /accounts/{ACCOUNT_ID}/...).
CONTACT_ID: contact destinatario (almacenado dentro de la cuenta).
INVOICE_ID: identificador de la factura (usado en los endpoints /invoices/{INVOICE_ID}...).

1) Obtener o crear el contact destinatario

1.1) Buscar contacts (opcional)

curl --request GET \
  --url 'https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/contacts?offset=0&limit=25&name=Example%20Customer' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'

1.2) Búsqueda en el directorio (opcional)

Si conoces el identificador y el país del destinatario, puedes obtener información pública del directorio y usarla para crear el contact.

curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/ESB63276174 \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'

1.3) Crear un contact (si no tienes uno)

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/contacts \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "contact": {
      "name": "Cliente de ejemplo",
      "country": "es",
      "is_client": true,
      "email": "billing@example.com",
      "tin_scheme": "9920",
      "tin_value": "ESB00000000",
      "transport_type_code": "b2brouter",
      "document_type_code": "json"
    }
  }'

Nota: CONTACT_ID se devuelve en la respuesta. No lo confundas con ACCOUNT_ID.

2) Crear (JSON) o importar (XML) la factura

2.1) Crear la factura usando JSON

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "send_after_import": false,
    "invoice": {
      "type": "IssuedInvoice",
      "contact_id": {CONTACT_ID},
      "number": "INV-0001",
      "date": "2026-01-21",
      "terms": "custom",
      "due_date": "2026-02-21",
      "currency": "EUR",
      "invoice_lines_attributes": [
        {
          "quantity": 1,
          "price": 10,
          "description": "Servicio de ejemplo",
          "taxes_attributes": [
            { "name": "VAT", "category": "S", "percent": 21 }
          ]
        }
      ]
    }
  }'

2.2) Importar la factura desde un archivo (cuando ya generas XML)

curl --request POST \
  --url 'https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices/import?send_after_import=false' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'content-type: application/octet-stream' \
  --data 'data:text/xml;name=invoice.xml;base64,PD94bWw+Li4u'

3) Enviar la factura

curl --request POST \
  --url https://api-staging.b2brouter.net/invoices/send_invoice/{INVOICE_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

4) Recuperar la factura y descargar los archivos finales

4.1) Obtener el payload de la factura

curl --request GET \
  --url 'https://api-staging.b2brouter.net/invoices/{INVOICE_ID}?include=lines' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'

4.2) Descargar los archivos legal/original de la factura

Consulta la guía Descargar facturas.

Guías relacionadas