Ошибки обмена между 1С и маркетплейсом

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

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

Какие данные передаются между 1С и маркетплейсом

Интеграция может передавать сведения о товарах, ценах и остатках, загружать заказы и возвращать данные об их обработке. Доступный состав операций зависит от решения и схемы работы: например, при продаже со склада продавца важно сопоставить склад 1С со складом площадки.

Не всегда маркетплейс сам отправляет заказ в 1С. В одних интеграциях система регулярно запрашивает новые данные у площадки, в других используется иной механизм. Поэтому при диагностике следует учитывать, как именно устроено подключение.

Для сверки используйте официальные инструкции: интеграция с 1С и API Яндекс Маркета, подключение к WB API и документацию Ozon Seller API.

Частые причины ошибки обмена

Неверное сопоставление товаров и складов

В 1С и личном кабинете площадки товар может иметь разные артикулы и идентификаторы. Если соответствие не настроено или указано неверно, система не сможет связать позиции при обмене. Аналогичная проблема возникает, когда склад учётной системы не сопоставлен со складом маркетплейса.

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

Недействительный ключ или недостаточные права

Запросы могут отклоняться, если ключ доступа истёк, отозван, скопирован с ошибкой или не имеет нужных прав. Правила зависят от площадки и способа авторизации. Например, Wildberries указывает срок действия токена в 180 дней и рекомендует проверять его актуальность и доступы. В 1С также могут появляться настройки для замены ключа после изменения требований площадки — это отражено, например, в описании обновлений 1С:Управление торговлей.

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

Ошибки в данных или статусах

Площадка может отклонить запрос из-за обязательного незаполненного поля, неподходящего формата, недопустимого значения или попытки изменить заказ в статусе, для которого операция уже недоступна. Например, справка Яндекс Маркета относит некорректное содержимое запроса к ошибкам 400 Bad Request и рекомендует ориентироваться на описание в ответе API.

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

Несовпадение остатков

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

Не считайте любое расхождение доказательством сбоя API: сначала проверьте, какие остатки передаёт 1С и какие значения площадка приняла.

Обновление интеграции или временная недоступность API

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

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

1. Определите, какая операция не выполнилась

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

2. Проверьте журнал обмена и журнал регистрации 1С

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

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

3. Сопоставьте ответ API с настройками

Условно ошибки можно разбирать так:

  • 400 — проверьте состав и формат запроса, данные товара или допустимость операции;
  • 401 или 403 — проверьте авторизацию, срок действия ключа и выданные права;
  • 404 — проверьте адрес метода, идентификатор товара, склада или кабинета;
  • 429 — проверьте частоту запросов и настройки повторных попыток;
  • 5xx — проверьте состояние сервиса площадки и повторите запрос позже, если это допускает интеграция.

Коды и их смысл могут различаться у разных площадок. Например, в справке Яндекс Маркета по ошибкам API приведены значения кодов и рекомендации для конкретных методов. Используйте также документацию своей площадки и текст ответа сервера.

4. Проверьте настройки подключения

Убедитесь, что выбран правильный кабинет, актуальны ключи и права доступа, а идентификаторы складов указаны верно. Проверьте расписание обмена, подключение к интернету, сертификаты и настройки прокси или межсетевого экрана, если они используются.

В типовых конфигурациях 1С путь к настройкам зависит от версии и продукта. Для Ozon и других площадок 1С публикует информацию об изменениях интеграции в материалах к обновлениям, например в разделе обновлений 1С:Управление торговлей.

5. Повторяйте операцию после проверки результата

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

Сначала сверяйте состояние в личном кабинете площадки или через предусмотренную интеграцией проверку. Не очищайте вручную очереди и временные данные, пока не понятно, как это повлияет на повторную отправку и идентификаторы операций.

Если заказ не меняет статус

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

Если запрос отклонён, используйте текст ответа API и инструкцию площадки для соответствующей модели продаж. Если операция выполнена в кабинете, но не отразилась в 1С, проверьте следующий цикл загрузки и сопоставление внешнего идентификатора заказа.

Если не загружаются отчёты о продажах

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

Если площадка уже сформировала отчёт, а в 1С его нет, проверьте настройки загрузки, выбранный кабинет и период. Затем изучите журнал обмена и инструкцию к конкретной конфигурации.

Как снизить риск повторных сбоев

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

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

Для диагностики и настройки интеграции можно обратиться в службу поддержки интеграций.

Форма обратной связи

Мы очень рады, что вы решили связаться с нами. Пожалуйста, заполните форму и мы обязательно перезвоним. Обычно мы перезваниваем в течение одного рабочего дня.

    X
    СВЯЖИТЕСЬ С НАМИ