Discussions

We are currently integrating a POS solution with 7shifts, where our application sends order data to create 7shifts receipts via their API.

During this process, we encountered an issue with handling refunds. In our application, refunds are categorized into two types:

Full Refund: All items on the bill, including tips, are refunded.
Item Refund: Only specific line items are refunded.

For a full refund, the 7shifts API documentation specifies that the gross_total and net_total should both be set to 0. This raises the following questions:

Receipt Status: Should the receipt’s status also be marked as "voided" for a full refund?

API Update: Can we simply use the PUT API to update the receipt with the following data?

{
"net_total": 0,
"gross_total": 0,
"status": "voided"
}

Or, do we need to first retrieve the receipt details using the GET API (by receipt ID) and then update the totals to preserve other receipt information?

Item Refund Handling: For partial refunds, what changes are required in the receipt data? Do we need to update the prices of the refunded line items as well?