Торговля и Склад · 12 мин
1С и торговая площадка: как подключить интеграцию
Как подключить торговую площадку к 1С: выбор способа интеграции, настройка обмена товарами, заказами и остатками, проверка результата и типичные ошибки.
Подключение торговой площадки (маркетплейса) к 1С сводится к настройке автоматического обмена данными: товарами, ценами, остатками, заказами и статусами отгрузки. Без такой интеграции продавец вынужден вручную переносить заказы из личного кабинета маркетплейса в учётную систему, что при росте продаж приводит к ошибкам в остатках, просроченным отгрузкам и штрафам от площадки.
Существует несколько способов подключения: штатные механизмы обмена в типовых конфигурациях 1С, готовые модули интеграции от сторонних разработчиков, обмен через API маркетплейса силами собственного программиста и промежуточные сервисы-коннекторы. Выбор зависит от используемой конфигурации (Управление торговлей, Комплексная автоматизация, ERP, УНФ), количества площадок и объёма заказов.
Ниже разобраны критерии выбора способа, пошаговый порядок подключения, настройка обмена товарами и заказами, проверка корректности работы и типичные ошибки, которые допускают при первой интеграции.
Что нужно подготовить перед подключением
До начала настройки убедитесь, что у вас есть действующий аккаунт продавца на маркетплейсе и доступ к разделу для разработчиков или интеграций. Именно там формируются API-ключи (токены), без которых обмен данными невозможен. Ключи обычно разделяются по типам доступа: на чтение заказов, на изменение остатков и цен, на работу с отгрузками.
Со стороны 1С потребуется актуальная версия конфигурации и пользователь с правами администратора или с правами на настройку обмена данными. Если конфигурация сильно доработана или давно не обновлялась, сначала оцените совместимость модуля интеграции: многие готовые решения рассчитаны на типовые релизы и на изменённых конфигурациях требуют адаптации.
Также заранее приведите в порядок справочник номенклатуры: у каждого товара, который будет продаваться на площадке, должны быть заполнены наименование, артикул, штрихкод и цена. Маркетплейс сопоставляет ваши товары со своим каталогом именно по штрихкодам и артикулам, и ошибки в этих данных — самая частая причина сбоев при первой выгрузке.
Возможность создать API-ключ в личном кабинете площадки
Совместимость модуля интеграции с вашим релизом
Отсутствие дублей и пустых карточек у продаваемых товаров
Реальное наличие на складе совпадает с данными 1С
Выбор способа интеграции
Первый вариант — штатные механизмы типовых конфигураций. В ряде решений 1С есть встроенные или официально поставляемые расширения для работы с маркетплейсами. Это самый простой путь: функциональность уже протестирована, обновляется вместе с конфигурацией и не требует отдельной разработки. Ограничение — набор поддерживаемых площадок и сценариев фиксирован.
Второй вариант — готовые модули интеграции от сторонних разработчиков. Они подключаются как расширение или внешняя обработка и обычно поддерживают сразу несколько площадок, гибкие расписания обмена и дополнительные функции: управление ценами по правилам, работу с возвратами, печать этикеток. Такой модуль требует проверки совместимости и периодического обновления при изменении API площадки.
Третий вариант — собственная разработка через API маркетплейса. Он оправдан при нестандартных процессах: собственная логика ценообразования, работа с несколькими складами, интеграция с самописной учётной системой. Минус очевиден — нужна постоянная поддержка разработчика, потому что площадки регулярно меняют форматы запросов и версии API.
Сравнение способов подключения
Подходит для типовой конфигурации и одной-двух площадок; ограничен набором поддерживаемых сценариев
Оптимален для нескольких площадок и гибких настроек; требует проверки совместимости и обновлений
Для нестандартных процессов и самописных систем; требует постоянной поддержки программиста
Быстрый старт без доработки 1С; зависимость от внешнего сервиса и его ограничений по объёму данных
Получение доступа к API маркетплейса
Авторизуйтесь в личном кабинете продавца и найдите раздел, посвящённый интеграциям, API или работе с внешними системами. Создайте новый ключ доступа, выбрав необходимые разрешения. Для полноценной работы обычно нужны права на получение заказов, обновление остатков и цен, передачу статусов отгрузки и получение актов и отчётов.
Сохраните ключ в защищённом месте: он показывается полностью один раз или требует перевыпуска при утере. Не передавайте ключ в открытом виде по почте и не храните его в общедоступных файлах — с его помощью можно управлять вашим магазином на площадке, включая цены и остатки.
Установка и настройка модуля обмена в 1С
Если используется штатный механизм, перейдите в раздел настройки интеграций или обмена с маркетплейсами в вашей конфигурации и создайте новое подключение. Если приобретён сторонний модуль, установите его по инструкции поставщика: чаще всего это расширение конфигурации, подключаемое через «Администрирование — Печатные формы, отчеты и обработки — Расширения», либо внешняя обработка.
В настройках подключения укажите полученный API-ключ, выберите склад, с которого будут передаваться остатки, и организацию, от имени которой ведутся продажи. Затем настройте расписание обмена: для остатков разумный интервал — от 15 минут до часа в зависимости от оборачиваемости, для заказов — как можно чаще, чтобы не нарушать требования площадки по срокам сборки.
- 1Получите API-ключ в личном кабинете маркетплейса с нужными правами доступа
- 2Установите штатный или сторонний модуль интеграции в 1С
- 3Создайте подключение и введите API-ключ, укажите склад и организацию
- 4Выполните сопоставление товаров: загрузите каталог площадки и свяжите его с номенклатурой 1С
- 5Настройте расписание обмена остатками, ценами и заказами
- 6Проведите тестовый обмен и проверьте данные на стороне площадки
Сопоставление товаров и настройка обмена остатками
Ключевой этап — сопоставление номенклатуры 1С с карточками товаров на площадке. Загрузите в модуль каталог маркетплейса и свяжите каждую позицию с товаром в 1С по штрихкоду, артикулу или вручную. Несопоставленные товары не участвуют в обмене: их остатки не обновляются, а заказы по ним либо не загружаются, либо создаются с пустой номенклатурой.
Настройте правило передачи остатков: какой склад участвует, вычитать ли резервы, передавать ли остаток полностью или с ограничением. Передача резерва — частый источник проблем: если товар зарезервирован под заказы в 1С, но площадке передан полный остаток, возникнет продажа несуществующего товара и штраф за отмену заказа.
Цены настраиваются аналогично: выберите вид цен 1С, который будет источником, и при необходимости задайте формулу пересчёта (наценка, округление). Учтите, что площадка может удерживать комиссию, и цена передаётся без её учёта — финальную экономику проверяйте в отчётах.
Загрузка заказов и передача статусов
После настройки обмена заказы с площадки начинают загружаться в 1С автоматически по расписанию. Проверьте, каким документом они создаются в вашей конфигурации — обычно это «Заказ клиента» с отдельным соглашением или видом операции, чтобы продажи маркетплейса можно было выделить в отчётах.
Обратный обмен не менее важен: 1С должна передавать на площадку статусы — подтверждение сборки, передачу в доставку, отмену. Если статусы не передаются, заказ в личном кабинете «зависает», и площадка может расценить это как нарушение сроков. Проверьте цепочку целиком: загрузка заказа → сборка в 1С → передача статуса → отображение статуса в кабинете продавца.
Отдельно настройте обработку отмен и возвратов. Отменённый на площадке заказ должен отменяться и в 1С, иначе резерв под него останется висеть и исказит свободные остатки для других каналов продаж.
Проверка работы интеграции
После запуска не ограничивайтесь отсутствием ошибок в журнале — сверьте данные на обеих сторонах. Сравните остаток по нескольким товарам в 1С и в карточках на площадке, проверьте цены, создайте тестовый заказ (или дождитесь первого реального) и проследите его путь до передачи статуса.
В первые дни работы проверяйте журнал обмена ежедневно: типичные проблемы — отказ в авторизации из-за неверного ключа, превышение лимитов запросов API при слишком частом расписании, ошибки сопоставления по новым товарам, добавленным на площадку после первоначальной настройки.
Как проверить результат
Совпадает со свободным остатком в 1С
Расхождение, нулевой остаток при наличии товара
Заказ создан в 1С с товарами и покупателем
Заказ не загружается или создаётся с пустой номенклатурой
Статус в кабинете площадки меняется после сборки в 1С
Статус не обновляется, заказ «зависает»
Сеансы завершаются без ошибок
Ошибки авторизации, таймауты, отклонённые пакеты
Типичные ошибки при подключении
Большинство проблем первой интеграции связаны не с технической частью, а с данными и настройками. Ниже — ошибки, которые чаще всего приводят к сбоям и штрафам.
Отдельно отметим работу с несколькими складами и несколькими площадками. Если один товар продаётся на двух маркетплейсах, остаток нужно либо делить по правилам, либо передавать с запасом прочности — иначе одновременная продажа на двух площадках приведёт к отмене одного из заказов.
Как выбрать действие
Частые вопросы
Можно ли подключить маркетплейс к 1С без программиста?
Да, если конфигурация типовая и используется штатный механизм обмена или готовый модуль с понятной инструкцией. Программист понадобится при доработанной конфигурации, нестандартных правилах обмена или собственной интеграции по API.
Как часто нужно обновлять остатки на площадке?
Ориентируйтесь на скорость продаж: при высокой оборачиваемости — каждые 15–30 минут, при низкой достаточно одного-двух раз в час. Слишком частое расписание может упираться в лимиты запросов API площадки.
Что делать, если заказ загрузился в 1С без товаров?
Причина почти всегда в несопоставленной номенклатуре: товар есть на площадке, но не связан с карточкой в 1С. Откройте настройки сопоставления в модуле интеграции, найдите позицию по артикулу или штрихкоду и свяжите её с номенклатурой, затем повторите загрузку заказа.
Можно ли работать с несколькими маркетплейсами одновременно?
Да, большинство модулей интеграции поддерживают несколько подключений. Главные условия — корректное распределение остатков между площадками и раздельные настройки цен, так как комиссии и требования площадок различаются.
Что произойдёт, если API-ключ отзовут или он истечёт?
Обмен полностью остановится: остатки и цены перестанут обновляться, заказы не будут загружаться. Выпустите новый ключ в личном кабинете площадки и обновите его в настройках подключения в 1С, после чего проверьте журнал обмена.
Нужно ли тестировать интеграцию на копии базы?
Желательно. Тестовый запуск на копии позволяет проверить сопоставление товаров, создание заказов и передачу статусов без риска испортить реальные данные. На рабочей базе включайте обмен поэтапно: сначала выгрузка остатков, затем загрузка заказов.
Что важно запомнить
Подключение торговой площадки к 1С строится вокруг API-ключа, модуля обмена и корректного сопоставления товаров. Передавайте свободные остатки, проверяйте полный цикл заказа от загрузки до статуса и контролируйте журнал обмена в первые дни работы.