Guides
Reconciliation
Every day, after the business day closes, compare what your system booked with ours. A difference reveals an order that never arrived or a price changed on one side only.
The flow#
- Your system → Let's PizzaYesterday per branch, as we count it
GET /partner/v1/reports/daily?date=… - Let's Pizza → Your systemCounts, served, ended, open, totals and the served orders
- Your system → Let's PizzaYour own count, to compare
POST /partner/v1/reports/reconciliation - Let's Pizza → Your systemMatched or not, and the numbers missing on each side
The daily report#
Your orders created on a Riyadh calendar day (00:00–24:00 +03:00) at the branches your key may see. Per branch: how many, served (delivered or picked up), ended unserved, still open, the served total and refunds in halalas, VAT-inclusive; plus the served orders with your order numbers. Pick the day with date and a branch with branchId.
{
"date": "string",
"branches": [
{
"branchId": "28",
"externalCode": "STORE-28",
"orders": 0,
"served": 0,
"ended": 0,
"open": 0,
"servedTotal": 0,
"refunded": 0
}
],
"orders": [
{
"orderId": "7f3a2c10-5b8e-4d21-9c47-1a2b3c4d5e01",
"number": "261119-0041",
"branchId": "28",
"status": "pending_payment",
"total": 0,
"externalOrderNo": "string",
"createdAt": "2026-11-19T19:30:12+03:00"
}
]
}The comparison#
Send your served count and total per branch, and best your order numbers too. The answer says per branch whether they match, which of your numbers we do not know, and which of our served orders you did not list. Nothing is stored.
{
"date": "string",
"branches": [
{
"branchId": "28",
"served": 0,
"servedTotal": 0,
"externalOrderNos": [
"string"
]
}
]
}{
"date": "string",
"matched": true,
"branches": [
{
"branchId": "28",
"ours": {
"served": 0,
"servedTotal": 0
},
"theirs": {
"served": 0,
"servedTotal": 0
},
"matched": true,
"missingAtPartner": [
"string"
],
"unknownAtLp": [
"string"
]
}
]
}When to run it#
Days are Riyadh time. Run it every morning after 04:00 for the day before, so late-night orders are complete. A difference reveals an order that never reached your system, or a price changed on one side only.
Endpoints used#
Anything marked “Coming soon” is not served yet; it joins the reference as soon as it ships.
- GET
/partner/v1/reports/dailyA day per branchreports:readAvailable - POST
/partner/v1/reports/reconciliationCompare your count with oursreports:readAvailable - GET
/partner/v1/ordersNew orders, by cursororders:readAvailable - GET
/partner/v1/orders/{id}One order and its statusorders:readAvailable - GET
/partner/v1/orders/{id}/paymentsPayment, collection and refundspayments:readAvailable