Для B2B-заказа на Яндекс Маркете можно получить через API сведения о готовности документов, их номерах и датах. Такой реестр помогает бухгалтерии видеть, какие доставленные продажи ещё требуют внимания. Редакция проверила техническую инструкцию 12 октября 2026 года; она не заменяет определение требуемого комплекта документов бухгалтером.

Отберите подходящие заказы

Информация доступна после перехода заказа в DELIVERED. Метод использует идентификаторы магазина campaignId и заказа orderId и поддерживает FBY, FBS, Экспресс и DBS. Если отправление ещё в дороге, преждевременная проверка не доказывает отсутствие документов по завершённой продаже.

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

Различайте ответ API и готовность документа

Для отдельного документа предусмотрены состояния READY и NOT_READY, номер и дата создания. В ответе описаны УПД, УКД, товарная накладная, счёт-фактура и корректировочный счёт-фактура. Успешное выполнение запроса не означает, что каждый возможный вид документа уже готов или требуется именно этой продаже.

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

Не смешивайте продажу и услуги площадки

Этот метод возвращает информацию по заказу, а не файлы всех закрывающих документов договора. Отдельно существует переход документов услуг Маркета на УПД-1. У этих процессов разные объекты сверки: покупательская продажа и расчёты с площадкой.

Редакционная рекомендация — вести разные очереди получения и проверки, связывая их только необходимыми учётными идентификаторами. Иначе изменение формата документов услуг может ошибочно создать предупреждения о недостающих документах по товарам, хотя причина находится в другом процессе.

Организуйте повторную проверку

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

Условный пример: заказ доставлен, запрос выполнен успешно, а нужный документ пока NOT_READY. Задача остаётся в очереди; создавать повторную реализацию не требуется. Когда документ готов, сотрудник продолжает ту же запись, сохраняя историю проверки. Завершение означает согласованную связь заказа и документа, а не просто отсутствие технической ошибки на экране.