set.products.update — Оновлення: Товари

Призначення

Оновлює існуючий запис у довіднику Товари.

Авторизація

• Логін/пароль: так.
• meta.user_card: обов’язково.

Параметри params

Поле	Тип	Обовʼязково	Опис

| id | string | так | Ідентифікатор запису (PK = Code). |

| data | object | так | Поля, які треба змінити. |

| descriptions | array[string] | ні | Якщо передано, описи будуть синхронізовані (старі видаляються, нові вставляються). |

| extra_fields | array або object | ні | Додаткові поля (upsert). |

| with_details | bool | ні | Якщо true, API поверне товар з details. |

Примітки

• Якщо передати descriptions (навіть порожній масив), описи в Main_desc будуть синхронізовані: старі видаляються, нові вставляються.

• Якщо передати extra_fields, значення оновлюються; порожнє значення трактуємо як видалення поля.

Приклад запиту

Мокап: mockups/dictionaries/products/set.update/request.json

{
  "auth": {
    "login": "<LOGIN>",
    "password": "<PASSWORD>"
  },
  "method": "set.products.update",
  "params": {
    "id": "12345",
    "data": {
      "Nt": "Молоко 2.5% (оновлено)",
      "Price": 43.0
    },
    "descriptions": [
      "Новий опис"
    ],
    "extra_fields": {
      "1": "нове значення"
    },
    "with_details": true
  },
  "meta": {
    "user_card": "<USER_CARD>",
    "client_name": "MyIntegration",
    "client_version": "1.0.0"
  },
  "id": "products-update-001"
}

Приклад відповіді (успіх)

Мокап: mockups/dictionaries/products/set.update/response.ok.json

{
  "ok": true,
  "result": {
    "item": {
      "...": "..."
    }
  },
  "meta": {
    "api_version": "0.1.0",
    "ts": "2026-01-26T12:00:00+00:00"
  },
  "id": "products-update-001"
}

Типові помилки

• NOT_FOUND — запис не знайдено.
• MISSING_DATA / EMPTY_DATA — немає полів для оновлення.