Salta al contingut
B2Brouter Docs B2Brouter Docs B2Brouter Docs
Log in
API reference

Enviar a FACe amb un fitxer importat

Utilitzar l’API de B2Brouter us permet enviar factures a FACe de manera senzilla. El procés implica:

  1. Crear una factura: importar el document de factura o el payload JSON a B2Brouter.
  2. Verificar la informació del destinatari: assegurar-vos que les dades del destinatari són correctes i completes.
  3. Enviar la factura: procedir a enviar-la.
  4. Fer el seguiment del document: monitorar la traçabilitat del document enviat.

Crear una factura

Section titled “Crear una factura”

Per crear una factura amb la nostra API, considereu aquestes opcions:

  • Opció 1: Payload JSON — utilitzeu un payload JSON per crear la vostra factura emesa.
  • Opció 2: Importar un format de fitxer compatible
Finestra del 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'

Quan importeu el document de factura, B2Brouter generarà un objecte factura si el document compleix els criteris de validació estàndard.

Verificar la informació del destinatari

Section titled “Verificar la informació del destinatari”

Si és la primera vegada que envieu un document al destinatari, es generarà automàticament un contacte amb les dades proporcionades a la factura. També podeu comprovar si el destinatari existeix al nostre directori públic:

Finestra del 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'

Exemple de resposta:

{
    "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"
    }
}

També podeu editar la informació del contacte per afegir codis DIR3:

Finestra del 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_ACCOUNTING}",
        "cin2_scheme": "8014",
        "cin2_value": "{DIR3_MANAGING}",
        "cin3_scheme": "8014",
        "cin3_value": "{DIR3_PROCESSING}"
    }
  }'

Per a més detall, consulteu les nostres llistes de codis:

Enviar la factura

Section titled “Enviar la factura”
Finestra del 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 document importat compleix els requisits de transport del destinatari, per exemple ser una factura Facturae, i es manté sense alteracions, enviarem directament el fitxer original. En cas contrari, generarem un document alineat amb el tipus de document requerit. Abans de transmetre’l a FACe, també comprovarem si l’XML està signat; si no ho està, el signarem.

Fer el seguiment de la factura

Section titled “Fer el seguiment de la factura”

B2Brouter ofereix dues opcions per monitorar l’estat del document: