Wildberries 9 сентября расширил API карточек товаров отдельным объектом documents. Через него передаются сведения о сертификатах, декларациях и других документах. Важная деталь для интеграций: при редактировании карточки необходимо отправлять также документы, которые должны остаться без изменений.

Что поддерживает новый объект

В объявлении перечислены сертификат и декларация соответствия, СГР, регистрационные удостоверения для медицинских изделий и лекарств, а также данные регистрации пестицидов и агрохимикатов. Объект доступен в создании, создании с присоединением, обновлении и получении списка карточек. Это позволяет использовать единый технический маршрут вместо хранения разных документов среди характеристик.

Площадка рекомендует переходить на documents. Для прежней передачи через characteristics действуют ограничения, связанные с тем, использовался ли уже новый объект или обновлённый блок документов в кабинете. Существующие документы площадка дублирует в новом объекте при чтении карточки. Поэтому первым шагом миграции должна быть выгрузка текущего состояния.

Основной риск — потерять неизменяемые сведения

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

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

Как подготовить реестр документов

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

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

Как принять обновление интеграции

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

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