Descarregar factures

Quan treballeu amb factures, és important diferenciar entre:

Fitxer de factura legal: el fitxer oficial final que s’ha lliurat (factures emeses) o rebut (factures rebudes).
Fitxer de factura original: el primer fitxer rebut per B2Brouter per a aquesta factura (per a factures emeses, normalment és un fitxer font importat; per a factures rebudes, és la factura rebuda de l’emissor).
Exportar una factura a un format específic: B2Brouter genera un document a partir de les dades de la factura (pot diferir del fitxer legal/original).
Adjunts: fitxers addicionals vinculats a la factura (PDFs, etc.). Els adjunts no són la factura en si mateixa.

Depenent del que necessiteu, haureu de:

Cridar un endpoint de descàrrega directa (per exemple, /invoices/{INVOICE_ID}/as/original), o
Utilitzar una ruta de descàrrega retornada al JSON de la factura (per exemple, download_legal_url o attachments[].link).

Prerequisits

Una clau d’API amb accés al projecte/compte de la factura.
L’invoice.id intern de B2Brouter (podeu obtenir-lo des dels endpoints de llista).

Pas 1: Obtenir el payload de la factura (opcional però recomanat)

Crideu Get invoice per recuperar el JSON de la factura i localitzar els camps rellevants:

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

Factures emeses: fitxer legal via `download_legal_url` (IssuedInvoice / IssuedSelfInvoice)

Després d’enviar una factura emesa, la resposta pot incloure download_legal_url, que apunta al fitxer legal lliurat al receptor (per exemple, l’XML exacte enviat a una xarxa/plataforma, o el PDF legal).

download_legal_url és una ruta relativa (no una URL completa), per exemple:

{
  "invoice": {
    "download_legal_url": "/attachments/download/{ATTACHMENT_ID}/{FILENAME}"
  }
}

Factures rebudes: fitxer original/legal via `/invoices/{id}/as/original`

Per a les factures rebudes, el fitxer original és també el fitxer legal. Descarregueu-lo directament amb:

GET /invoices/{INVOICE_ID}/as/original

Adjunts (emesos i rebuts): `attachments[].link`

El JSON de la factura pot incloure una matriu attachments. Cada entrada conté un link que podeu utilitzar per descarregar l’adjunt emmagatzemat.

attachments[].link és una ruta relativa (no una URL completa), per exemple:

{
  "invoice": {
    "attachments": [
      {
        "link": "/attachments/download/{ATTACHMENT_ID}/{FILENAME}",
        "content_type": "application/pdf"
      }
    ]
  }
}

Per a una explicació més detallada dels adjunts i PDFs legals, vegeu: Gestionar adjunts de factures.

Pas 2: Descarregar el fitxer

Els camps URL retornats per l’API (download_legal_url, attachments[].link) són rutes relatives. Afegiu-hi el prefix de la URL base del vostre entorn.

Descarregar usant `download_legal_url` (factures emeses, legal)

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

Descarregar usant `attachments[].link` (adjunts)

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

Descarregar usant `/invoices/{id}/as/original` (original)

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

Notes

Per a les factures rebudes, /invoices/{INVOICE_ID}/as/original retorna el fitxer rebut de l’emissor (original = legal).
Per a les factures emeses, /invoices/{INVOICE_ID}/as/original només funciona quan la factura té un fitxer original (per exemple, XML importat). Si la factura es va crear directament des d’un payload JSON, pot no haver-hi cap fitxer original per descarregar.

Descarregar factures

Prerequisits

Pas 1: Obtenir el payload de la factura (opcional però recomanat)

Factures emeses: fitxer legal via download_legal_url (IssuedInvoice / IssuedSelfInvoice)

Factures rebudes: fitxer original/legal via /invoices/{id}/as/original

Adjunts (emesos i rebuts): attachments[].link

Pas 2: Descarregar el fitxer

Descarregar usant download_legal_url (factures emeses, legal)

Descarregar usant attachments[].link (adjunts)

Descarregar usant /invoices/{id}/as/original (original)