Как использовать теги доноров в выгрузках

В Desktop поддерживаются теги для автомобилей-доноров. Эта функция позволяет маркировать машины (например: «VIP», «срочно», «под ремонт», «не для экспорта») и гибко управлять выгрузкой их деталей на маркетплейсы (Авито, Дром, Ozon и др.) через сервис ExportAPI.

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

Шаг 1. Разметка доноров тегами

Перед тем как настраивать выгрузку, необходимо разметить автомобили тегами в интерфейсе программы.

1.1. Добавление тегов в карточке донора

1. Откройте нужного донора в программе.
2. В поле редактирования тегов введите название тега и нажмите Добавить.
3. Правила и ограничения системы:
   • Каждому донору можно добавить не более 30 тегов.
   • Длина одного тега ограничена 50 символами.
   • Пробелы в начале/конце тега обрезаются автоматически.
   • Система автоматически удаляет дубликаты без учёта регистра (теги VIP и vip будут считаться одним тегом).

1.2. Массовое добавление тегов (Bulk Edit)

Если вам нужно пометить тегом сразу много автомобилей:

1. Выделите нужные машины в списке доноров.
2. Нажмите кнопку массового редактирования.
3. Введите новые теги.
4. Важная особенность: При массовом сохранении новые теги будут добавлены к уже существующим тегам машин. Старые теги не удалятся и не затрутся.

1.3. Отображение тегов в системе

• На панели информации о доноре (DonorInfoWindow) выводится отдельный визуальный блок «ТЕГИ», где отображаются все назначенные метки.
• В табличном списке доноров можно вывести колонку «Теги» (через настройку колонок). Это позволяет искать и фильтровать машины прямо в рабочей сетке.

Шаг 2. Фильтр по тегам в датасете выгрузки

Синхронизация с маркетплейсами строится на базе Датасетов (Datasets), которые определяют, какие именно товары попадут в выгрузку. Поскольку теги доноров сохраняются в базе данных в формате JSON внутри поля extended, для фильтрации по ним используется поле «Свой SQL код» (Custom SQL Code) в настройках динамического датасета.

Как настроить фильтрацию:

1. Перейдите в раздел Экспорт ➡️ Настройка шаблонов/датасетов.
2. Создайте или откройте для редактирования Динамический датасет нужного типа (б/у запчасти, шины или диски).
3. В окне конструктора фильтров найдите поле «Свой SQL код».
4. Вставьте один из готовых SQL-рецептов ниже, заменив название тега на ваше.

Готовые SQL-фильтры

При составлении SQL-кода используется системный алиас car для таблицы автомобилей-доноров (ListAuto).

Рецепт 1. Выгружать детали ТОЛЬКО от доноров с определённым тегом

Используйте этот код, если хотите продавать на площадке запчасти только с проверенных/определённых машин (например, с тегом на экспорт):

car.extended IS NOT NULL 
AND ISJSON(car.extended) = 1 
AND EXISTS (
    SELECT 1 
    FROM OPENJSON(car.extended, '$.Tags') 
    WHERE [value] = N'на экспорт'
)

Рецепт 2. ИСКЛЮЧИТЬ из выгрузки детали от доноров с определённым тегом

Используйте этот код, чтобы не выгружать детали с проблемных машин (например, помеченных тегом утиль или под ремонт):

car.extended IS NULL 
OR ISJSON(car.extended) = 0 
OR NOT EXISTS (
    SELECT 1 
    FROM OPENJSON(car.extended, '$.Tags') 
    WHERE [value] = N'утиль'
)

Рецепт 3. Выгружать детали, если у донора есть ХОТЯ БЫ ОДИН из тегов (Логика «ИЛИ»)

Подходит для объединения нескольких разрешённых категорий доноров (например, VIP или Германия):

car.extended IS NOT NULL 
AND ISJSON(car.extended) = 1 
AND EXISTS (
    SELECT 1 
    FROM OPENJSON(car.extended, '$.Tags') 
    WHERE [value] IN (N'VIP', N'Германия')
)

Рецепт 4. Выгружать детали, если у донора есть ВСЕ указанные теги (Логика «И»)

Подходит для максимально точечного отбора (например, машина должна быть одновременно и на экспорт, и разобрана):

car.extended IS NOT NULL 
AND ISJSON(car.extended) = 1 
AND (
    SELECT COUNT(*) 
    FROM OPENJSON(car.extended, '$.Tags') 
    WHERE [value] IN (N'на экспорт', N'разобрана')
) = 2

(Цифра 2 в конце означает количество обязательных тегов, перечисленных в скобках).

Шаг 3. Запуск и проверка выгрузки

После того как вы настроили SQL-фильтр в датасете:

1. Проверьте количество товаров: Нажмите кнопку «Пересчитать» или «Предварительный просмотр» в настройках датасета. Система должна показать отфильтрованный список запчастей, исключив или включив товары согласно тегам их доноров.
2. Привязка к шаблону: Убедитесь, что ваш датасет привязан к активному шаблону выгрузки (например, Avito API или Ozon API).
3. Запуск синхронизации:
   • Синхронизация запустится автоматически по вашему обычному расписанию (настраивается в свойствах шаблона экспорта).
   • Вы также можете запустить синхронизацию вручную, выбрав шаблон экспорта и нажав «Передать остатки» (Post Stock) или «Выполнить выгрузку» (Post).
4. Мониторинг: Все логи выполнения и возможные ошибки со стороны маркетплейсов будут записаны в историю выгрузок шаблона.