/deposit and /withdraw
Request body:
| Field | Type | Required | Format / constraints |
|---|---|---|---|
documentID | integer (int64) | No | Internal document id |
documentExtID | string | No | External document id |
amount | integer (int64) | Yes | Must be > 0 |
employeeName | string | No | Cashier name |
genPreview | boolean | No | If true, requests a fiscal receipt preview (see preview_data in the response) |
Success response:
| Field | Type | Required | Notes |
|---|---|---|---|
documentID | integer (int64) | No | Cash operation document id |
documentExtID | string | No | External document id (echoed from the request) |
fiscalID | string | No | Fiscal id |
fiscalNum | string | No | Fiscal number |
fiscalUrl | string | No | Fiscal URL |
preview_data | string | No | Receipt preview text; present only when genPreview=true was requested |
amount | integer (int64) | No | Echoes the request's amount |
currency_name | string | No | Currency of amount |
Specific recovery behavior:
- For retry/resume, server matches an existing cash document by operation type (
deposit/withdraw) and cash amount. documentExtID(ordocumentID) is used as retry key to locate/reuse the same document safely.- If neither
documentExtIDnordocumentIDis provided, deterministic recovery is not guaranteed. - If a document from a previous, unfinished operation is pending and the request cannot be matched to it, the request is rejected with
code = 44(CASHBOX_BUSY) rather than starting a new document — see §12.3.