Получение списка поставок

Максим

Максим

Обновлено Nov 20, 2026

Возвращает поставки компании, от новых к старым по дате заказа поставки. Строки поставок в список не входят, их возвращает 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