Ювелирные заказы Маркета: как связать УИН с фискальными данными отчёта
Как сверить ювелирные заказы Яндекс Маркета по УИН, артикулу и фискальному документу: параметры отчёта, типы полей и проверка импорта.
Содержание статьи
Отчёт jewelry-fiscal связывает заказ и товар с УИН и реквизитами фискального документа. Его полезно загружать отдельно от общего отчёта продаж, сохраняя идентификаторы без преобразования.
Справка проверена 14 октября 2026 года. Это дата редакционной проверки, а не запуска функции. Руководство относится к действующим аккаунтам на поддерживаемых рынках платформы.
Какой вопрос решает специальная выгрузка
В составе отчёта по заказам с ювелирными изделиями есть номер и статус заказа, дата создания, артикул, название и цена товара. Отдельные поля содержат УИН, номер накопителя, номер и дату фискального документа, номер смены. Эта связь позволяет разбирать конкретную продажу на уровне идентификаторов, а не искать изделие по похожему названию.
Сумма строки сама по себе недостаточна для сверки. Редакционная рекомендация — сначала выбрать конкретный заказ и сопоставить его товар с УИН, затем перейти к реквизитам документа. Если в заказе несколько изделий, проверяйте каждое, не сворачивая весь заказ в одну строку до разбора идентификаторов.
Как получить нужный срез
Метод POST v2/reports/jewelry-fiscal/generate принимает campaignId и границы периода dateFrom/dateTo включительно. Сохраните параметры рядом с результатом: одинаковое имя файла не доказывает, что выгрузки относятся к одному магазину и интервалу.
Можно получить XLSX либо ZIP с CSV или JSON. Ответ на запуск содержит reportId, а готовый файл получают через механизм проверки готовности и скачивания отчётов. Здесь важно не просто успешно скачать архив, а убедиться, что обработчик нашёл нужный лист и прочитал его поля.
Не превращайте идентификаторы в арифметические значения
В документации УИН, номер накопителя и номер смены имеют строковый тип. В настройках импорта сохраняйте это различие. Автоматическое превращение столбца в число может изменить представление идентификатора; формат ячейки после такого преобразования не всегда восстанавливает исходную запись.
Для первой загрузки оставьте исходный файл и сравните несколько строк до и после импорта посимвольно. Проверку стоит включить в приёмку учётной системы: номер заказа найден, артикул соответствует изделию, УИН сохранён целиком, фискальные реквизиты связаны с правильной строкой. Не удаляйте повтор без выяснения, что именно повторяется.
Как организовать разбор расхождений
Составьте отдельную очередь исключений: отсутствующий идентификатор, неизвестный артикул, несовпадающий документ. По каждой строке сохраняйте исходные значения и действие ответственного сотрудника. Пустое поле не следует заполнять значением соседнего изделия даже ради успешного завершения импорта.
Маркет предупреждает, что структура отчётов может меняться, включая колонки и название листа. Поэтому сопоставляйте поля по схеме, проверяйте наличие обязательных колонок и останавливайте загрузку при неожиданном формате. Этот отчёт помогает технической сверке; само наличие выгрузки не подтверждает выполнение всех обязанностей продавца по учёту ювелирных изделий.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы