Enviar un correu electrònic amb una factura adjunta

Crear una factura emesa

A l’exemple següent aprendràs com generar una factura emesa amb el mètode de lliurament configurat com a email.

Per enviar una factura per correu electrònic, assegura’t que transport_type_code estigui configurat a email i proporciona un email vàlid (adreça de correu electrònic). A més, assegura’t d’especificar el document_type_code que vols adjuntar al correu electrònic. En aquest exemple, s’estableix a xml.ubl.invoice.xrechnung.v22.

Exemple de petició:

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 'content-type: application/json' \
  --data '
    {
      "send_after_import": false,
        "invoice": {
          "number": "2",
          "date": "2024-03-27",
          "due_date": "2024-03-29",
          "terms": "custom",
          "ponumber": "1",
          "buyer_reference": "01002-000005228-65",
          "contact": {
              "name": "Muster GmbH",
              "address": "Musterstraße 45",
              "postalcode": "10115",
              "city": "Berlin",
              "province": "Berlin",
              "country": "de",
              "email": "john.doe@example.com",
              "transport_type_code": "email",
              "document_type_code": "xml.ubl.invoice.xrechnung.v22"
          },
          "invoice_lines_attributes": [
            {
              "unit": 1,
              "quantity": 1,
              "price": 1,
              "description": "Description line",
              "article_code": "Article Code",
              "taxes_attributes": [
                {
                  "category": "S",
                  "name": "MwSt",
                  "percent": 19
                }
              ]
            }
          ]
      }
  }'

Enviar la factura

Abans de la transmissió, verifiquem minuciosament la presència de totes les dades necessàries i validem el document segons els requisits del transport i del tipus de document. Això garanteix que la factura compleixi tots els criteris necessaris per a un lliurament correcte.

Enllaç a la Referència de l’API

Exemple de petició:

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'

Traçar la factura

En el cas de les factures enviades per correu electrònic, la traçabilitat de l’estat és limitada. Principalment pots verificar si la factura s’ha enviat correctament, en aquest cas el seu estat seria sent. Per contra, si s’ha produït un error durant el procés d’enviament, l’estat canviaria a error. Aquesta actualització d’estat indica que la factura ha trobat un problema i no s’ha pogut lliurar.