Receipts need to be created in 7shifts as soon as they are opened in your system in order to ensure consistency between the two platforms.
As a result, as soon as a receipt is opened in your system, you will need to make a POST request to 7shifts’ /receipts endpoint in your system following the request structure described in the previous sub-section (POST structure for /receipts)
If an error message is returned stating
"Duplicate receipt for this date/time" when trying to create a sales receipt, it could be because of one of the following scenarios:
external_id specified is the same as another receipt for the same location.
open_date specified has the exact same date, hour, minute & second as an existing receipt at the same location:
- This error will only be seen at high-volume restaurant locations where multiple receipts are being opened in the same second
- If you face such an error, increment the second in the
open_dateby 1 and retry
- Have a 10-times retry limit in place so that the action doesn’t result in a deadlock
- If an
open_datestill can’t be found within a 10 second window, then grouping the two receipts together, sum up their total field values, and send them as one receipt
- Please bear in mind that updating such receipts would be tricky in the future, as one such 7shifts receipt would represent two or more receipts from your system