Envoyer un e-mail avec une facture en pièce jointe

Créer une facture émise

Dans l’exemple ci-dessous, vous verrez comment générer une facture émise avec la méthode de livraison définie sur email.

Pour envoyer une facture par e-mail, assurez-vous que transport_type_code est défini sur email et fournissez une adresse email valide. Assurez-vous également de spécifier le document_type_code que vous souhaitez joindre à l’e-mail. Dans cet exemple, il est défini sur xml.ubl.invoice.xrechnung.v22

Exemple de requête :

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
                }
              ]
            }
          ]
      }
  }'

Envoyer la facture

Avant la transmission, nous vérifions minutieusement la présence de toutes les données requises et validons le document selon les exigences du transport et du type de document. Cela garantit que la facture remplit tous les critères nécessaires à une livraison réussie.

Lien vers la référence API

Exemple de requête :

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'

Suivre votre facture

Lorsqu’il s’agit de factures envoyées par e-mail, la traçabilité du statut est limitée. Vous pouvez principalement vérifier si la facture a bien été envoyée, auquel cas son statut sera sent. À l’inverse, si une erreur survient durant le processus d’envoi et que la facture n’est pas envoyée, le statut devient error. Cette mise à jour indique que la facture a rencontré un problème et n’a pas pu être livrée.