Документы на товары в Маркете: как различать проверку, истечение срока и отзыв
Как организовать контроль ACTIVE, VALIDATING, WAITING_FIXES, EXPIRED и REVOKED в реестре документов на товары Яндекс Маркета.
Содержание статьи
Загруженный документ не обязательно действует: в реестре Маркета отдельно отражаются проверка, необходимость исправлений, истечение срока и отзыв. Для контроля ассортимента эти состояния требуют разных очередей работы.
Какие состояния стоит разделить
Метод получения документов возвращает ACTIVE, NOT_FOUND, VALIDATING, WAITING_FIXES, EXPIRED и REVOKED. В документации они означают действующий документ, отсутствие в реестре, проверку, ожидание исправлений, истёкший срок и отзыв. В карточке документа также доступны даты activeFromDate и activeToDate. Эти сведения позволяют построить наблюдение за состоянием реестра.
Практический смысл разделения — направить работу подходящему сотруднику. Исправление реквизитов и получение нового документа после окончания срока не являются одной операцией. Не объединяйте все состояния в красную отметку «ошибка загрузки». При такой схеме менеджер может повторять передачу прежних данных, хотя причина находится вне технического обмена.
Как собрать контрольный список
Создайте внутреннюю строку для каждого документа: идентификатор площадки, номер, тип, состояние, период действия и ответственный. Номер и технический идентификатор храните раздельно. Это поможет найти исходный документ по реквизитам и одновременно однозначно связать его с записью API, не полагаясь на похожее название файла.
Чтение поддерживает фильтры по идентификаторам, номерам, типам и статусам. Для полного обзора нужно пройти страницы результатов. Механику пакетного сопровождения разбирает материал об API документов. В ежедневном контроле важнее не размер пакета, а отсутствие пропущенных записей и назначенный владелец каждой проблемы. Пустую выборку проверяйте отдельно от полностью благополучного реестра.
Что делать с проверкой и отсутствием в реестре
VALIDATING фиксируйте как незавершённую проверку, а не как действующий документ. Для NOT_FOUND сначала сверяйте номер, тип и исходные сведения. Не превращайте технический статус площадки в самостоятельное юридическое заключение: разбор причин и применимости документа к продукции требует проверки самого документа и соответствующего реестра.
WAITING_FIXES удобно выделить в очередь уточнений. Записывайте, что именно проверил сотрудник, какие данные исправлены и когда выполнено повторное чтение. Закрывать внутреннюю задачу лучше по подтверждённому новому состоянию, а не по отметке «отправлено». Повторная отправка без изменения причины только создаёт видимость движения и затрудняет контроль.
Как заранее заметить истечение срока
Для документов с датой окончания настройте внутреннее напоминание с запасом, который соответствует вашему процессу получения и проверки документов. Это организационный срок магазина, а не установленный Маркетом универсальный период. Проверяйте отдельно документы без ожидаемой даты: пустое поле нельзя автоматически считать бессрочным разрешением для любого товара.
При EXPIRED или REVOKED определите затронутый ассортимент и передайте вопрос ответственному за документы. Связь документальных сведений с товарными данными обсуждается в обзоре документов и идентификации продукции. Не заменяйте реквизиты случайным действующим документом от похожей позиции. Основа руководства — официальная документация, проверенная 22 октября 2026 года; практические очереди предложены редакцией.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы