Возвращает заказы компании, от новых к старым: по дате заказа, а внутри одной даты по номеру. Строки заказов в список не входят, их возвращает v1/orders/get_entry.
v1/orders/get_list.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| date_from | string | Нет | Заказы с этой даты заказа включительно |
| date_to | string | Нет | Заказы по эту дату заказа включительно |
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |
Фильтры работают по date_placed. Без параметров возвращаются все заказы компании. Подробнее о постраничной выдаче в статье Общие правила.
Ответ
Массив orders с полями заказа (см. Заказы) и полями:
| Поле | Тип | Описание |
|---|---|---|
| shipments_count | int | Число отгрузок заказа |
| products_storage_name | string | Название склада продуктов |
| materials_storage_name | string | Название склада материалов |
| storage_id, storage_name | Синонимы склада продуктов, оставлены для совместимости | |
| customer_* | Все поля покупателя: customer_id, customer_type, customer_name, customer_email, customer_phone, customer_address_real, customer_address_legal, customer_inn, customer_kpp, customer_ogrn, customer_agreement, customer_manager_name, customer_manager_post, customer_notes |
Поле total в корне ответа содержит общее число заказов, подходящих под фильтры. У заказа под производство products_storage_id равен «0», а название склада null.
Пример запроса
{
"date_from": "2026-10-01",
"date_to": "2026-10-31",
"limit": 100,
"offset": 0
}
Пример ответа
{
"success": true,
"orders": [
{
"id": "43727",
"num": "A-1001",
"status": "3",
"payment": "2",
"date_placed": "2026-10-06",
"date_shipped": "2026-10-08",
"total": "30000.00",
"subtotal": "30500.00",
"delivery_price": "500.00",
"discount": "1000.00",
"cost": "17800.00",
"notes": "Заказ с сайта",
"amount": "3.000",
"lines": "2",
"shipments_count": "1",
"production": "0",
"production_num": null,
"source": "api",
"products_storage_id": "3998",
"products_storage_name": "Основной склад",
"storage_id": "3998",
"storage_name": "Основной склад",
"materials_storage_id": "3998",
"materials_storage_name": "Основной склад",
"customer_id": "512",
"customer_type": "3",
"customer_name": "Иван Петров",
"customer_email": "ivan@example.com",
"customer_phone": "+7 900 123-45-67",
"customer_address_real": "г. Москва, ул. Лесная, д. 5, кв. 12",
"customer_address_legal": "",
"customer_inn": "",
"customer_kpp": "",
"customer_ogrn": "",
"customer_agreement": "",
"customer_manager_name": "",
"customer_manager_post": "",
"customer_notes": ""
}
],
"total": 1
}
Ошибки
| Ошибка | Причина |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | Неверная date_from или date_to |
| Invalid limit value. Must be between 1 and 1000 | Неверный limit |
| Invalid offset value. Must be 0 or greater | Неверный offset |
| Offset requires limit | Передан offset без limit |