Löschen einer Dauerbuchung prüfen
Benötigte Berechtigung:read(Daten lesen)
Zählt, was das Löschen mit den Belegen täte, und ändert nichts. Künftige Belege gehen immer mit, Belege bis heute nur mit pastDocuments. Zugeordnete, bezahlte und festgeschriebene bleiben in jedem Fall. Solange assigned größer als 0 ist, lehnt das Löschen ab.
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
Was das Löschen mit den Belegen täte.
assigned?integerZugeordnete Belege; solange es welche gibt, lehnt das Löschen ab.
contractStays?booleanOhne pastDocuments bleiben Belege und damit die Dauerbuchung als gelöscht vermerkt.
deletable?integerBelege bis heute, die mit pastDocuments mitgehen.
kept?integerBelege bis heute, die in jedem Fall bleiben.
upcoming?integerKünftige Belege, die in jedem Fall mitgehen.
curl --fail-with-body "https://app.bimetrics.de/api/document/collection/contract/497f6eca-6276-4993-bfeb-53cbbbba6f08/delete-preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "assigned": 0, "contractStays": true, "deletable": 2, "kept": 1, "upcoming": 1}Dauerbuchung ändern PUT
Ändert eine Dauerbuchung, wie in der App. Eine Änderung gilt nur nach vorn: Offene und künftige Belege folgen ihr, zugeordnete, bezahlte und festgeschriebene bleiben, wie sie sind. Zum Beenden genügt `documentContractRepetitionFixed` mit `end`. Das Ende darf die laufende Periode nicht abschneiden (`422 DocumentContractEndBeforeRunningPeriod`). Der Rhythmus wird nur geprüft, wenn er sich ändert. 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. Eine gelöschte Dauerbuchung ergibt `409 DocumentContractDeleted`. Eine Wiederholung mit gleichem Idempotency-Key wirkt nicht doppelt. Benötigt einen Schlüssel mit der Berechtigung `collections:write`.
Belege einer Dauerbuchung lesen GET
Listet die Belege der Perioden einer Dauerbuchung. Benötigt einen Schlüssel mit der Berechtigung `read`.