Материал блога
Как проверить выгрузку товаров из Shop-Script на маркетплейс: цены, остатки и ошибки

Товар есть в Shop-Script, но не появился на маркетплейсе. Или появился с неверной ценой, нулевым остатком либо чужой фотографией. В такой ситуации не стоит сразу запускать полную выгрузку повторно: сначала нужно определить, на каком этапе данные изменились или были отклонены. Ниже — порядок проверки для магазинов с интеграцией через модуль, API или промежуточный сервис. Конкретные поля и ограничения зависят от площадки и установленного подключения.
Зафиксируйте цепочку передачи данных
Нарисуйте фактический маршрут: карточка и SKU в Shop-Script → правила отбора → модуль выгрузки → очередь или промежуточный сервис → API площадки → карточка в кабинете продавца. Если обмен идёт через 1С или МойСклад, добавьте эту систему и укажите, кто является источником цены и количества. Не называйте Shop-Script главным источником по умолчанию: в реальном проекте цена может приходить из учётной системы, а доступный остаток рассчитываться отдельно.
Для каждого этапа запишите время последнего успешного обмена, идентификатор товара, результат запроса и доступный журнал. При отсутствии подробных логов включайте диагностику осторожно: она не должна раскрывать токены, персональные данные или секретные параметры.
Проверьте соответствие товара и варианта
Выберите один проблемный товар и два контрольных: успешно выгружаемый и недавно изменённый. Сверьте внутренний ID, артикул SKU, штрихкод при наличии, внешний идентификатор карточки и идентификатор предложения. Не путайте карточку товара с конкретным вариантом: один товар может содержать несколько SKU с разными ценами и остатками.
Особенно внимательно проверьте переименования, архивирование, повторный импорт и объединение вариантов. Если интеграция привязывает запись только к названию, изменение названия может привести к неправильному сопоставлению. Надёжнее использовать стабильный идентификатор, который поддерживает конкретный модуль и площадка, и хранить таблицу соответствий.
Разделите ошибку отбора и ошибку API
Если товар отсутствует в исходном пакете, ищите причину в правилах выгрузки: статус, категория, обязательные характеристики, доступность, фильтр по складу или исключение из канала продаж. Если запись присутствует в пакете, но не принята площадкой, исследуйте ответ API и статус обработки.
Успешный HTTP-ответ на отправку ещё не всегда означает публикацию карточки: некоторые площадки обрабатывают задания асинхронно и возвращают отдельный результат валидации. Сохраняйте идентификатор задания и проверяйте итоговый статус по документации используемой площадки. Не приписывайте всем маркетплейсам одинаковые статусы или сроки обработки.
Сверьте цену и правила округления
Определите, какая цена должна уйти в канал: базовая, цена конкретного SKU, специальная цена для площадки или рассчитанная с комиссией. Проверьте валюту, налоги, скидки, правила округления и минимальные ограничения, если они действительно применяются к выбранной интеграции.
Сравните три значения: в Shop-Script или учётной системе, в исходящем запросе и в кабинете маркетплейса. Если расхождение появилось до API, ошибка находится в расчёте или преобразовании данных. Если запрос корректен, но кабинет показывает другое значение, проверьте правила площадки, акционные механизмы и статус обновления. Не меняйте цену массово до выяснения источника расхождения.
Проверьте остатки по складам и резервам
Наличие в карточке магазина не обязательно равно количеству, доступному для продажи на внешней площадке. Уточните склад-источник, учёт резервов под заказы, отрицательные остатки, минимальный страховой запас и правило передачи нуля. Проверьте время последнего обновления и не перепутаны ли физический остаток и доступный.
Сценарий для теста: на выбранном SKU изменяется доступное количество в тестовой среде или в контролируемом диапазоне, запускается штатный обмен и сравниваются исходящее значение и результат площадки. На рабочем магазине не создавайте фиктивные продажи и не обнуляйте реальные остатки ради диагностики. Если есть риск двойной продажи, временно ограничьте проблемный канал согласованным способом.
Проверьте фотографии, категории и обязательные характеристики
Убедитесь, что в запрос попадают доступные изображения нужного SKU, а не случайная картинка другого варианта. Проверьте публичность URL изображений, корректность формата и ограничения конкретной площадки. Не считайте, что локально открывающийся файл доступен внешнему серверу: ссылки могут требовать авторизации или блокироваться защитой.
Проверьте сопоставление категорий и атрибутов. У маркетплейсов отличаются деревья категорий, обязательные характеристики и допустимые значения. Старое соответствие может стать неактуальным после изменения схемы площадки. Перед массовой отправкой сравните текущие официальные требования API с настройками модуля, особенно для размеров, брендов, идентификаторов и вариантов.
Разберите повторные отправки и защиту от дублей
Повторное нажатие «выгрузить всё» не устраняет причину отказа. Оно может создать очередь одинаковых операций, нагрузку на API и несогласованность статусов. Сначала выясните, поддерживает ли конкретный метод обновление по внешнему ID и как модуль отличает создание карточки от изменения существующей.
Проверьте журнал повторных попыток: какие запросы завершились ошибкой, какие были приняты, какие ещё обрабатываются. Для временных ошибок используйте ограниченные повторы с паузами согласно правилам API, а ошибки обязательных полей исправляйте до нового запроса. Не публикуйте токены в скриншотах диагностики.
Как проверить исправление без массовой выгрузки
Согласуйте тестовый набор из нескольких SKU с разными случаями: простой товар, товар с вариантами, нулевой остаток, изменённая цена и карточка с несколькими изображениями. Для каждого запишите ожидаемый результат, данные до отправки, ответ API и фактическое состояние в кабинете площадки.
После исправления выполните ограниченный обмен, проверьте отсутствие дублей и повторите проверку после очередного штатного цикла синхронизации. Если проблема связана с преобразованием данных, зафиксируйте тесты в модуле, чтобы следующее обновление не вернуло ошибку. Для таких задач может потребоваться программирование и доработка интернет-магазина; регулярный контроль интеграций удобно включить в техническую поддержку сайта.
Что записать в итоговый отчёт
Зафиксируйте конкретные SKU, время и направление обмена, этап появления ошибки, причину, изменение настройки или кода и результат контрольного теста. Отдельно отметьте оставшиеся ограничения: задержки обработки, неполное сопоставление категорий, особенности резервов и операции, которые нельзя автоматизировать без дополнительной разработки.
Перед расширением интеграции оцените структуру каталога и рабочие процессы магазина. Примеры направлений работ доступны в портфолио доработок Quadro Design. Вывод: надёжность выгрузки определяется не числом успешных запусков, а проверяемым соответствием товара, SKU, цены, остатка и статуса обработки на каждом этапе. Исправляйте найденную причину и подтверждайте результат ограниченной выборкой, прежде чем запускать массовую синхронизацию.