set.products.delete — Видалення: Товари
Призначення
Видаляє запис з довідника Товари.
Авторизація
- Логін/пароль: так.
meta.user_card: обов’язково.
Увага
Видалення це найскладніший сценарій у будь-якій системі, бо людям подобається робити незворотні речі, а потім питати “як повернути?”.
Параметри params
| Поле | Тип | Обовʼязково | Опис |
|---|
| id | string | так | Ідентифікатор запису (PK = Code). |
Правила / обмеження
-
Видалення можливе лише якщо
Main.Quant = 0. -
Перевіряється використання у непроведених накладних.
-
Запис переноситься у
Main_del, а з залежних таблиць дані очищаються.
Результат
Для товарів видалення реалізовано як перенос у Main_del.
Приклад запиту
Мокап: mockups/dictionaries/products/set.delete/request.json
{
"auth": {
"login": "<LOGIN>",
"password": "<PASSWORD>"
},
"method": "set.products.delete",
"params": {
"id": "12345"
},
"meta": {
"user_card": "<USER_CARD>",
"client_name": "MyIntegration",
"client_version": "1.0.0"
},
"id": "products-delete-001"
}
Приклад відповіді (успіх)
Мокап: mockups/dictionaries/products/set.delete/response.ok.json
{
"ok": true,
"result": {
"deleted": true,
"soft": false,
"id": "12345"
},
"meta": {
"api_version": "0.1.0",
"ts": "2026-01-26T12:00:00+00:00"
},
"id": "products-delete-001"
}
Типові помилки
-
NOT_FOUND— запис не знайдено. -
HAS_STOCK— у товару є залишок. -
USED_IN_DRAFT_INVOICE— товар у непроведеній накладній.