bimetricsEntwickler
Anlagen

DATEV-Weg der Abschreibungen festlegen

Als Markdown ansehen

Benötigte Berechtigung:datev:export(DATEV-Export starten und Buchungen festschreiben)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
put/api/settings/datev

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Speichert die Antwort ab einem 1. Januar: des laufenden Jahres, solange daraus keine Abschreibung an DATEV ging, sonst des nächsten. Danach steht sie für das Jahr fest (409 AssetRejected). Jede Buchung folgt der Antwort ihres Datums, auch als Nachtrag. Antworten dürfen nur Inhaber und Steuerberatung (403 AssetForbidden), frühere Antworten bleiben erhalten. Bei einer Wiederholung schickst du denselben Idempotency-Key.

Benötigt einen Schlüssel mit der Berechtigung datev:export.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Header-Parameter

Idempotency-Key*string

Stabiler 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.

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

the answer and the 1 January it applies from

application/json
  1. body

Antwort zum DATEV-Weg.

assetDepreciation?

Pflicht: die Antwort und ihr 1. Januar.

Antworten

Erfolg.

application/json
  1. response

DATEV-Einstellungen der Anlagen.

assetDepreciation?|

Wer die Abschreibungen an DATEV liefert.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/settings/datev" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "assetDepreciation": {    "currentYearOpen": false,    "history": [      {        "channel": "web",        "enteredAt": "2026-11-15T10:00:00Z",        "mode": "bimetrics",        "validFrom": {          "day": 1,          "month": 1,          "year": 2027        }      }    ],    "proposedFrom": {      "day": 1,      "month": 1,      "year": 2027    },    "question": "Rechnet deine Kanzlei die Abschreibungen selbst in DATEV?",    "upcoming": {      "channel": "web",      "enteredAt": "2026-11-15T10:00:00Z",      "mode": "bimetrics",      "validFrom": {        "day": 1,        "month": 1,        "year": 2027      }    }  }}