Загрузка сертификатов в OZON из 1С

Внешняя обработка загружает сертификаты и декларации из типового учета 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.

Как выглядит рабочий сценарий

1. Введите Client-Id и Api-Key из раздела Seller API кабинета Ozon.
2. Нажмите "Проверить подключение" и затем "Сохранить подключение".
3. Выберите тип соответствия: технический регламент ТС, технический регламент РФ или ГОСТ.
4. Нажмите "Заполнить товары". При необходимости включите отбор по положительному остатку.
5. Проверьте таблицу. Номенклатура и файлы сертификата открываются по ссылке.
6. Оставьте отметку "Отправить" только у нужных строк.
7. Сначала выполните тестовый прогон. В этом режиме обработка проверит готовность, но ничего не изменит в Ozon.
8. Для боевой операции снимите тестовый режим и нажмите "Отправить через API".
9. Проверьте колонку результата и журнал операций.

Что видно до отправки

Каждая строка получает понятный план и пояснение. Если документ уже связан с товаром, строка показывает "Уже привязан" и не требует действий. Если документ есть в кабинете, но связи с товаром нет, будет предложено "Привязать". Если документа еще нет, но в 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С:Управление торговлей 11.5 есть собственная публикация разрешительных документов на Ozon: обработка "Управление продажами на Ozon", сопоставление типов сертификатов и отдельные статусы публикации для документа и его скана. Там же работает регламентное задание, которое обновляет статус сертификата номенклатуры по данным Росаккредитации. Если типовая интеграция с Ozon у вас развернута и настроена, документы удобнее возить ею.

Эта обработка нужна в другой ситуации:

• релиз конфигурации старше того, в котором типовая публикация документов появилась, а обновляться сейчас нельзя;
• типовая интеграция с Ozon не разворачивалась, и разворачивать ее целиком ради одних документов дорого;
• нужен разовый контролируемый прогон по списку товаров, с предварительным просмотром каждой строки и тестовым режимом, без включения постоянного обмена;
• нужен отчет о товарах без действующих документов, который считается по данным 1С и не требует ключей Ozon.

Отдельно про соседние площадки: публикации разрешительных документов для Яндекс Маркета и Wildberries в типовой конфигурации нет, под них у меня выложены отдельные обработки.

Важные ограничения

• Если присоединенные файлы вынесены во внешний том и недоступны серверному сеансу 1С, обработка увидит карточку сертификата, но не сможет получить скан.
• Самописные справочники сертификатов не поддерживаются. Для них требуется адаптация источника данных.
• Обработка не получает и не проверяет юридическую применимость сертификата к конкретной категории товара.
• Изменения выполняются только в кабинете Ozon. Данные сертификатов в 1С обработка не переписывает.

Безопасность подключения

Api-Key передается только на сервер Ozon. В форме он отображается как пароль. Настройки не сохраняются автоматически: для этого есть отдельная команда. Проверка подключения выполняется запросом чтения и не создает документы.

Проверка полного цикла

Полный маршрут проверен на реальном товаре и действующем сертификате в тестовой УТ 11.5. Сначала выполнен тестовый прогон, затем боевая отправка одной отмеченной строки. Результат: создан один документ, привязан один товар, ошибок ноль. Повторное заполнение определило связь как уже существующую.

Что входит в поставку

• внешняя обработка .epf;
• встроенная HTML-справка по заполнению сертификатов в УТ и работе с Ozon;
• исходный код обработки открыт.