bimetricsEntwickler
Kassenbuch

Tagesabschluss übernehmen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/cash-imports/{id}/apply

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

Bucht den Tagesabschluss so, wie previewCashImport ihn gezeigt hat, in einem Schritt. Ins Kassenbuch kommt nur Bargeld: der Baranteil des Umsatzes, bares Trinkgeld fürs Team und seine Auszahlung, Auszahlungen, Lohn, Geld von und zur Bank, Privatentnahmen und -einlagen, die Kassendifferenz. Kartenzahlungen buchen auf Geldtransit (SKR03 1360, SKR04 1460), als Zahlart eingelöste Mehrzweck-Gutscheine auf „Ausgegebene Geschenkgutscheine“ (1796, 3786), Trinkgeld fürs Team auf durchlaufende Posten (1590, 1370), Lohn auf „Verbindlichkeiten aus Lohn und Gehalt“ (1740, 3720). Jede Zeile bucht am Kassentag, ohne Debitor oder Kreditor und mit eigenem Buchungstext. Eine Auszahlung wartet ohne Buchung auf ihren Beleg. Die Route lehnt ab, solange eine Prüfung anhält oder fragt, wenn sich Werte oder Bestand seit der Prüfung geändert haben (valuesHash, expectedBalanceMinor), und für die Steuerberatung (403 CashBookOwnerOnly). Danach lässt sich der Tagesabschluss nur noch als Ganzes stornieren. Bei einer Wiederholung schickst du denselben Idempotency-Key.

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

Authentifizierung

headerAuthentifizierungBearer <bm_…>

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

Pfadparameter

id*string

ID des Tagesabschlusses (UUID).

Formatuuid

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

values and confirmedFields of the preview with its valuesHash; expectedBalanceMinor from the preview

application/json
  1. body

Die Übernahme eines geprüften Tagesabschlusses.

confirmedFields?array<string>

Die bestätigten Werte wie bei der Prüfung.

expectedBalanceMinor?integer

Pflicht: balanceBeforeMinor aus der Prüfung; kam inzwischen eine Buchung dazu, lehnt die Route ab.

values?

Die Werte wie bei der Prüfung.

valuesHash?string

Pflicht: valuesHash aus previewCashImport mit denselben Werten.

Antworten

Erfolg.

application/json
  1. response

Ein Tagesabschluss mit Prüfung und dem, was die Übernahme bucht.

balanceAfterMinor?integer

Bestand nach der Übernahme in Cent.

balanceBeforeMinor?integer

Bestand der Kasse jetzt in Cent.

checks?array<>|

Die Prüfungen in ihrer Reihenfolge.

entries?array<>|

Die Einträge, die die Übernahme bucht, mit Nummer neu; nach der Übernahme die gebuchten.

fields?array<>|

Jeder Wert mit seiner Quelle.

import?

Der Tagesabschluss.

lastTipsFor?string

Wem das Trinkgeld beim letzten Tagesabschluss der Kasse gehörte: team oder owner; der einzige Vorschlag aus einem früheren Abschluss.

Wert in"team""owner"
ready?boolean

true, wenn keine Prüfung mehr anhält oder fragt.

replayed?boolean

true bei einer Wiederholung mit demselben Idempotency-Key.

values?

Die geprüften Werte; mit Änderungen an previewCashImport zurück oder an applyCashImport.

valuesHash?string

Prüfwert dieser Werte für applyCashImport.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/cash-imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/apply" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "balanceAfterMinor": 156175,  "balanceBeforeMinor": 106325,  "checks": [],  "entries": [    {      "bookings": [        {          "account": 1000,          "accountContra": 8400,          "amountMinor": 51800,          "flags": "ust19%",          "text": "Z-1187 Umsatz 19 % bar"        },        {          "account": 1360,          "accountContra": 8400,          "amountMinor": 80250,          "flags": "ust19%",          "text": "Z-1187 Umsatz 19 % Karte"        },        {          "account": 1796,          "accountContra": 8400,          "amountMinor": 6000,          "flags": "ust19%",          "text": "Z-1187 Umsatz 19 % Gutschein"        }      ],      "entry": {        "amountMinor": 51800,        "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39",        "cashImportId": "4a8c2e6f-1b3d-4f57-9a0c-2e4f6a8b0c13",        "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5",        "createdAt": "2026-11-12T19:12:00Z",        "entryDate": {          "day": 12,          "month": 11,          "year": 2026        },        "id": "8b2d4f60-3c5e-4a71-9b0d-1f3a5c7e9b20",        "kind": "sales",        "number": "KB-2026-0429",        "origin": "web",        "text": "Barumsatz aus Z-1187",        "updatedAt": "2026-11-12T19:12:00Z",        "year": 2026      }    }  ],  "fields": [],  "import": {    "cashBookId": "7c2e9a41-5b3d-4f08-9e61-2d8a4c7f1b39",    "createdAt": "2026-11-12T19:10:00Z",    "day": {      "day": 12,      "month": 11,      "year": 2026    },    "fileName": "z-bon-1187.jpg",    "fileType": "photo",    "id": "4a8c2e6f-1b3d-4f57-9a0c-2e4f6a8b0c13",    "origin": "web",    "registerId": "1",    "sha256": "9f2c4e6a8b0d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a",    "sizeBytes": 812345,    "source": "zbon",    "status": "applied",    "textSource": "pdf",    "unsure": 2,    "uploadedBy": "Jana Kröger",    "values": {      "day": {        "quote": "12.11.2026 19:04",        "sure": true,        "value": "2026-11-12"      },      "movements": [        {          "amount": {            "minor": 950,            "quote": "Entnahme 9,50",            "sure": false          },          "in": false,          "kind": "payout",          "kindSure": false,          "label": "Entnahme",          "text": "Post"        }      ],      "payments": {        "card": [          {            "amount": {              "minor": 80250,              "quote": "EC 802,50",              "sure": true            },            "label": "EC"          }        ],        "cash": {          "minor": 51800,          "quote": "Bar 518,00",          "sure": true        },        "voucher": {          "minor": 6000,          "quote": "Gutschein 60,00",          "sure": true        }      },      "registerId": {        "quote": "Kasse 1",        "sure": true,        "value": "1"      },      "revenue": [        {          "gross": {            "minor": 138050,            "quote": "MwSt 19% 1.380,50",            "sure": true          },          "rate": 19        }      ],      "tips": {},      "zNumber": {        "quote": "Z-Nr. 1187",        "sure": true,        "value": "1187"      }    },    "zNumber": 1187,    "zSeries": 1  },  "ready": false,  "values": {    "closingBalanceMinor": 156175,    "day": {      "day": 12,      "month": 11,      "year": 2026    },    "movements": [      {        "amountMinor": 950,        "kind": "payout",        "text": "Entnahme Post"      }    ],    "openingBalanceMinor": 106325,    "payments": {      "cardMinor": 80250,      "cashMinor": 51800,      "voucherMinor": 6000    },    "registerId": "1",    "revenue": [      {        "grossMinor": 138050,        "rate": 19      }    ],    "tips": {},    "zNumber": 1187  },  "valuesHash": "abababababababababababababababababababababababababababababababab"}