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