Belege einer Buchungsvorlage lesen
Benötigte Berechtigung:read(Daten lesen)
Listet die Belege, die aus dieser Buchungsvorlage entstanden sind.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Objekts in dieser Firma (UUID).
uuidErfolg.
application/json- response
[index: integer]?Ein Beleg: Ausgangsrechnung oder Eingangsbeleg mit den erkannten bzw. erfassten Daten.
curl --fail-with-body "https://app.bimetrics.de/api/document/collection/series/497f6eca-6276-4993-bfeb-53cbbbba6f08/document/" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"[ { "bookings": [ { "account": 4930, "accountContra": 71007, "accountingModel": "SKR03", "amount": "43.89", "bookingDate": { "day": 27, "month": 8, "year": 2026 }, "bookingFlags": "v19%", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:40Z", "deletedAt": null, "finalized": "2026-09-05T10:41:09Z", "finalizedBy": "export", "id": "f00b48c7-6eb3-4082-aba2-917944ac5f93", "label": "Papierhaus Wendt KG, Kopierpapier A4 10 Pakete", "performanceFrom": { "day": 27, "month": 8, "year": 2026 }, "performanceTo": { "day": 27, "month": 8, "year": 2026 }, "refBankTransactionId": null, "refDocumentId": "a129ef0a-da5d-4204-804c-764d751bca95", "refMatch": "d00419ed-ecab-4800-ad69-d482b73a6961", "revertsAccountBookingId": null, "updatedAt": "2026-09-05T10:41:09Z" } ], "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "contentSource": "auto", "createdAt": "2026-08-28T06:15:03Z", "deletedAt": null, "deliveryDate": null, "documentContract": null, "documentContractId": null, "documentSeries": null, "documentSeriesId": null, "dueDate": { "day": 10, "month": 9, "year": 2026 }, "id": "a129ef0a-da5d-4204-804c-764d751bca95", "importOrigin": "email", "invoiceDate": { "day": 27, "month": 8, "year": 2026 }, "invoiceNumber": "2026-5531", "invoicePositions": [ { "additionalInfo": { "freeOfVat": false, "reverseCharge": false }, "category": "office_supplies", "label": "Kopierpapier A4 10 Pakete", "subPositions": null, "total": 4389, "vatPercentage": "19" } ], "issuer": { "address": "Bahnhofstraße 8, 24103 Kiel", "customerNumber": 1007, "iban": "DE02500105170137075030", "name": "Papierhaus Wendt KG", "taxId": "DE246813579" }, "kind": "receipt", "match": { "amountOpen": 0, "autoMatch": false, "bankTransactions": [ { "bankTransactionId": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "id": "b06c1337-d724-4854-bba8-d52bc6355c8b", "matchId": "d00419ed-ecab-4800-ad69-d482b73a6961", "updatedAt": "2026-09-04T08:02:37Z" } ], "category": "payment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "documents": [ { "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "documentId": "a129ef0a-da5d-4204-804c-764d751bca95", "id": "e1331e65-c539-4c84-9271-66cc20f52910", "matchId": "d00419ed-ecab-4800-ad69-d482b73a6961", "updatedAt": "2026-09-04T08:02:37Z" } ], "id": "d00419ed-ecab-4800-ad69-d482b73a6961", "matchingRule": { "active": true, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:41Z", "id": "5e0f6a4b-8d2c-4f7e-9b1a-3c6d2e8f4a71", "updatedAt": "2026-09-04T08:02:41Z" }, "matchingRuleId": "5e0f6a4b-8d2c-4f7e-9b1a-3c6d2e8f4a71", "updatedAt": "2026-09-04T08:02:37Z" }, "paymentTerms": "Der Betrag wird per SEPA-Lastschrift eingezogen.", "performancePeriodFrom": null, "performancePeriodTo": null, "recipient": { "address": "Mühlenkamp 31, 22303 Hamburg", "customerNumber": null, "iban": "", "name": "Hansen & Kowalski Werbetechnik GmbH", "taxId": "DE123456789" }, "source": "", "updatedAt": "2026-09-05T10:41:09Z", "uploadDocument": { "blob": { "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-08-28T06:15:03Z", "id": "138b7a6f-7e79-4040-bc64-3638e95d9682", "length": 48213, "mime": "application/pdf", "originalFilename": "Rechnung_2026-5531.pdf", "sha256": "a5a23fdf5e666babc92d877ccf80202609c25ae54b48095f0eaa02289012ca54", "updatedAt": "2026-08-28T06:15:03Z" }, "blobId": "138b7a6f-7e79-4040-bc64-3638e95d9682", "creatorUserCompanyId": "53cd10a9-c864-4dc3-a777-9860d59efe6c", "ocrFinishedAt": "2026-08-28T06:15:19Z", "ocrStartedAt": "2026-08-28T06:15:04Z", "ocrStatus": "success", "pageCount": 2, "pagesRead": 2 }, "uploadDocumentId": "08f65ded-eef9-4cdf-8954-ace8add6eb53", "version": "" }]Buchungsvorlage ändern PUT
Ändert eine eigene Buchungsvorlage, wie in der App. Die Änderung gilt ab der nächsten Anwendung, schon erzeugte Belege bleiben, wie sie sind. PUT ändert nur die mitgeschickten Felder. `expectedUpdatedAt` ist Pflicht; hat sich das Objekt seitdem geändert, antwortet die Route mit `409 VersionConflict`. Geprüft wird wie im Formular der App: Bezeichnung, Art `invoice` oder `receipt`, 1 bis 100 Zeilen mit Betrag oder Anteil, Kategorie passend zu Art, Verwendung und Kontenrahmen, Steuersatz 19, 7 oder 0 %, auf Eingangsbelegen auch 9 oder 5,5 %, soweit die Kategorie ihn zulässt, Steuerfall bei 0 % auf Eingangsbelegen und die Gegenpartei der Art, außer alle Kategorien werden direkt gebucht. Verstöße ergeben `400 InvalidBookkeepingChange` mit `context.field`. Bezeichnung, Kategorie und Steuersatz werden nur geprüft, wenn sie neu sind. Standardvorlagen von bimetrics (`systemTemplateId` gesetzt) lassen sich per API lesen und zuordnen, aber nur in der App ändern oder löschen (`403 DocumentTemplateSystemLocked`). Gelöschte und zur Rechtsform unpassende Vorlagen ergeben `409 DocumentTemplateUnavailable`. Eine Wiederholung mit gleichem Idempotency-Key wirkt nicht doppelt. Benötigt einen Schlüssel mit der Berechtigung `collections:write`.
Adresse des Belegpostfachs lesen GET
Liefert die Adresse, an die Rechnungen der Firma gehen. Lesen legt nichts an: Hat die Firma noch keine Adresse, antwortet die Route mit `404`. Die Adresse entsteht, wenn jemand das Postfach in der App öffnet. Benötigt einen Schlüssel mit der Berechtigung `inbox:read`.