Возвращает данные поставки и ее строки.
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 | Поставка не найдена или удалена |