Возвращает поставки компании, от новых к старым по дате заказа поставки. Строки поставок в список не входят, их возвращает 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 с полями поставки:
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID поставки |
| num | string | Номер поставки |
| status | int | Статус, код из Смены статуса поставки |
| payment | int | Статус оплаты, код из Смены статуса оплаты поставки |
| date_placed | string | Дата заказа поставки |
| date_received | string | Дата получения. Пустая строка, если не задана |
| supplier_id | int | ID поставщика |
| supplier_name | string | Наименование поставщика |
| materials_storage_id | int | Склад материалов |
| materials_storage_name | string | Название склада материалов |
| products_storage_id | int | Склад продуктов |
| products_storage_name | string | Название склада продуктов |
| subtotal | float | Сумма строк |
| delivery_price | float | Стоимость доставки |
| discount | float | Скидка |
| total | float | Итого: subtotal плюс delivery_price минус discount |
| amount | float | Общее количество, если у всех строк одна единица измерения, иначе null |
| lines | int | Число строк |
| notes | string | Заметки |
Поле total в корне ответа содержит общее число поставок, подходящих под фильтры.
Пример запроса
{
"date_from": "2026-10-01",
"supplier_id": 45,
"limit": 100,
"offset": 0
}
Пример ответа
{
"success": true,
"purchases": [
{
"id": 29645,
"num": "15",
"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,
"delivery_price": 1500,
"discount": 0,
"total": 31500,
"amount": null,
"lines": 2,
"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 |