Article scan / receipt closure

There are two possible requests in the Bottle-O API:

  • Article scan
  • receipt closure

Article scan

As the name suggests, the item scan request should be executed for every subtotal. The contents of the request are the header data and all items scanned so far. The items scanned so far must represent the current status of the receipt in order to be able to calculate the bonuses and stamp points correctly.

An article scan request is identified using the final field from the header data. If this field is set to false, the Bottle-O API treats the request as an article scan.

The bonuses and stamp points calculated up to this point are only noted.

"purchase": {
        "card_id": "42000007566795131965",
        "accounting_id": "000501",
        "purchase_date": "2021-08-11T10:23:24+2:00",
        "payment_method": "cash",
        "final": false,
    // ...
}

Receipt completion

The receipt completion request may only be sent after the checkout process has been completed. A completed checkout process can only be processed correctly in the Bottle-O API if at least one article scan request with the same accounting_id is made beforehand. Once the receipt completion request has been successfully processed, the entire checkout process is committed and qualified.

A receipt completion request is identified using the final field from the header data. If this field is set to 'true', the Bottle-O API treats the request as a receipt closure.

The calculated bonuses and stamp points are persisted for the customer.

"purchase": {
        "card_id": "42000007566795131965",
        "accounting_id": "000501",
        "purchase_date": "2021-08-11T10:23:24+2:00",
        "payment_method": "cash",
        "final": true,
    // ...
}