Sales
Z-reports and item-level sales from the point of sale (POS). Send them from the POS system and list them.
The endpoints in this group are not yet available. This page documents the contract as currently defined.
The Zreport object
Attributes
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
{
"id": "zr_58113",
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50",
"created_at": "2026-09-13T23:07:18+03:00",
"updated_at": "2026-09-13T23:07:18+03:00"
}
/sales/z-reportsQuery parameters
Opaque cursor returned as next_cursor in a previous response. Pass it to fetch the next page.
Start of the date range, inclusive, matched against the document date or the order date.
Responses
200A page of Z-reports.
Show 18 child attributesHide child attributes
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
curl "https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports?from=2026-09-12&to=2026-09-13&branch_id=71148-1" \
-H "Authorization: Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…"const res = await fetch("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports?from=2026-09-12&to=2026-09-13&branch_id=71148-1", {
method: "GET",
headers: {
Authorization: "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
});
const data = await res.json();import requests
res = requests.get(
"https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports?from=2026-09-12&to=2026-09-13&branch_id=71148-1",
headers={
"Authorization": "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
)
data = res.json()using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…");
var res = await http.GetAsync("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports?from=2026-09-12&to=2026-09-13&branch_id=71148-1");
var data = await res.Content.ReadAsStringAsync();
{
"data": [
{
"id": "zr_58113",
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50",
"created_at": "2026-09-13T23:07:18+03:00",
"updated_at": "2026-09-13T23:07:18+03:00"
},
{
"id": "zr_58097",
"branch_id": "71148-1",
"z_number": "1203",
"closed_at": "2026-09-12T23:21:00+03:00",
"description": "Z 1203 שניצי קפה – ראשי",
"total_before_vat": "13980.00",
"orders_count": 451,
"dine_in_total": "9870.00",
"dine_in_count": 262,
"take_away_total": "4110.00",
"take_away_count": 189,
"tips": "1312.00",
"cash_total": "2116.40",
"card_total": "14380.00",
"cheque_total": "0.00",
"discounts_total": "412.00",
"created_at": "2026-09-12T23:22:47+03:00",
"updated_at": "2026-09-12T23:22:47+03:00"
}
],
"next_cursor": null,
"has_more": false
}
/sales/z-reportsSend Z-reports from the POS. Each Z-report is identified by its branch_id and z_number, so sending the same Z-report again updates it.
Request body application/json
Up to 500 items
Show 15 child attributesHide child attributes
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Responses
200A result for each item.
Show 5 child attributesHide child attributes
curl -X POST "https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports" \
-H "Authorization: Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50"
}
]
}'const res = await fetch("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports", {
method: "POST",
headers: {
Authorization: "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
"Content-Type": "application/json",
},
body: JSON.stringify({
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50"
}
]
}),
});
const data = await res.json();import requests
res = requests.post(
"https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports",
headers={
"Authorization": "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
json={
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50"
}
]
},
)
data = res.json()using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…");
var body = new StringContent("""
{
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"closed_at": "2026-09-13T23:05:00+03:00",
"description": "Z 1204 שניצי קפה – ראשי",
"total_before_vat": "12450.00",
"orders_count": 414,
"dine_in_total": "8715.00",
"dine_in_count": 238,
"take_away_total": "3735.00",
"take_away_count": 176,
"tips": "1164.00",
"cash_total": "1902.00",
"card_total": "12789.00",
"cheque_total": "0.00",
"discounts_total": "386.50"
}
]
}
""", Encoding.UTF8, "application/json");
var res = await http.PostAsync("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/z-reports", body);
var data = await res.Content.ReadAsStringAsync();
{
"summary": {
"total": 1,
"succeeded": 1,
"failed": 0,
"skipped": 0
},
"items": [
{
"index": 0,
"key": "71148-1/1204",
"status": "created",
"id": "zr_58113"
}
]
}
/sales/item-salesQuery parameters
Opaque cursor returned as next_cursor in a previous response. Pass it to fetch the next page.
Start of the date range, inclusive, matched against the document date or the order date.
Responses
200A page of item sales.
Show 13 child attributesHide child attributes
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
curl "https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales?from=2026-09-13&to=2026-09-13&branch_id=71148-1&z_number=1204&limit=3" \
-H "Authorization: Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…"const res = await fetch("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales?from=2026-09-13&to=2026-09-13&branch_id=71148-1&z_number=1204&limit=3", {
method: "GET",
headers: {
Authorization: "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
});
const data = await res.json();import requests
res = requests.get(
"https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales?from=2026-09-13&to=2026-09-13&branch_id=71148-1&z_number=1204&limit=3",
headers={
"Authorization": "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
)
data = res.json()using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…");
var res = await http.GetAsync("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales?from=2026-09-13&to=2026-09-13&branch_id=71148-1&z_number=1204&limit=3");
var data = await res.Content.ReadAsStringAsync();
{
"data": [
{
"id": "is_7700431",
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-101",
"item_name": "שניצל בלחמניה",
"quantity": "96",
"unit_price": "41.53",
"total": "3986.88",
"line_number": 1,
"main_category": "מזון",
"sub_category": "כריכים",
"updated_at": "2026-09-13T23:07:19+03:00"
},
{
"id": "is_7700432",
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-205",
"item_name": "סלט ישראלי",
"quantity": "41",
"unit_price": "32.20",
"total": "1320.20",
"line_number": 2,
"main_category": "מזון",
"sub_category": "סלטים",
"updated_at": "2026-09-13T23:07:19+03:00"
},
{
"id": "is_7700433",
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "D-310",
"item_name": "קפה הפוך",
"quantity": "212",
"unit_price": "11.86",
"total": "2514.32",
"line_number": 3,
"main_category": "משקאות",
"sub_category": "קפה חם",
"updated_at": "2026-09-13T23:07:19+03:00"
}
],
"next_cursor": "cur_is_7700433_01J9KT1C9E",
"has_more": true
}
/sales/item-salesRequest body application/json
Up to 5000 items
Show 11 child attributesHide child attributes
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Decimal amount as a string, with exactly 2 fraction digits. The currency is set by currency on the parent object.
Responses
200A result for each item.
Show 5 child attributesHide child attributes
curl -X POST "https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales" \
-H "Authorization: Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…" \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-101",
"item_name": "שניצל בלחמניה",
"quantity": "96",
"unit_price": "41.53",
"total": "3986.88",
"line_number": 1,
"main_category": "מזון",
"sub_category": "כריכים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-205",
"item_name": "סלט ישראלי",
"quantity": "41",
"unit_price": "32.20",
"total": "1320.20",
"line_number": 2,
"main_category": "מזון",
"sub_category": "סלטים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "D-310",
"item_name": "קפה הפוך",
"quantity": "212",
"unit_price": "11.86",
"total": "2514.32",
"line_number": 3,
"main_category": "משקאות",
"sub_category": "קפה חם"
}
]
}'const res = await fetch("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales", {
method: "POST",
headers: {
Authorization: "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
"Content-Type": "application/json",
},
body: JSON.stringify({
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-101",
"item_name": "שניצל בלחמניה",
"quantity": "96",
"unit_price": "41.53",
"total": "3986.88",
"line_number": 1,
"main_category": "מזון",
"sub_category": "כריכים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-205",
"item_name": "סלט ישראלי",
"quantity": "41",
"unit_price": "32.20",
"total": "1320.20",
"line_number": 2,
"main_category": "מזון",
"sub_category": "סלטים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "D-310",
"item_name": "קפה הפוך",
"quantity": "212",
"unit_price": "11.86",
"total": "2514.32",
"line_number": 3,
"main_category": "משקאות",
"sub_category": "קפה חם"
}
]
}),
});
const data = await res.json();import requests
res = requests.post(
"https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales",
headers={
"Authorization": "Bearer zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…",
},
json={
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-101",
"item_name": "שניצל בלחמניה",
"quantity": "96",
"unit_price": "41.53",
"total": "3986.88",
"line_number": 1,
"main_category": "מזון",
"sub_category": "כריכים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-205",
"item_name": "סלט ישראלי",
"quantity": "41",
"unit_price": "32.20",
"total": "1320.20",
"line_number": 2,
"main_category": "מזון",
"sub_category": "סלטים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "D-310",
"item_name": "קפה הפוך",
"quantity": "212",
"unit_price": "11.86",
"total": "2514.32",
"line_number": 3,
"main_category": "משקאות",
"sub_category": "קפה חם"
}
]
},
)
data = res.json()using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "zk_test_XXXXXXXX_…zk_live_XXXXXXXX_…");
var body = new StringContent("""
{
"items": [
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-101",
"item_name": "שניצל בלחמניה",
"quantity": "96",
"unit_price": "41.53",
"total": "3986.88",
"line_number": 1,
"main_category": "מזון",
"sub_category": "כריכים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "P-205",
"item_name": "סלט ישראלי",
"quantity": "41",
"unit_price": "32.20",
"total": "1320.20",
"line_number": 2,
"main_category": "מזון",
"sub_category": "סלטים"
},
{
"branch_id": "71148-1",
"z_number": "1204",
"value_date": "2026-09-13T00:00:00+03:00",
"item_code": "D-310",
"item_name": "קפה הפוך",
"quantity": "212",
"unit_price": "11.86",
"total": "2514.32",
"line_number": 3,
"main_category": "משקאות",
"sub_category": "קפה חם"
}
]
}
""", Encoding.UTF8, "application/json");
var res = await http.PostAsync("https://sandbox-api.zester.co.il/v2https://api.zester.co.il/v2/sales/item-sales", body);
var data = await res.Content.ReadAsStringAsync();
{
"summary": {
"total": 3,
"succeeded": 3,
"failed": 0,
"skipped": 0
},
"items": [
{
"index": 0,
"key": "71148-1/1204/1",
"status": "created",
"id": "is_7700431"
},
{
"index": 1,
"key": "71148-1/1204/2",
"status": "created",
"id": "is_7700432"
},
{
"index": 2,
"key": "71148-1/1204/3",
"status": "created",
"id": "is_7700433"
}
]
}