POST /api/v1/closing/{clientId}/ book/openingStock – RetailForce Software GmbH

The funktion

POST /api/v1/closing/{clientId}/book/openingStock

is used to post the opening cash balance without reconciling the cash balance.

Attention: Using this function with a value of 0 does not reconcile the balance to 0, but only books the value 0.

Result

After execution, the specified amount is added to the opening cash register stock successfully.

Usage

This endpoint is used to transfer the initial balance of funds to the middleware.

Prerequisites

You need a valid clientId, userId, and userCaption to perform the operation.

Form fields:

Label	Description	Examples
clientId	the uniqueClientId of the cash register (from the RetailForce system)	aa227e71-6775-45d0-ba73-85da33c34d37
userId	the ID of the cashier perfoming the operation	0001
userCaption	name / designation of the cashier perfoming the operation	Klaus Kerbusk
documentNumber	Document number	0000001
documentGuid	Document GUID	a29a3081-9182-4344-aa51-131a3be6cfe0
documentId	Document ID	S018-0000001

Request body

Example request body:

[
  {
    "currencyIsoCode": "EUR",
    "amount": 100,
    "uniqueReadablePaymentIdentifier": "string",
    "foreignAmount": 0,
    "foreignAmountExchangeRate": 0,
    "isCash": true,
    "caption": "string",
    "paymentType": "cash",
    "voucherId": "string",
    "vatIdentification": 0,
    "vatPercent": 0,
    "taxValue": 0
  }
]

Response

Possible responses:

Code	Description	Examples
200	Amount successfully added to the opening stock	-