bimetricsEntwickler
Kassenbuch

Tagesabschluss prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/cash-imports/{id}/preview

Prüft einen gelesenen Tagesabschluss und zeigt, was die Übernahme buchen würde, ohne etwas zu schreiben: die Einträge mit ihren Buchungen am Kassentag, den Bestand danach, zu jedem Wert seine Quelle (fields) und die Prüfungen (checks). Ohne values nimmt die Prüfung die gelesenen Werte. Danach schickst du values aus der Antwort mit Änderungen zurück, wählst die Art jeder Bewegung, ergänzt Bewegungen, die der Z-Bon nicht druckt (source: manual), und nennst in confirmedFields die unsicheren Werte, die der Nutzer so bestätigt hat. ready ist true, wenn nichts mehr anhält oder fragt; valuesHash und balanceBeforeMinor gehen dann an applyCashImport. Steuersätze kommen nur aus dem Z-Bon, nie aus früheren Belegen. Ist der Tagesabschluss schon übernommen, liefert die Route seine Werte und Einträge.

Benötigt einen Schlüssel mit der Berechtigung read.

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

Request-Body

values as the preview gave them, with changes, chosen kinds, added movements and answers; confirmedFields

application/json
  1. body

Die Werte, die der Nutzer bestätigt hat.

confirmedFields?array<string>

Pfade der unsicheren Werte, die der Nutzer so bestätigt hat, wie sie gelesen wurden, etwa zNumber, payments.card oder movements.0.kind (path in fields); movements, wenn er bei einem nicht lesbaren Z-Bon geantwortet hat, dass keine Ein- oder Auszahlungen darauf stehen.

values?

Die Werte aus previewCashImport mit Änderungen, gewählten Arten, ergänzten Bewegungen und Antworten; ohne sie gelten die gelesenen Werte.

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/preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "balanceAfterMinor": 156175,  "balanceBeforeMinor": 106325,  "checks": [    {      "field": "movements.0.kind",      "key": "kind",      "level": "ask",      "message": "„Entnahme“ über 9,50 €: Wofür war das Geld?"    },    {      "field": "payments",      "key": "sums",      "level": "ok",      "message": "Bar, Karte und Gutscheine ergeben den Umsatz von 1.380,50 €."    }  ],  "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": "neu",        "origin": "web",        "text": "Barumsatz aus Z-1187",        "updatedAt": "2026-11-12T19:12:00Z",        "year": 2026      }    }  ],  "fields": [    {      "path": "payments.cash",      "quote": "Bar 518,00",      "source": "read"    },    {      "path": "movements.0.kind",      "quote": "Entnahme 9,50",      "source": "unsure"    }  ],  "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": "read",    "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  },  "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"}