Внешняя обработка загружает сертификаты и декларации из типового учета 1С в Ozon через Seller API, привязывает документы к товарам и показывает результат по каждой строке.
Решение рассчитано на 1С:Управление торговлей 11.5, 1С:Комплексная автоматизация 2.5 и 1С:ERP 2.5. Конфигурация не изменяется, расширение не устанавливается. Обработка использует типовой справочник сертификатов номенклатуры, области действия и присоединенные файлы.
Что делает обработка
- проверяет Client-Id и Api-Key безопасным запросом чтения;
- сохраняет настройки подключения для текущего пользователя базы только по отдельной команде;
- заполняет товары по данным 1С, при необходимости только с положительным остатком;
- учитывает срок действия документа и наличие присоединенного файла;
- сопоставляет артикул 1С с offer_id товара Ozon;
- показывает документы, которые уже находятся в кабинете;
- различает действия "Уже привязан", "Привязать", "Загрузить и привязать", "Не отправлять";
- загружает скан документа в Base64 и затем привязывает документ к отмеченным товарам;
- не создает повторно документ, если он уже найден в Ozon;
- обновляет результат только по отправленным строкам и не сбрасывает остальные отметки;
- ведет журнал с результатом каждого этапа и итоговыми счетчиками;
- формирует отдельный табличный документ "Товары без сертификатов" без подключения к Ozon.
Как выглядит рабочий сценарий
- Введите Client-Id и Api-Key из раздела Seller API кабинета Ozon.
- Нажмите "Проверить подключение" и затем "Сохранить подключение".
- Выберите тип соответствия: технический регламент ТС, технический регламент РФ или ГОСТ.
- Нажмите "Заполнить товары". При необходимости включите отбор по положительному остатку.
- Проверьте таблицу. Номенклатура и файлы сертификата открываются по ссылке.
- Оставьте отметку "Отправить" только у нужных строк.
- Сначала выполните тестовый прогон. В этом режиме обработка проверит готовность, но ничего не изменит в Ozon.
- Для боевой операции снимите тестовый режим и нажмите "Отправить через API".
- Проверьте колонку результата и журнал операций.
Что видно до отправки
Каждая строка получает понятный план и пояснение. Если документ уже связан с товаром, строка показывает "Уже привязан" и не требует действий. Если документ есть в кабинете, но связи с товаром нет, будет предложено "Привязать". Если документа еще нет, но в 1С доступен файл, будет предложено "Загрузить и привязать".
Строки без артикула, без доступного скана, с истекшим документом или с отсутствующим обязательным реквизитом не отмечаются к отправке. Причина выводится рядом с товаром. Это позволяет исправлять исходные данные в 1С до обращения к API.
Тестовый режим
При открытии формы тестовый режим включен. Обработка читает кабинет, выполняет сопоставление, проверяет документ и файл, но не вызывает методы создания и привязки. При снятии режима пользователь получает отдельное предупреждение о том, что отмеченные строки будут отправлены в Ozon.
Рекомендуемый первый запуск - один товар с действующим сертификатом. После успешной отправки строка получает результат "Отправлено", журнал показывает количество загруженных документов, привязанных товаров и ошибок. При повторном заполнении готовая связь определяется как "Уже привязан".
Товары без сертификатов
Отдельная команда строит табличный документ по данным 1С и не требует ключей кабинета. В отчете видно количество товаров с артикулом, число товаров с действующим разрешительным документом и список позиций под риском. Отчет предназначен для подготовки каталога и передачи ответственному за сертификаты.
Обработка не определяет юридическую обязанность сертификации конкретной категории. Она показывает наличие или отсутствие действующего документа в учетной системе. Решение о применимости документа принимает ответственный специалист.
Поддерживаемые документы
Реализована работа с сертификатами соответствия, декларациями о соответствии, свидетельствами о государственной регистрации и отказными письмами. Тип документа 1С преобразуется в код Ozon. Для видов, у которых API требует дополнительные параметры, обработка проверяет их до отправки и выводит понятную причину неготовности.
Для отказного письма требуется ссылка на реестр. Для свидетельства о государственной регистрации передается обязательный тип продукции. Номер СГР нормализуется перед проверкой формата.
Требования к данным
- артикул номенклатуры в 1С должен совпадать с offer_id товара Ozon;
- сертификат должен быть связан с номенклатурой через типовой механизм области действия;
- для ограниченного по сроку документа должны быть заполнены даты;
- скан должен быть доступен в присоединенных файлах базы;
- поддерживаются PDF, JPG, JPEG и PNG размером не более 10 МБ;
- для обращения к Ozon нужны Client-Id и Api-Key с подходящими правами Seller API.
Важные ограничения
- Если присоединенные файлы вынесены во внешний том и недоступны серверному сеансу 1С, обработка увидит карточку сертификата, но не сможет получить скан.
- Самописные справочники сертификатов не поддерживаются. Для них требуется адаптация источника данных.
- Обработка не получает и не проверяет юридическую применимость сертификата к конкретной категории товара.
- Изменения выполняются только в кабинете Ozon. Данные сертификатов в 1С обработка не переписывает.
Безопасность подключения
Api-Key передается только на сервер Ozon. В форме он отображается как пароль. Настройки не сохраняются автоматически: для этого есть отдельная команда. Проверка подключения выполняется запросом чтения и не создает документы.
Проверка полного цикла
Полный маршрут проверен на реальном товаре и действующем сертификате в тестовой УТ 11.5. Сначала выполнен тестовый прогон, затем боевая отправка одной отмеченной строки. Результат: создан один документ, привязан один товар, ошибок ноль. Повторное заполнение определило связь как уже существующую.
Что входит в поставку
- внешняя обработка
.epf; - встроенная HTML-справка по заполнению сертификатов в УТ и работе с Ozon;
- исходный код обработки открыт.
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.22.67
Вступайте в нашу телеграмм-группу Инфостарт