Rechnungs-Webhook-API

Mit der Webhook-API erstellen Sie automatisch Rechnungen in Ihrer eigenen Umgebung. Sobald die Rechnungen erstellt sind, versenden Sie diese einfach per E-Mail, Peppol oder Post.

Diese Funktionalitaet ermoeglicht es Ihnen, eine eigene Integration einzurichten, mit der Sie Peppol-Rechnungen versenden koennen.

Achtung: Diese Funktion ist ausschliesslich fuer Trilly-Benutzer verfuegbar.

Request-Header

• Authorization: <token>
• X-Company-Id: <your_company_id>

Request-Body

Rechnung

• language: string[2] - 2-stelliger ISO-Code fuer die Dokumentsprache, verfuegbare Optionen: nl, en, fr, de
• invoice_date: string[10] - Rechnungsdatum im Format JJJJ-MM-TT
• expire_days: int - Faelligkeitsdatum der Rechnung, in “Tagen nach dem Rechnungsdatum”. Gueltige Werte: 0…365
• reference: string[200] (optional) - Zusaetzliche Referenz fuer die Rechnung, sichtbar in der Rechnungsuebersicht
• intro: text (optional) - Einleitungstext, der ueber den Rechnungszeilen auf dem PDF erscheint
• remarks: text (optional) - Fusstext unter den Rechnungszeilen auf dem PDF
• private_notes: text (optional) - Privater Text auf der Rechnung, sichtbar fuer den Benutzer, aber nie fuer den Endkunden
• vat_shifted: int (optional) - Ist Reverse-Charge auf die Rechnung anwendbar. Hinweis: Alle Zeilen muessen vat_percentage=0 verwenden, wenn dieses Feld einen anderen Wert als 0 hat. Verfuegbare Werte:
  • 0: Nein (= Standard)
  • 2: Mitvertragspartner
  • 4: Innergemeinschaftliche Dienstleistungen
  • 8: Innergemeinschaftliche Waren
  • 32: Differenzbesteuerung
  • 64: Import/Export
  • 128: Ausserhalb der EU
• client: client - Der Kunde, der mit der Rechnung verknuepft werden soll
• lines: array<invoice_line> - Liste der Rechnungszeilen, die mit der Rechnung verknuepft werden sollen

Kunde

• company_type: string - Verfuegbare Werte: “bedrijf”, “particulier”
• type: string - wenn company_type=bedrijf --> Rechtsform des Unternehmens. Verfuegbare Werte: onbekend, bvba, bv, eenmanszaak, nv, sbvba, ebvba, cvba, cvba-vso, cvoa, cvoa-vso, vof, gcv, comm.v, comm.va, esv, lv, vzw, vvzrl, tv, natuurlijk-persoon, limited-ltd, limited-llc, incorporated, srl, scri, sa, sas, sarl, sarl-s, gmbh, ag, srl, spa, doo, sl, sc, asbl, vme, feitelijke-vereniging
• title: string[255] - Der Firmenname bei company_type=bedrijf. Nicht erforderlich bei particulier
• email: string[150]
  • vat_country_code: string[2] - 2-stelliger ISO-Laendercode fuer die USt-IdNr., z.B. ‘BE’
• vat_id: string[30] - Ergaenzende Werte der USt-IdNr., z.B. “0663.642.920”
• first_name: string[255], erforderlich bei company_type=particulier
• last_name: string[255], erforderlich bei company_type=particulier
• address: string[200], Rechnungsadresse (Strasse + Hausnummer)
• address_zip: string[12] Postleitzahl der Rechnungsadresse
• address_city: string[150] Stadt/Ort der Rechnungsadresse
• address_country: string[2] 2-stelliger ISO-Code des Landes der Rechnungsadresse
• telephone: string[100] - optional

Rechnungszeile

• description: text - Text fuer die Rechnungszeile
• unit_price: double - Stueckpreis pro Artikel
• amount: double - Anzahl der Artikel
• vat_percentage: double - z.B. 21.00

Beispiel einer Request-Payload

[
  {
    "language": "nl",
    "invoice_date": "2025-01-10",
    "expire_days": 14,
    "reference": "Webshop #111",
    "intro": "",
    "remarks": "",
    "private_notes": "Webshop #111",
    "vat_shifted": 0,
    "client": {
      "company_type": "bedrijf",
      "type": "onbekend",
      "title": "TestCompany",
      "email": "info@numnum.be",
      "vat_country_code": null,
      "vat_id": null,
      "first_name": "Wim",
      "last_name": "De Bakker",
      "address": "Markt 1",
      "address_zip": "8000",
      "address_city": "Brugge",
      "address_country": "BE",
      "telephone": ""
    },
    "invoice_lines": [
      {
        "description": "Line 1",
        "unit_price": 10.00,
        "amount": 2.5,
        "vat_percentage": 21.00
      },
      {
        "description": "Line 2",
        "unit_price": 20.00,
        "amount": 5,
        "vat_percentage": 21.00
      },
      {
        "description": "Shipping",
        "unit_price": 20.00,
        "amount": 5,
        "vat_percentage": 21.00
      }
    ]
  }
]

Ergebnis

Die API gibt HTTP 201 zurueck, wenn die Ressource erfolgreich erstellt wurde. Behandeln Sie alle anderen Statuscodes (200, 403, 500, …) als Fehlschlag und stellen Sie die Rechnung fuer einen spaeteren Versuch in eine Warteschlange.

HTTP 201 - Rechnung erstellt

Gibt eine Liste der IDs der erstellten Rechnung(en) zurueck

[10232,10233]

HTTP 403 - Verweigert

Problem bei der Validierung des Authorization-Tokens im Header der Anfrage

{exception: "Information..."}

HTTP 406 - Fehlgeschlagen, Validierungsproblem

Wird zurueckgegeben, wenn ein Problem mit der Payload-Validierung vorliegt

{exception: "Information..."}

HTTP 500 - Unerwartetes Problem

HTTP 200 - Unerwartetes Problem

Regulaerer HTTP-Code. Dieser muss jedoch als “erneut versuchen” behandelt werden, da die API nur HTTP 201 bei tatsaechlicher Erstellung zurueckgibt

Postman

Download ueber diesen Link ein Postman-Beispiel des Webhooks.