Свяжите внешний код поставщика с конкретным внутренним вариантом товара отдельной записью сопоставления. Не ищите замену только по похожему названию при каждом импорте. Один код у двух поставщиков может обозначать разные изделия, а одинаковое изделие может продаваться штукой и коробкой с разным количеством.

Внешний код живёт в своей области имён

СитуацияРешение импорта
Один код у разных поставщиковРазличать по источнику
Разные коды одного вариантаНесколько внешних связей
Один код для разных упаковокУточнить контракт прайса
Совпало только названиеПредложить кандидата
Внешний код изменил смыслПересмотреть связь с датой действия

Перед первым запуском согласуйте, что идентифицирует строка прайса: товар, модификацию, предложение или упаковку. Внутренняя карточка с несколькими размерами не является достаточной целью для обновления остатка конкретного размера. Сопоставление должно заканчиваться на том уровне, на котором источник передаёт цену и наличие.

Условная связь:
source_id + source_item_id -> внешний объект
supplier_sku -> исходный код для разбора
internal_variant_id -> конкретная модификация
pack_unit + pack_quantity -> смысл количества
valid_from -> начало действия связи
state -> подтверждено / конфликт / требует решения

Если источник гарантирует уникальность артикула только внутри своего аккаунта, включите этот аккаунт в ключ. PostgreSQL 18 позволяет задать UNIQUE для комбинации столбцов. Документация проверена 26 октября 2026 года. Ограничение закрепляет выбранный контракт в базе; оно не определяет за вас, какие внешние записи действительно являются одним товаром.

Неоднозначная строка не должна менять остаток

Загрузите прайс в промежуточный набор и получите отчёт: подтверждённые связи, новые коды, несколько кандидатов и конфликт упаковки. Только затем применяйте разрешённые строки. Выбор первой найденной карточки делает результат зависимым от порядка выдачи базы и скрывает ошибку до продажи неправильного варианта.

Для количества храните явную единицу. Условный пример: строка означает три коробки по десять штук, а каталог учитывает штуки. Преобразование допускается только после подтверждения такой упаковки; нельзя молча считать число 3 остатком 30 по предположению из названия. Цена также может относиться к другой единице.

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

Похожий код с ведущим нулём или буквой другого алфавита требует проверки по правилам поставщика. Храните исходное строковое значение. Удаление всех разделителей может слить две реальные позиции; отчёт о коллизиях нормализованного ключа нужен до включения такого преобразования.

Проверка включает повтор прайса

  1. Создать два тестовых источника с одинаковым внешним кодом.
  2. Добавить два размера и две упаковки одного изделия.
  3. Сформировать отчёт импорта без записи в каталог.
  4. Подтвердить однозначные связи и проверить применённые изменения.
  5. Повторить тот же прайс и отдельно изменить смысл одной строки.

Повтор файла должен давать объяснимый результат по той же версии данных. Если импорт разбит на задачи, связь не должна измениться посередине выпуска без выбранной политики. Фиксируйте версию сопоставления, чтобы поздний worker не применил остаток по новому решению, о котором исходный пакет ничего не знал.

Для исправления ошибочной связи сначала остановите её применение и найдите затронутые обновления. Восстановление прежних остатков и цен выполняйте по истории источника, не вычитанием случайной разницы. Для разбора достаточно искусственного прайса, схемы единиц и отчёта конфликтов; полный коммерческий каталог публиковать не требуется.

Проверенные источники