Данные поставки через API Controlata: get_entry

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

v1/purchases/get_entry.php

Параметры

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

Ответ

Объект purchase с полями поставки (см. Поставки) и двумя массивами строк: materials и products.

Поля строки:

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

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

Поля total, price и cost строки приходят числами, а не строками, и округляются до копеек. Если итог поставки равен 0 (скидка на всю сумму), total и price строк равны 0.

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

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

{
    "purchase_id": 29645
}

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

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

Ошибки

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