Peppol-Netzwerk – Versand mit JSON-Payload

Sobald Ihre Peppol-Verbindung aktiviert ist, können Sie Dokumente nahtlos über dieses Netzwerk übertragen. Im Folgenden zeigen wir den Prozess zur Erstellung einer Rechnung mithilfe eines JSON-Payloads.

Eine Ausgangsrechnung erstellen

Im folgenden Beispiel sehen Sie, wie eine Ausgangsrechnung mit der Versandmethode peppol erstellt wird.

Um eine Rechnung über Peppol zu senden, stellen Sie sicher, dass beim Kontakt transport_type_code auf peppol gesetzt ist und pin_scheme sowie pin_value angegeben werden.

Beispielanfrage

curl --request GET \
  --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": {
        "type": "IssuedInvoice",
        "number": "1",
        "date": "2024-01-21",
        "due_date": "2024-03-01",
        "terms": "custom",
        "buyer_reference": "071110000000-001-50",
        "payment_method": 58,
        "iban": "ES9815013231061668117743",
        "contact": {
            "name": "Voorbeeld B.V.",
            "address": "Kerkstraat 12", "postalcode": "1017 GM", "city": "Amsterdam",
            "country": "nl",
            "transport_type_code": "peppol",
            "pin_scheme": "{PIN_SCHEME}",   "pin_value": "{PIN_VALUE}"
          },
        "invoice_lines_attributes": [
          {
            "unit": 1,
            "quantity": 1,
            "price": 1,
            "description": "Description line",
            "taxes_attributes": [
              {
                "category": "S",
                "name": "VAT",
                "percent": 19
              }
            ]
          }
        ]
    }
  }'

Typischerweise stellen diese Attribute die Mindestanforderungen dar, damit Peppol das Dokument versenden kann. Einige Empfänger können jedoch zusätzliche Felder wie buyer_reference verlangen, wie dies beispielsweise bei bestimmten Rathäusern in Deutschland der Fall ist.

Nach der Erstellung der Rechnung weist B2Brouter automatisch den am besten geeigneten Dokumenttyp für den Empfänger zu, sofern dieser Rechnungen empfangen kann.

Eine Self-Billing-Rechnung erstellen

Um eine Self-Billing-Rechnung zu erstellen (bei der der Käufer die Rechnung im Namen des Lieferanten ausstellt), setzen Sie "type": "IssuedSelfInvoice" im Rechnungs-Payload. Weitere Informationen finden Sie im Self-Billing-Leitfaden.

Eine Gutschrift erstellen

Um eine Gutschrift zu erstellen, verwenden Sie die Änderungsfelder ("is_credit_note": true, "amended_number", "amended_date" usw.), um auf die ursprüngliche Rechnung zu verweisen.

Für Self-Billing-Gutschriften kombinieren Sie "type": "IssuedSelfInvoice" mit den Änderungsfeldern.

Die Rechnung versenden

Im nächsten Schritt wird die Rechnung versendet. Vor dem Versand prüfen wir als Peppol Certified Service Provider sorgfältig, ob alle erforderlichen Daten vorhanden sind und ob das Dokument mithilfe offizieller Schematrons gültig ist.

Wenn das generierte Dokument gültig ist, wird es über unseren Access Point übertragen.

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'

Die Rechnung nachverfolgen

Abschließend können Sie die mit der Rechnung verbundenen Ereignisse abrufen:

Beispielanfrage:

curl --request GET \
  --url 'https://api-staging.b2brouter.net/accounts/{ACCOUNT_ID}/events?invoice_id={INVOICE_ID}' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'Content-Type: application/json'