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 et 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-te 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, considera aquestes opcions:

  • Opció 1: Payload JSON — utilitza un payload JSON per crear la teva 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 importes 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 envies un document al destinatari, es generarà automàticament un contacte amb les dades proporcionades a la factura. També pots 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é pots editar la informació del contacte per afegir codis DIR3 (consulta què són els 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, consulta 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: