====== Карты сопоставления номенклатуры ======

Поставщики называют товары по-своему: другое наименование, свой код, свой артикул, другая единица. «Карта сопоставления» запоминает, какой **нашей** позиции соответствует каждая строка номенклатуры поставщика. Один раз разобрали — дальше программа узнаёт эти строки сама: при импорте приходного документа из Excel позиции подставляются по карте.

Большую часть работы программа делает автоматически: ищет совпадения по коду, артикулу, штрихкоду и наименованию, подбирает похожие позиции, может спросить искусственный интеллект (ИИ). Окончательное решение всегда за оператором — он подтверждает предложенное или выбирает сам.

Настройка модуля (общие параметры, правила сверки, подключение ИИ, описание таблиц) — на отдельной странице для администратора: [[docs:settings:goods_maps_settings|Карты сопоставления номенклатуры: настройка (для администратора)]].

===== 1. Термины =====

^Термин ^Что означает ^
|**Карта** |Номенклатура одного источника: поставщика, покупателя или внешней системы. У каждого поставщика — своя карта.|
|**Строка карты** |Одна строка номенклатуры источника: код, артикул, наименование, единица, цена — и наша позиция, которая ей соответствует. Если поставщик поменял наименование или единицу, в карте появляется новая строка (старая остаётся — это история).|
|**Наша позиция** |Позиция из нашего справочника номенклатуры (окно склада).|
|**Статус** |Насколько строка разобрана: новая, предложено программой, подтверждено и т. д. (раздел 6).|
|**Уверенность, %** |Насколько программа (или ИИ) уверена, что строка и наша позиция — один и тот же товар.|
|**Кандидаты** |Наши позиции, похожие на строку, — из них выбирают, если программа не уверена.|
|**Сессия загрузки** |Одна загрузка строк в карту (вставка из Excel или импорт документа). По сессиям удобно разбирать то, что пришло за один раз.|

===== 2. Где открывается =====

  * Меню **Операции\Карты сопоставления номенклатуры**.
  * Из окна импорта документа из Excel — кнопкой открытия карты рядом с выбором карты (раздел 9).
  * Из окна «Варианты позиции в картах сопоставления» — кнопка **«Открыть карту»** (раздел 10).

Окно состоит из верхней панели и двух вкладок: **«Загрузка»** и **«Сопоставление»**.

==== Верхняя панель ====

^Элемент ^Что делает ^
|**Карта** |Выбор карты, с которой работаете. Всё остальное в окне относится к выбранной карте.|
|**Создать** / **Изменить** |Новая карта / карточка выбранной карты (раздел 3).|
|**Пересобрать по текущим настройкам...** |Заново подобрать позиции для строк, которые ещё не разбирал оператор (раздел 8).|
|**Кандидат от, %** |Нижний порог похожести: позиции с меньшей оценкой в кандидаты не попадают.|
|**Предлагать от, %** |Если лучший кандидат набрал не меньше этого (и заметно опережает второго), программа сама ставит его строке со статусом «Предложено».|
|**Искать и в картах** |Отметьте другие карты, если стоит искать и в них: когда другой поставщик уже подтвердил такой же товар под похожим наименованием, программа это учтёт. Ничего не отмечено — в других картах не ищет.|

Пороги и список карт запоминаются **для выбранной карты** и действуют и при загрузке, и при пересборке, и при импорте документов.

===== 3. Карта: создание и карточка =====

Кнопка **«Создать»** (или **«Изменить»** для выбранной карты) открывает карточку карты:

^Поле ^Что означает ^
|**Наименование** |Как карта называется в списках.|
|**Тип** |Поставщик, покупатель, внешняя система или прочее.|
|**Клиент** |Наш клиент, к которому относится карта (обычно поставщик). По нему при импорте документа карта выбирается сама. Кнопка **«Выбрать»** — окно клиентов (с Ctrl — окно поиска), **«Очистить»** — карта не связана с клиентом.|
|**Валюта цен** |В какой валюте поставщик указывает цены.|
|**Используется** |Снимите, чтобы карта не участвовала в поиске «в других картах» и не предлагалась в списках.|
|**Настройки загрузки** |Параметры именно этой карты. Заполняет администратор (см. страницу настройки); многое из окна (разметка колонок, пороги) программа записывает сюда сама.|

===== 4. Загрузка номенклатуры поставщика =====

Вкладка **«Загрузка»**. Так заносят в карту прайс-лист или каталог поставщика.

  - **Скопируйте таблицу в Excel** (выделите и нажмите Ctrl+C) — можно вместе со строкой заголовков.
  - **Нажмите «Вставить из буфера».** Если в окне уже есть строки, программа спросит: заменить их или добавить к ним. Пустые колонки (например, остатки объединённых ячеек Excel) убираются сами.
  - **Укажите, что в какой колонке** — в выпадающих списках над таблицей: Код, Артикул, Наименование, Ед. изм., Код ОКЕИ, Штрихкод, Производитель, Цена. Если в первой строке были заголовки, программа часто угадывает разметку сама. Заголовки колонок таблицы показывают назначенную роль.
  - **«Строка данных с»** — с какой строки начинаются данные (строки выше считаются заголовком и не загружаются).
  - **«Артикул из наименования»** — если у поставщика нет отдельной колонки артикула, а артикул написан в наименовании, задайте правило, как его оттуда взять. Кнопка **«Подобрать правило»** попробует правила сама и предложит лучшее. Что получилось, видно в колонке «Извлечено».
  - **Лишние строки** (итоги, разделы прайса, мусор) выделите (Ctrl / Shift + щелчок) и нажмите **«Удалить строки»** — в карту они не попадут.
  - **Нажмите «Загрузить и сопоставить».** В вопросе выберите **сессию**: «Новая сессия» (имя предлагается, его можно поправить) или **«Дозагрузить в: …»** — добавить строки в существующую сессию, например если прайс вставляете по частям с разных листов. Строки, которые уже есть в карте, не дублируются.

После загрузки внизу появится итог (сколько строк какого статуса), и окно перейдёт на вкладку «Сопоставление» с последней сессией.

>**Правило артикула и разметка колонок** запоминаются в карте. Если правило поменять, уже загруженные строки не пересчитываются — правило действует для следующих загрузок.

===== 5. Как программа подбирает позицию =====

Для каждой строки по порядку:

  - **Строка уже есть в карте** (тот же код, артикул, наименование, единица) — берётся её соответствие.
  - **Тот же код или артикул, но другое наименование / единица** — позиция берётся от прежней строки; если наименование сильно изменилось или сменилась единица, строка получает статус «Проверить» (поставщик мог поменять товар под старым кодом).
  - **Наша номенклатура** — совпадение кода поставщика с нашим артикулом, артикула, артикула внутри наименования, штрихкода или наименования. Если совпадение однозначное — статус «Предложено».
  - **Другие карты** (если отмечены в «Искать и в картах») — подтверждённые строки других поставщиков с таким же наименованием или артикулом.
  - **Похожие позиции** — если точного совпадения нет, программа ищет наши позиции с похожим наименованием (и наименованием в отмеченных картах) и запоминает их как **кандидатов** с оценкой похожести. Лучший кандидат ставится строке («Предложено»), только если его оценка не ниже «Предлагать от» и он заметно лучше второго. Иначе строка остаётся «Новой» с кандидатами.

Почему выбрано именно так, написано в **«Пояснении»** справа (например, «Совпало: артикул (95), наименование (90) — одна позиция» или «найден по наименованию карты "…"»).

===== 6. Статусы =====

^Статус ^Что означает ^Что делать ^
|**Новые** |Строку ещё не разбирали, позиции нет (могут быть кандидаты).|Выбрать позицию, посмотреть кандидатов или подобрать через ИИ.|
|**Предложено** |Позицию поставила программа или ИИ.|Проверить и подтвердить.|
|**Подтверждено** |Оператор подтвердил: это наша позиция.|Ничего — строка разобрана.|
|**Нет у нас** |Оператор подтвердил: такой позиции у нас нет.|Ничего — строка разобрана, повторно не предлагается.|
|**Проверить** |Программа нашла позицию, но есть сомнение: сменилось наименование или единица, разные правила указали на разные позиции, единица не подходит позиции.|Посмотреть пояснение, исправить или подтвердить.|
|**Не сопоставлять** |Строку сознательно не сопоставляем (услуга доставки, упаковка и т. п.).|—|

Ячейка «Статус» окрашена по статусу; строки «Подтверждено» — бледно-зелёные целиком.

===== 7. Разбор строк: вкладка «Сопоставление» =====

==== Что показывать ====

  * **Статус** — показать строки одного статуса или все.
  * **Сессии** — какие загрузки показывать. Щелчок по пункту — только эта сессия (список закрывается). **Ctrl + щелчок** — отметить несколько сессий. **«Все»** — все сессии карты, **«Последняя сессия»** — последняя загрузка. Если отметить все сессии или ни одной, остаётся «Все».

В таблице, кроме данных поставщика: наша позиция, статус, способ подбора, уверенность (полоса процента), **«№»** — номер строки в порядке загрузки (сортировка по нему показывает строки так, как они шли в прайсе), **«Сессии»** — в какие загрузки входит строка.

==== Одна строка ====

Справа — **«Пояснение»** (почему программа так решила) и **«Наша позиция»**. Кнопки:

^Кнопка ^Что делает ^
|**Выбрать позицию** |Открывает окно склада: найдите позицию и выберите её — она подставится строке и подтвердится.|
|**Выбрать через поиск** |То же через окно поиска склада.|
|**Кандидаты** |Окно поиска склада, где показаны только кандидаты строки. Колонки: **«Похожесть, %»** — оценка программы, **«ИИ, %»** — оценка ИИ (если строку разбирал ИИ), **«Найдено по»** — если кандидат найден по наименованию в другой карте. Выберите нужного кандидата.|
|**Подтвердить предложенную** |Принять позицию, которая стоит в строке.|
|**Нет у нас** |Подтвердить, что такой позиции у нас нет.|
|**Не сопоставлять** |Поставить статус «Не сопоставлять».|
|**Отменить выбор** |Вернуть то, что подбирала программа (отменить решение оператора).|
|**Подобрать через ИИ** |См. раздел 8.|

>**«Отменить выбор» и «Обнулить выбор» — разные вещи.** «Отменить» возвращает к автоподбору программы. «Обнулить» (внизу) убирает позицию и возвращает строку в «Новые»: она снова попадёт в пересборку и в подбор через ИИ. «Нет у нас», наоборот, — окончательный ответ.

**Двойной щелчок по строке** (или правая кнопка мыши) открывает меню с теми же действиями — в зависимости от строки: подтвердить, кандидаты, выбрать, перейти на позицию в окне склада, открыть информацию о позиции, отменить / обнулить выбор, применить к вариантам. **На колонке «Статус»** то же меню — выбор статуса: можно сразу поставить нужный (для отмеченных строк — всем отмеченным, с вопросом).

==== Много строк сразу ====

Отметьте строки (колонка отметки слева) и используйте кнопки внизу:

^Кнопка ^Что делает ^
|**Подтвердить отмеченные** |Подтвердить строки «Предложено» / «Проверить» с позицией. В вопросе можно включить порог: подтверждать только с уверенностью не ниже заданной.|
|**Применить к вариантам с тем же кодом** |Позицию текущей строки получают все другие строки карты с тем же кодом поставщика (нет кода — с тем же артикулом). Пример: товар с кодом 12345 приходил как «Саморез 4,2х25», потом как «Саморез ШСГД 4.2*25» и в упаковке «уп.». Подтвердили одну строку — применили ко всем. Коэффициент пересчёта единицы (BOX) у строки с другой единицей пересчитывается; если пересчитать нельзя, строка получает «Проверить».|
|**Обнулить выбор** |Отмеченные (или текущую) — в «Новые», без позиции.|
|**Удалить отмеченные...** |Доступна, только когда есть отмеченные строки. Если выбраны сессии, программа спросит: **«Убрать из выбранных сессий»** (строки уходят из этих сессий; строка, которой нет в других сессиях, удаляется из карты) или **«Удалить из карты совсем»**. Если отмечена вся карта — будет второй вопрос.|

===== 8. Подбор через ИИ и пересборка =====

==== Подобрать через ИИ ====

ИИ помогает там, где программа не уверена: сокращения, другой порядок слов, разная запись размеров. Он **выбирает только среди кандидатов** строки (наших позиций, похожих по наименованию), а не ищет по всей номенклатуре.

  - Отметьте строки или ничего не отмечайте — тогда берутся все видимые строки «Новые» и «Проверить». Строки, которые уже разбирал оператор, ИИ не отправляются.
  - Нажмите **«Подобрать через ИИ»**. В окне — сколько строк и запросов уйдёт и параметры (обычно менять не нужно): сколько кандидатов передать и вернуть с процентом, сколько строк в одном запросе, ниже какой уверенности ставить «Проверить», модель ИИ. Галка **«Запомнить для этой карты»** сохранит изменённые значения.
  - Подбор идёт в фоне — окном можно пользоваться. Ход виден под кнопкой; таблица обновляется после каждой порции. Кнопка на это время называется **«Остановить ИИ»**.
  - Результат — статус **«Предложено»** (или «Проверить», если ИИ не уверен) и пояснение «ИИ: 92%, …». Если ИИ решил, что подходящей позиции нет, строка получает «Предложено» без позиции. **Подтверждает по-прежнему оператор.**

Строки без кандидатов ИИ не отправляются — ему не из чего выбирать.

==== Пересобрать по текущим настройкам ====

Кнопка на верхней панели. Нужна, когда изменилось что-то, от чего зависит подбор: в справочник добавили позиции, изменили «Кандидат от» / «Предлагать от» или список «Искать и в картах», администратор поменял правила.

В вопросе отметьте, какие строки пересобрать: «Новые», «Предложено», «Проверить» (подобранные программой), выбранные ИИ. Если в таблице есть отмеченные строки, можно пересобрать **все** или **только отмеченные**. Строки считаются заново, и результат пишется как есть: строка может вернуться в «Новые», кандидаты заменяются. Галка **«Подобранные — только улучшать»** — не возвращать строки в «Новые» и не менять на худшее.

Подтверждённые, «Нет у нас», «Не сопоставлять» и выбранные вручную **не меняются никогда**.

===== 9. Импорт документа из Excel по карте =====

В окне импорта строк документа из Excel:

  * Включите **«По карте сопоставления:»** и выберите карту. По умолчанию выбирается карта, связанная с клиентом документа (если такая есть).
  * Кнопка настроек рядом — что брать из карты:
    * **Столбец Excel с кодом поставщика** — буква столбца, если код поставщика есть в файле;
    * брать ли **предложенные** программой (не подтверждённые) и с какой оценкой;
    * брать ли строки со статусом **«Проверить»**;
    * что делать со строкой, **не найденной** по карте: искать по ключевому полю импорта (как обычно) или пропустить;
    * **добавлять ненайденные строки в карту** — они появятся в окне сопоставления со статусом «Новые», в отдельной сессии.
  * Кнопка открытия карты — окно сопоставления на этой карте.

Найденные по карте строки импортируются нашей позицией; дальше импорт идёт как обычно. Количество и цена берутся из файла как есть — в единице поставщика пересчёт пока не делается.

>Настройки импорта по карте действуют, пока открыта программа.

===== 10. Варианты позиции в картах =====

Обратное направление: как **наша** позиция называется у поставщиков. Окно **«Варианты позиции в картах сопоставления»** открывается кнопкой из окна склада и из карточки позиции и показывает строки всех карт, сопоставленные с текущей позицией (при переходе по позициям обновляется само).

^Кнопка ^Что делает ^
|**Добавить в карту...** |Добавить строку поставщика вручную: карта, код, артикул, наименование, единица, BOX. Если такая строка уже есть и связана с другой позицией — программа спросит.|
|**Подтвердить** |Подтвердить сопоставление текущей строки с этой позицией.|
|**Отвязать** |Строка остаётся в карте, но без позиции, со статусом «Новые».|
|**Удалить отмеченные** |Удалить отмеченные строки из карт.|
|**Открыть карту** |Окно сопоставления на карте текущей строки.|

===== 11. Порядок работы — коротко =====

  - Создайте карту поставщика (раздел 3), свяжите с клиентом.
  - Загрузите его прайс (раздел 4) или просто импортируйте первый документ с галкой «добавлять ненайденные в карту» (раздел 9).
  - Разберите «Новые» и «Проверить»: подтвердите предложенное, выберите из кандидатов, при большом объёме — «Подобрать через ИИ», затем «Подтвердить отмеченные» с порогом.
  - Дальше импортируйте документы этого поставщика по карте — разобранные строки подставятся сами; новое добавится в карту и разбирается так же.