Возвращает поставки компании, от новых к старым по дате заказа поставки. Строки поставок в список не входят, их возвращает v1/purchases/get_entry.
v1/purchases/get_list.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| date_from | string | Нет | Поставки с этой даты заказа включительно |
| date_to | string | Нет | Поставки по эту дату заказа включительно |
| supplier_id | int | Нет | Только поставки этого поставщика |
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |
Фильтры по датам работают по date_placed. Без параметров возвращаются все поставки компании. Подробнее о постраничной выдаче в статье Общие правила.
Ответ
Массив purchases с полями поставки (см. Поставки). Поле total в корне ответа содержит общее число поставок, подходящих под фильтры.
Пример запроса
{
"date_from": "2026-10-01",
"supplier_id": 45,
"limit": 100,
"offset": 0
}
Пример ответа
{
"success": true,
"purchases": [
{
"id": "29645",
"status": "1",
"payment": "0",
"date_placed": "2026-10-06",
"date_received": "",
"supplier_id": "45",
"supplier_name": "ООО Лесторг",
"materials_storage_id": "3998",
"materials_storage_name": "Основной склад",
"products_storage_id": "3998",
"products_storage_name": "Основной склад",
"subtotal": "30000.00",
"delivery_price": "1500.00",
"discount": "0.00",
"total": "31500.00",
"amount": null,
"lines": "2",
"shipments_count": "0",
"notes": "Счет № 118"
}
],
"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 |