Abgang zurücknehmen
Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)
Echte Wirkung
/api/assets/{id}/disposal/reverseKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
Nimmt den Abgang zurück wie die Vorschau: Festgeschriebenes bekommt eine Gegenbuchung mit dem Datum des Originals, Offenes einen Löschvermerk. Eine Rechnung bekommt die Kategorien zurück, die ihre Positionen vor dem Verkauf hatten, und bucht neu: Offenes wird ersetzt, Festgeschriebenes mit seinem Datum storniert und neu gebucht. Ein Abgang im Vorjahr geht nur mit confirmPriorYear, ältere nicht. expectedVersion ist Pflicht. Bei einer Wiederholung schickst du denselben Idempotency-Key.
Benötigt einen Schlüssel mit der Berechtigung documents:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID der Anlage (UUID).
uuidIdempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128expected version
application/json- body
Rücknahme eines Abgangs.
confirmPriorYear?booleantrue bestätigt die Rücknahme eines Abgangs im Vorjahr.
expectedVersion?stringPflicht: version der Anlage, wie zuletzt gelesen.
Erfolg.
application/json- response
Anlage nach dem Abgang oder seiner Rücknahme.
asset?Die Anlage.
replayed?booleantrue bei einer Wiederholung.
curl --fail-with-body "https://app.bimetrics.de/api/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/disposal/reverse" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "asset": { "account": 400, "acquired": { "day": 12, "month": 5, "year": 2026 }, "afaAccount": 4830, "afaTableEntry": "6.15 Büromöbel", "automatic": false, "aveuerGroup": "office", "category": "equipment", "channel": "api", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "computer": false, "costCents": 81000, "createdAt": "2026-11-15T10:00:00Z", "documentId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2a4c6b8d13", "enteredAt": "2026-11-15T10:00:00Z", "gross": false, "id": "5e8c1a3f-7b2d-4c69-a0e4-9d1f3b5c7e82", "inputTaxCents": 15010, "label": "Bürostuhl", "method": "linear", "netCents": 81000, "number": "A-0007", "openingBookValueCents": 0, "openingRemainingMonths": 0, "origin": "purchase", "positions": [ { "costCents": 79000, "index": 0 }, { "costCents": 2000, "incidental": true, "index": 1 } ], "quantity": 1, "status": "active", "updatedAt": "2026-11-15T10:00:00Z", "usefulLifeMonths": 156 }}Abgang einer Anlage prüfen POST
Prüft einen Abgang wie `POST /api/assets/{id}/disposal` und zeigt, was er schreiben würde, ohne etwas zu speichern: die AfA bis zum Abgangsmonat, den Restwert am Abgangstag, Erlös und Ergebnis mit ihren Konten, die Buchungen und bei einer festgeschriebenen Rechnung die Monate, in denen sie storniert und neu gebucht wird. Abgänge sind ein Verkauf an einer Ausgangsrechnung (`invoiceId` mit Positionen) oder eine Verschrottung (Tag und Grund). Einen Verkauf, den der Händler mit seiner Rechnung verrechnet (`dealerDocumentId`), lehnt die Route noch ab: Lade die Gutschrift des Händlers als Ausgangsrechnung hoch oder schreib ihm eine Rechnung, und verkaufe an ihr. Nur 19 % und Kleinunternehmer; Ausfuhr und innergemeinschaftliche Lieferung bucht die Kanzlei. Benötigt einen Schlüssel mit der Berechtigung `read`.
Rücknahme eines Abgangs prüfen POST
Zeigt, was das Zurücknehmen eines Abgangs schreibt, ohne etwas zu speichern: Der Restwert wird storniert, die AfA bis zum Abgangsmonat bleibt, die Monate danach bucht bimetrics bis heute nach. Benötigt einen Schlüssel mit der Berechtigung `read`.