Entwickler

Eine API für den gesamten Rechnungsverkehr.

Senden Sie Rechnungen im kanonischen Modell – Weesh erzeugt Format, prüft die Konformität und übernimmt die Zustellung. XRechnung oder Peppol BIS bauen Sie nie selbst.

API-Key erstellen Integrationen ansehen

REST & JSON
Scoped API-Keys
Signierte Webhooks

Einführung

Die Weesh API nimmt Rechnungen im kanonischen Datenmodell entgegen und kümmert sich um Formaterzeugung, Validierung und Zustellung.

Authentifizierung

Senden Sie Ihren Organisations-API-Key als Bearer-Token. Keys gelten für genau eine Organisation und können jederzeit im Bereich API widerrufen werden.

curl https://api.weesh.eu/v1/invoices \
  -H "Authorization: Bearer wsh_live_•••••••••••••" \
  -H "Content-Type: application/json"

Endpunkte

POST/v1/invoicesCreate an invoice from the canonical model

GET/v1/invoices/:idRetrieve a single invoice

POST/v1/invoices/:id/sendDeliver an invoice through a channel

GET/v1/invoices/:id/statusRead validation and delivery status

POST/v1/webhooksRegister a signed webhook endpoint

Rechnungs-Payload

Nutzen Sie format: "automatic", sofern kein vertraglicher Grund für ein festes Format besteht.

POST /v1/invoices

{
  "invoiceNumber": "RE-2026-00125",
  "issueDate": "2026-08-26",
  "dueDate": "2026-09-25",
  "currency": "EUR",
  "buyer": {
    "legalName": "Muster GmbH",
    "vatId": "DE310558921",
    "peppolId": "9930:DE310558921",
    "buyerReference": "MG-2026-0042",
    "address": {
      "street": "Lindenallee 5",
      "postalCode": "20095",
      "city": "Hamburg",
      "countryCode": "DE"
    }
  },
  "lineItems": [
    {
      "description": "Industrie Sensormodul IS-200",
      "quantity": 40,
      "unit": "pcs",
      "unitPrice": 48.00,
      "taxRate": 19
    }
  ],
  "delivery": { "channel": "peppol", "format": "automatic" }
}

Webhooks

Jede Zustellung ist signiert. Prüfen Sie den Signatur-Header, bevor Sie das Payload verarbeiten.

invoice.received
A document arrived through Peppol, email, upload or API.
invoice.validated
All validation layers passed.
invoice.validation_failed
At least one layer reported an error.
invoice.sent
The invoice was handed over to a delivery channel.
invoice.delivered
Delivery was confirmed by the receiving side.
invoice.rejected
The recipient rejected the document.
invoice.approved
An approver released the invoice in a workflow.

Keys und Endpunkte verwalten Sie im API-Bereich Ihres Workspace.

In wenigen Minuten integriert.

Konto erstellen, API-Key generieren und die erste Rechnung per API versenden.

Kostenlos starten Integrationen ansehen