Eine E-Mail mit angehängter Rechnungsdatei senden

Eine Ausgangsrechnung erstellen

Im folgenden Beispiel erfahren Sie, wie Sie eine Ausgangsrechnung mit der Versandmethode email erstellen.

Um eine Rechnung per E-Mail zu versenden, stellen Sie sicher, dass transport_type_code auf email gesetzt ist und eine gültige email (E-Mail-Adresse) angegeben wird. Zusätzlich müssen Sie den document_type_code angeben, der an die E-Mail angehängt werden soll. In diesem Beispiel ist er auf xml.ubl.invoice.xrechnung.v22 gesetzt.

Beispielanfrage:

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

Die Rechnung versenden

Vor der Übertragung prüfen wir sorgfältig, ob alle erforderlichen Daten vorhanden sind, und validieren das Dokument entsprechend den Anforderungen des Transportwegs und Dokumenttyps. Dadurch wird sichergestellt, dass die Rechnung alle notwendigen Kriterien für eine erfolgreiche Zustellung erfüllt.

Link zur API-Referenz

Beispielanfrage:

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'

Ihre Rechnung nachverfolgen

Bei Rechnungen, die per E-Mail versendet werden, ist die Nachverfolgbarkeit des Status eingeschränkt. Sie können hauptsächlich überprüfen, ob die Rechnung erfolgreich versendet wurde; in diesem Fall lautet ihr Status sent. Tritt dagegen während des Versandprozesses ein Fehler auf, sodass die Rechnung nicht versendet werden konnte, wird der Status auf error gesetzt. Diese Statusänderung zeigt an, dass bei der Rechnung ein Problem aufgetreten ist und sie nicht zugestellt werden konnte.