Ausstellung einer vereinfachten Rechnung (Kassenbon)

Eine vereinfachte Rechnung (Kassenbon) ist ein vereinfachtes Verkaufsdokument, das normalerweise als PDF bereitgestellt wird. Es gibt keinen universellen XML-Standard für Kassenbons, daher wird für Integrationen empfohlen, mit JSON zu arbeiten und das PDF von B2Brouter generieren zu lassen.

Verwenden Sie "type": "IssuedSimplifiedInvoice", um eine vereinfachte Rechnung zu erstellen.

Vereinfachte Rechnung erstellen

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": "IssuedSimplifiedInvoice",
      "number": "T-2026-0001",
      "date": "2026-01-21",
      "currency": "EUR",
      "file_reference": "POS-ORDER-12345",
      "contact": {
        "name": "Endverbraucher",
        "country": "es"
      },
      "invoice_lines_attributes": [
        {
          "quantity": 1,
          "price": 10,
          "description": "Kaffee",
          "taxes_attributes": [
            {
              "name": "VAT",
              "percent": 21,
              "category": "S"
            }
          ]
        }
      ]
    }
  }'

Beispielantwort (Auszug)

{
  "invoice": {
    "id": 123456,
    "type": "IssuedSimplifiedInvoice",
    "number": "T-2026-0001",
    "state": "new",
    "file_reference": "POS-ORDER-12345",
    "document_type_code": "pdf.invoice"
  }
}

Vereinfachte Rechnung senden (PDF generieren)

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

PDF herunterladen

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

Hinweise

• Verwenden Sie file_reference, um Ihre eigene interne Referenz (Bestell-ID, Ticket-ID, POS-Transaktions-ID usw.) zu speichern und die Abstimmung zu erleichtern.
• Wenn B2Brouter das PDF per E-Mail versenden soll, setzen Sie contact_email_override in der Rechnung, bevor Sie die Rechnung erstellen oder POST /invoices/send_invoice/{INVOICE_ID} aufrufen.
• Um vereinfachte Rechnungen aufzulisten: GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSimplifiedInvoice