bimetricsEntwickler
Wiederkehrende Rechnungen

Serienvorlagen lesen

Als Markdown ansehen

Benötigte Berechtigung:sales:read(Ausgangsrechnungen und Entwürfe lesen)

GET
/api/recurringinvoice/

Liefert aktive, pausierte und beendete Vorlagen mit nächstem Termin und gegebenenfalls dem letzten Fehlercode.

Benötigt einen Schlüssel mit der Berechtigung sales:read oder read.

Authentifizierung

AuthentifizierungBearer <token>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

In: header

Query-Parameter

limit?integer

Seitengröße; Standard 50, höchstens 100.

offset?integer

Anzahl zu überspringender Treffer; Standard 0.

search?string

Suche im Namen der Serienvorlage und im Kundennamen.

status?string

Ein oder mehrere kommagetrennte Statuswerte active, paused und ended; all (Standard) enthält alle Vorlagen.

sort?string

Sortierfeld createdAt (Standard), name, customerName, nextDate oder status.

direction?string

Sortierrichtung asc oder desc; Standard desc. Sortierung gilt vor der Seitenauswahl.

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl --fail-with-body "https://app.bimetrics.de/api/recurringinvoice/" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
{  "items": [    {      "authorizationId": null,      "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",      "createdAt": "2026-10-08T09:00:00Z",      "draftBody": {        "buyer": {          "address": {            "city": "Hamburg",            "countryId": "DE",            "line1": "Am Hafen 12",            "postcode": "20457"          },          "contactId": "b17e8812-eae4-49b6-b5dc-30510635cb07",          "customerNumber": 1004,          "email": "",          "name": "Brauhaus Elbwiese GmbH",          "vatId": ""        },        "dueDate": {          "day": 15,          "month": 9,          "year": 2026        },        "issueDate": {          "day": 1,          "month": 9,          "year": 2026        },        "items": [          {            "description": "Gestaltung einer Geschäftsausstattung",            "discount": "0",            "name": "Gestaltung",            "position": "1",            "quantity": "1",            "taxRate": "19",            "unit": "C62",            "unitPrice": "100"          }        ],        "notes": "",        "performancePeriodFrom": {          "day": 1,          "month": 9,          "year": 2026        },        "priceType": "net",        "remark": "",        "showQRCode": false,        "strict": false,        "taxRateReason": "none",        "validUntil": null      },      "dueDays": 14,      "generationMode": "draft",      "id": "f40c8342-a98f-4bb3-b9ba-2c34a746db05",      "lastAttemptAt": null,      "lastErrorCode": "",      "name": "Monatliche Betreuung",      "nextDate": "2026-10-31",      "performancePeriodPolicy": "period",      "revision": 1,      "schedule": {        "anchorDay": 31,        "intervalMonths": 1,        "intervalWeeks": 0,        "startDate": "2026-10-31",        "timeZone": "Europe/Berlin"      },      "status": "paused",      "updatedAt": "2026-10-08T09:00:00Z"    }  ],  "offset": 0,  "total": 1}

Ausgestellte Mahnung zurückziehen POST

Kennzeichnet die Mahnung als zurückgezogen. Original-PDF und Verlauf bleiben erhalten. Rechnung, Zahlungen und Forderung werden nicht verändert. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.

Serienvorlage anlegen POST

Speichert Rechnungsinhalt und Kalenderplan. generationMode ist draft (Standard) oder issue; issue benötigt zusätzlich invoices:finalize. Standardmäßig pausiert; activate=true autorisiert ausdrücklich automatische Läufe im gewählten Modus. Die Anlage selbst vergibt keine Rechnungsnummer, bucht nicht und verschickt keine Nachricht. Benötigt einen Schlüssel mit der Berechtigung `invoices:draft`.