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

Максим

Максим

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

Возвращает данные поставки и ее строки.

v1/purchases/get_entry.php

Параметры

Поле Тип Обязательное Описание
purchase_id int Да ID поставки

Ответ

Объект purchase с полями поставки:

Поле Тип Описание
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 Заметки

А также два массива строк поставки: materials и products.

Поля строки:

Поле Тип Описание
id int ID материала или продукта
sku string Артикул
name string Название
amount float Количество
unit string Единица измерения
total float Сумма строки
price float Цена за единицу: total, деленный на amount
cost float Себестоимость строки
position int Номер строки в карточке поставки, от 0
notes string Комментарий к строке. Пустая строка, если его нет

Нумерация position сквозная для обоих массивов: по ней можно восстановить порядок строк, как в карточке поставки.

Строки из ответа можно отправить в v1/purchases/edit без изменений: лишние поля игнорируются.

Пример запроса

{
    "purchase_id": 29645
}

Пример ответа

{
    "success": true,
    "purchase": {
        "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",
        "materials": [
            {
                "id": 2051,
                "sku": "M010",
                "name": "Доска дубовая",
                "amount": 0.2,
                "cost": 27300,
                "unit": "куб. м",
                "position": 0,
                "total": 26000,
                "price": 130000,
                "notes": "Проверить толщину"
            },
            {
                "id": 2052,
                "sku": "M011",
                "name": "Клей столярный",
                "amount": 10,
                "cost": 4200,
                "unit": "кг",
                "position": 1,
                "total": 4000,
                "price": 400,
                "notes": ""
            }
        ],
        "products": []
    }
}

Ошибки

Ошибка Причина
No purchase_id in input Не передан purchase_id
Purchase not found or access denied Поставка не найдена или удалена