Список отложек / Список черновиков
const url = 'https://api-admin.billz.ai/v2/order-notes?page=1&limit=5&shop_id=803b542d-51e5-41ea-9124-51f248536286&start_total_price=0&end_total_price=0&order_park_status=active%2Cexpired&shift_id=0&future_time_is_null=false';const options = { method: 'GET', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', Authorization: 'Bearer <token>' }};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api-admin.billz.ai/v2/order-notes?page=1&limit=5&shop_id=803b542d-51e5-41ea-9124-51f248536286&start_total_price=0&end_total_price=0&order_park_status=active%2Cexpired&shift_id=0&future_time_is_null=false' \ --header 'Authorization: Bearer <token>' \ --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01'Коды ошибок: 400 — ошибка валидации входных данных; 404 — объект не найден; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Authorizations
Заголовок раздела «Authorizations»Parameters
Заголовок раздела «Parameters»Query Parameters
Заголовок раздела «Query Parameters»Номер страницы; нечисловое значение -> 400
Example
1Размер страницы
Example
5Магазин; при непустом значении обязан быть UUID
Example
803b542d-51e5-41ea-9124-51f248536286Кассир
Продавец
Тип оплаты (единственное число)
Сумма чека от
Сумма чека до
Active, expired, completed; если пусто и future_time_is_null=false — подставляются все три статуса
Example
[ "active", "expired"]Касса
Смена; при shift_id>0 и заданном cashbox_id применяется фильтр по датам открытия/закрытия смены
Поиск по id продажи, клиенту или пользователю
Дата создания с
Дата создания по
SALE, RETURN, EXCHANGE
Строка, не bool: значение “false” включает подстановку всех park-статусов
Example
falseМагазин инвентаризации
Отбор по дате последнего обновления
Header Parameters
Заголовок раздела «Header Parameters»Идентификатор платформы. Для интеграций используется статичное значение.
Responses
Заголовок раздела «Responses»Успешный ответ
object
Общее количество записей
Список продаж
object
Id продажи
Родительская продажа (при возврате)
Id компании
Номер продажи
Статус продажи
Детали: customer, user, cashbox_name, cashbox_id, cashbox_history_id, shift_id, shop_id, shop, total_price, discount_value, discount_unit, has_discount, total_measurement_value, version_number, comment, created_at, created_at_utc, order_items, order_payments, with_cashback, returned_cashback, loyalty, gift_card_payment, is_authorized, has_certificate, has_voucher, promo_codes, without_cashback, user_has_auth_role, offline_order_validation_status, applied_on_cart, auth_client_cashback_withdrawal, has_payment_token, payment_token, rounding_operations
object
object
object
object
object
SALE / RETURN / EXCHANGE
Дата создания
Дата удаления (epoch)
Дата создания UTC
Время отложки
Долг
Клиент
Долг родительской продажи
Признак удаления
Кто удалил
Имя удалившего
Кол-во логов Webkassa
Кол-во логов EPOS
Фискальные логи
Фактическое завершение
Отображаемое завершение
Дата продажи
Отображаемая дата продажи
Отображаемая дата удаления
Платежи по долгу
Статус отложки
Обмен запрещён
Остаток долга по цепочке
Остаток оплаты через SoftPOS
Дата обновления
Есть страховка
Страховка
Examplegenerated
{ "count": 1, "orders": [ { "id": "example", "parent_id": "example", "company_id": "example", "order_number": "example", "order_status": "example", "order_detail": { "customer": {}, "user": { "id": "example", "name": "example", "first_name": "example", "last_name": "example" }, "cashbox_name": "example", "cashbox_id": "example", "cashbox_history_id": "example", "shift_id": 1, "shop_id": "example", "shop": { "id": "example", "name": "example" }, "total_price": 1, "has_discount": true, "total_products_measurement_value": 1, "total_sets_measurement_value": 1, "total_services_measurement_value": 1, "total_returned_measurement_value": 1, "comment": "example", "created_at": "example", "created_at_utc": "example", "with_cashback": 1, "returned_cashback": 1, "loyalty_balance_income": 1, "loyalty_balance_outcome": 1, "loyalty_payment": 1, "not_loyalty_payment": 1, "gift_card_payment": 1, "is_authorized": true, "has_certificate": true, "has_voucher": true, "promo_codes": [ "example" ], "without_cashback": true, "user_has_auth_role": true, "offline_order_validation_status": 1, "applied_on_cart": true, "auth_client_cashback_withdrawal": true, "has_payment_token": true, "payment_token": "example", "rounding_operations": [ {} ] }, "order_type": "example", "created_at": "example", "deleted_at": 1, "created_at_utc": "example", "future_time": "example", "debt": "example", "customer_id": "example", "parent_order_debt": "example", "deleted": true, "deleted_by_user_id": "example", "deleted_by_user_name": "example", "webkassa_log_qty": 1, "epos_log_qty": 1, "epos_logs": [ "example" ], "finished_at": "example", "display_finished_at": "example", "sold_at": "example", "display_sold_at": "example", "display_deleted_at": "example", "order_debt_payments": [ "example" ], "park_status": "example", "exchange_disabled": true, "total_remaining_debt_in_chain": 1, "total_remaining_softpos_payment": 1, "updated_at": "example", "has_insurance": true, "insurance": "example", "is_calculated": true } ]}