Error
A valid request URL is required to generate request examples{
"id": "deposit-2026-07-16-store-rivoli",
"shopId": "store-rivoli",
"status": "open",
"lines": [
{
"reference": "SLIP-A",
"method": "cash",
"declaredCents": 12000,
"settledCents": null
},
{
"reference": "SLIP-B",
"method": "card",
"declaredCents": 8000,
"settledCents": null
}
]
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Finance
Open a deposit batch
Opens a new deposit batch from an id, its shop and at least one declared tender line (all lines start pending settlement). Returns the opened batch at 201. 409s when a batch with the same id already exists.
POST
/
v1
/
finance
/
deposits
Error
A valid request URL is required to generate request examples{
"id": "deposit-2026-07-16-store-rivoli",
"shopId": "store-rivoli",
"status": "open",
"lines": [
{
"reference": "SLIP-A",
"method": "cash",
"declaredCents": 12000,
"settledCents": null
},
{
"reference": "SLIP-B",
"method": "card",
"declaredCents": 8000,
"settledCents": null
}
]
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Body
application/json
Client-supplied unique batch id (409 if it already exists).
Minimum string length:
1The shop this deposit batch belongs to.
Minimum string length:
1At least one declared tender line (all start pending settlement).
Minimum array length:
1Show child attributes
Show child attributes

