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