Ir al contenido
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

Enviar a FACe con archivo importado

La API de B2Brouter te permite enviar facturas a FACe de forma fluida. El proceso incluye:

  1. Crear una factura: Importa tu documento de factura o payload JSON en B2Brouter.
  2. Verificar la información del destinatario: Asegúrate de que los datos del destinatario son correctos y completos.
  3. Enviar la factura: Procede a enviar la factura.
  4. Rastrear el documento: Monitoriza la trazabilidad del documento enviado.

Crear una factura

Sección titulada «Crear una factura»

Para crear una factura usando nuestra API, considera estas opciones:

  • Opción 1: Payload JSON — Utiliza un payload JSON para crear tu factura emitida.

  • Opción 2: Importar un formato de archivo compatible

Ventana de terminal
curl --request POST \
  --url https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/invoices/import \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/octet-stream' \
  --data '@invoice.xml'

Al importar tu documento de factura, B2Brouter generará un objeto factura si el documento cumple los criterios de validación estándar.

Verificar la información del destinatario

Sección titulada «Verificar la información del destinatario»

Si es la primera vez que envías un documento al destinatario, se generará automáticamente un contact con los datos proporcionados en la factura. También puedes comprobar si el destinatario existe en nuestro directorio público:

Ventana de terminal
curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/9920/ESP2800500G \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'

Ejemplo de respuesta:

{
    "name": "Ayuntamiento de Alcalá de Henares",
    "tin_scheme": "9920",
    "tin_value": "ESP2800500G",
    "invoice": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2"
    },
    "routing_codes": {
        "cin1_scheme": "8014",
        "cin2_scheme": "8014",
        "cin3_scheme": "8014",
        "cin1_value": "L01280053",
        "cin2_value": "L01280053",
        "cin3_value": "L01280053"
    }
}

También puedes editar la información de tu contact para añadir códigos DIR3:

Ventana de terminal
curl --request PUT \
  --url https://api-staging.b2brouter.net/contacts/{CONTACT_ID} \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json' \
  --data '{
    "contact": {
        "transport_type_code": "es.face",
        "document_type_code": "xml.facturae.3.2.2",
        "cin1_scheme": "8014",
        "cin1_value": "{DIR3_CONTABLE}",
        "cin2_scheme": "8014",
        "cin2_value": "{DIR3_GESTOR}",
        "cin3_scheme": "8014",
        "cin3_value": "{DIR3_TRAMITADOR}"
    }
  }'

Para información más detallada, consulta nuestras listas de códigos:

Enviar tu factura

Sección titulada «Enviar tu factura»
Ventana de terminal
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}' \
  --header 'Content-Type: application/json'

Si el documento importado coincide con los requisitos de transporte del destinatario (como ser una facturaE) y no ha sido modificado, enviaremos directamente el archivo original. En caso contrario, generaremos un documento que se ajuste al tipo de documento requerido. Antes de la transmisión a FACe, también verificaremos si el XML está firmado; si no lo está, lo firmaremos.

Rastrear tu factura

Sección titulada «Rastrear tu factura»

B2Brouter ofrece dos opciones para monitorizar el estado de tu documento: