Максим

Максим

Обновлено Oct 6, 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 с полями поставки (см. Поставки). Поле 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