bimetricsEntwickler
Anlagen

Altbestand übernehmen

Als Markdown ansehen

Benötigte Berechtigung:documents:write(Nicht an DATEV exportierte Belege ändern)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/assets/import

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

Übernimmt die Anlagen der Liste wie die Vorschau, höchstens 100, je eine Anlage wie POST /api/assets mit origin opening. Auf dem Anlagekonto bucht nichts; sofort gebucht wird die AfA jedes Monats des laufenden Jahres bis heute. Eine Anlage aus einem Beleg (documentId, position, documentVersion) sperrt dessen Position wie ein Kauf, so wird keine Position zweimal Anlage. Lehnt die Route eine Zeile ab, wird nichts übernommen; context.message beginnt mit „Zeile n“. Bei einer Wiederholung schickst du denselben Idempotency-Key.

Benötigt einen Schlüssel mit der Berechtigung documents:write.

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 assets of the list

application/json
  1. body

Altbestand als Liste.

items?array<>|

Pflicht: die Anlagen, mindestens eine und höchstens 100, je wie opening beim Anlegen.

Antworten

Erfolg.

application/json
  1. response

Angelegte Anlagen.

assets?array<>|

Die Anlagen mit Nummer, Plan und Buchungen; bei einer Wiederholung die des ersten Aufrufs.

replayed?boolean

true bei einer Wiederholung.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/assets/import" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "assets": [    {      "account": 400,      "acquired": {        "day": 10,        "month": 3,        "year": 2024      },      "afaAccount": 4830,      "afaTableEntry": "6.15 Büromöbel",      "automatic": false,      "aveuerGroup": "office",      "bookings": [        {          "account": 4830,          "accountContra": 400,          "amountCents": 833,          "date": {            "day": 30,            "month": 11,            "year": 2026          },          "kind": "depreciation",          "label": "AfA Schreibtisch",          "month": "2026-11"        }      ],      "category": "equipment",      "channel": "api",      "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",      "computer": false,      "costCents": 130000,      "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": 24700,      "label": "Schreibtisch",      "method": "linear",      "netCents": 130000,      "number": "A-0007",      "openingBookValueCents": 111667,      "openingDate": {        "day": 1,        "month": 1,        "year": 2026      },      "openingRemainingMonths": 134,      "origin": "opening",      "plan": [        {          "bookValueEndCents": 101667,          "bookValueStartCents": 111667,          "bookedCents": 9167,          "depreciationCents": 10000,          "profitEffectCents": -10000,          "year": 2026        }      ],      "positions": [        {          "costCents": 130000,          "index": 0        }      ],      "quantity": 1,      "reverseMode": "undo",      "status": "active",      "undoUntil": "2026-12-15T10:00:00Z",      "updatedAt": "2026-11-15T10:00:00Z",      "usefulLifeMonths": 156,      "year": {        "bookValueEndCents": 101667,        "bookValueStartCents": 111667,        "bookedCents": 9167,        "depreciationCents": 10000,        "profitEffectCents": -10000,        "year": 2026      }    }  ]}