arts/sn/recommendation

Метод возвращает рекомендованные значения для одного типа серии: приложение вызывает его при открытии формы ввода каждого типа и передаёт значения, введённые для строки ранее. Список серий целиком, всеми типами сразу, отдаёт arts/sn.

Метод

Условия вызова

Приложение вызывает метод в документах при одновременном соблюдении условий:

• товар серийный — требует ввода серии;
• в настройках шаблона опция Поиск серии установлена в значение Сервер;
• в настройках шаблона включена настройка Онлайн-рекомендация серий;
• в настройках шаблона включена настройка Рекомендация отдельных типов серий — поднастройка предыдущей.

Настройка Рекомендация отдельных типов серий приходит на устройство с объектом template в поле is_get_sn_list_by_type_from_server. Когда она выключена, метод не вызывается: рекомендации приходят сразу по всем типам серий методом arts/sn.

Запрос

Параметры

Тело

Пример запроса

http://192.168.1.1/DM/hs/DataMobileExch/api/arts/sn/recommendation?device_id=1&username=Администратор

{
    "doc_id": "doc_out_id_1",
    "operation_type": 0,
    "sn_type_id": "sn_type_id_1",
    "ai_code": 10,
    "detail": {
        "art": {
            "id": "art_id_1",
            ...
        },
        ...
        "sn": "[\"123321\",\"01.05.25\",\"09.05.25\"]",
        "sn_full": "[\"123321\",\"01.05.25\",\"09.05.25\"]",
        ...
    }
}

Ответ

Метод возвращает массив строк — значения серии для запрошенного типа.

Пример ответа

[
  "00000001",
  "10.02.21",
  "02.04.15"
]

Порядок вызовов

Товар требует ввода трёх типов серий — [10], [11] и [17]. Приложение обращается к методу перед каждым из них и передаёт в detail то, что уже введено:

Связанные статьи

• arts/sn — получение списка серий по товару всеми типами сразу
• arts/sn_types — загрузка справочника типов серий
• template — объект шаблона документа с настройками онлайн-рекомендации