Что именно синхронизировать между 1С и маркетплейсом
Начните со списка сущностей, а не с технологии. У каждой есть направление, владелец и частота обмена. Если пропустить этот шаг, интеграция превращается в набор скриптов, которые перезаписывают друг друга.
Обычно набор один и тот же, из шести потоков. Какая сторона главная для каждого из них, решает бизнес. Разработчик только реализует решение.
- Товары и карточки: артикул, себестоимость и связь с номенклатурой обычно ведёт 1С, содержимое карточки (фото, описание) ведёт маркетплейс. Ключ обмена: связка товара в 1С с идентификатором на площадке.
- Цены: базовую цену считает 1С, акции и скидки может добавлять маркетплейс. Решите, идёт цена в одну сторону или вы читаете то, что реально показано покупателю.
- Остатки: из 1С на маркетплейс для схем, где товар лежит у вас. По складу маркетплейса данные идут в обратную сторону, для информации.
- Заказы: с маркетплейса в 1С как заказ покупателя или реализация, со статусом, который вы потом передаёте обратно.
- Возвраты и отмены: с маркетплейса в 1С, а товар возвращается на остаток или уходит в списание по состоянию.
- Деньги: выплаты и комиссии из отчётов маркетплейса для сверки в бухгалтерии. Самый забываемый поток, и именно о нём бухгалтер спросит первым.
FBS, FBO и другие схемы: что меняется для интеграции
Схема определяет, у кого лежит товар и, значит, что вам нужно синхронизировать. Названия и точные правила у Ozon и Wildberries отличаются, поэтому до проектирования сверьтесь с актуальными условиями в кабинете и официальной документацией.
При FBO товар лежит на складе маркетплейса, и остатки считает сама площадка. Свои остатки по таким товарам вы не отправляете. В 1С движение выглядит как отгрузка на маркетплейс и последующие продажи. При FBS (и rFBS у Ozon) товар остаётся у вас: вы отправляете актуальные остатки на площадку и сами обрабатываете каждый заказ: подтверждаете, собираете, передаёте. Здесь интеграция приносит основную пользу и здесь же случается большинство ошибок.
Часть продавцов совмещает схемы: что-то отгружено на склад площадки, что-то осталось у себя. Тогда у одного товара два остатка с разными владельцами. Сразу ведите их как отдельные остатки. Одно число на товар типичная причина овербукинга.
- FBO: остатки считает маркетплейс, 1С учитывает отгрузки на площадку и читает продажи для учёта и отчётности.
- FBS или rFBS: источник истины 1С, остатки отправляются на площадку, заказы забираются и обрабатываются у вас.
- Смешанная схема: два остатка на товар, по одному на схему, в одно число для площадки они не складываются.
- Схемы с доставкой силами продавца: поток заказов похож на FBS, но особенности каждой площадки смотрите в её документации.
Где источник истины для остатков
Для товара, который лежит у вас, источник истины 1С. Маркетплейс показывает то, что вы ему сообщили. Это очевидно, пока менеджер не поправит остаток в кабинете вручную, а следующая синхронизация тихо его перезапишет.
Помогают два правила. Первое: отправляйте доступный остаток, а не учётный. Вычтите резервы под принятые, но ещё не отгруженные заказы и держите небольшой страховой запас для товаров, которые продаются в нескольких каналах. Второе: запретите ручную правку остатков в кабинете, а если не получается, хотя бы обнаруживайте её.
Если вы продаёте с одной полки на своём сайте и на двух маркетплейсах, вопрос усложняется: кто резервирует первым? Выберите одно место, которое резервирует товар, обычно слой, принимающий все заказы, и пусть все каналы читают остаток оттуда. Иначе овербукинг случается, и потом его никто не может объяснить.
- Доступный остаток = остаток в 1С минус резервы по принятым заказам минус страховой запас.
- Одна точка резервирования на все каналы, а не по одной на каждый маркетплейс.
- Ручная правка в кабинете считается инцидентом, а не рабочей функцией.
- Полная сверка остатков по расписанию в дополнение к обновлениям по событиям.
Готовый модуль или свой сервис-посредник
Для 1С есть готовые модули и расширения под маркетплейсы, а также сервисы, которые стоят между 1С и кабинетами. Для типовой торговой конфигурации и обычного ассортимента это правильный первый шаг: дешевле стартовать, типовые особенности уже учтены. Перед покупкой проверьте три вещи: поддерживает ли модуль вашу конфигурацию и версию 1С, как быстро вендор реагирует на изменения API площадок, и видно ли, что и почему было отправлено.
Свой сервис между 1С и маркетплейсами оправдан, когда правила ваши. Например: нестандартная логика остатков по нескольким складам, комплекты и наборы, смешанные схемы, несколько юрлиц и кабинетов, данные, которым нужно пройти через вашу систему до 1С. В такой схеме 1С общается с одним стабильным интерфейсом вашего сервиса, а сервис с маркетплейсами. Изменение API площадки затрагивает одно место.
Технику общения такого сервиса с площадками (токены, лимиты, очереди, повторы) разбирает статья про интеграцию с API Wildberries и Ozon. Способы подключения самой 1С описаны в статье способы интеграции 1С.
- Готовый модуль: одна-две площадки, типовая конфигурация 1С, простой ассортимент, небольшая команда, нет необычных правил.
- Готовый модуль с оговорками: нужна функция, которой нет у вендора, или не виден журнал обмена.
- Свой сервис: несколько юрлиц или кабинетов, комплекты, смешанные схемы, своя логика резервов или нужна полная история отправленного.
- Свой сервис подходит и тогда, когда 1С старая или сильно доработана и трогать её лишний раз не хочется.
Заказы, возвраты и статусы: что ломается первым
Остатки видны всем. Настоящие проблемы прячутся в заказах и возвратах. Заказ должен попасть в 1С ровно один раз. Площадка может повторить уведомление, ваш запрос может оборваться по таймауту уже после того, как другая сторона его приняла, а воркер может перезапуститься посреди пачки. Без защиты получаются дубли заказов или потерянные.
Подход тот же, что в любой интеграции: хранить идентификатор заказа площадки, делать создание в 1С идемпотентным, держать очередь с повторами. Принципы разобраны в статьях идемпотентность API и повторные запросы и фоновые задачи и очереди на Go.
Возвратам нужны бизнес-правила, а не только код. Возвращённый товар может быть годным, повреждённым или утерянным. В каждом случае разное движение в 1С и разное влияние на остаток. Согласуйте правила со складом и бухгалтером до разработки, иначе интеграция аккуратно воспроизведёт беспорядок.
Почему остатки расходятся и как это поймать
Расхождения бывают даже в хорошей интеграции. Типичные причины: запрос упал и не был повторён, два обновления пришли в неверном порядке, кто-то поправил остаток вручную, продажа случилась в окне между двумя синхронизациями, возврат оформили в 1С с задержкой.
Относитесь к расхождениям как к норме и стройте обнаружение. Обновления по событиям держат цифры свежими. Полная сверка по расписанию находит то, что события пропустили. Она сравнивает, что считает 1С и что сообщает площадка, и выдаёт список различий, а не молча исправляет всё подряд.
Заранее решите, что система делает с разницей: исправляет сама в безопасном пороге или отдаёт человеку. Автоматически исправлять крупные расхождения опасно, ведь причиной может быть реальная потеря на складе.
- Логируйте каждое исходящее обновление остатка: товар, значение, время, ответ.
- Запускайте сверку по расписанию и сохраняйте результат как отчёт.
- Настройте оповещения: растущая очередь, повторяющиеся ошибки, долгая тишина от одной из сторон.
- Сделайте простой экран состояния: последняя успешная синхронизация, ошибки, товары с расхождением.
- После запуска у оповещений должен быть владелец. См. поддержку и мониторинг после запуска.
Когда своя интеграция вам не нужна
Сначала честно ответьте себе. Если вы продаёте несколько десятков позиций на одной площадке, обрабатываете пару заказов в день и ведёте остатки в таблице, отдельная интеграция преждевременна. Кабинет маркетплейса и ручная загрузка обойдутся дешевле проекта.
Свой сервис не нужен и тогда, когда 1С не главная система учёта. Если остатки на деле живут в складской программе или таблице, сначала наведите порядок там. Синхронизация двух ненадёжных источников даёт ненадёжный результат, только быстрее.
Готовый модуль или готовый сервис закрывает значительную долю случаев. Пишите своё, только если можете назвать правило, которое готовое решение выразить не способно.
Когда нужен подрядчик
Разработчика стоит нанимать, когда ручная работа уже стоит вам заказов: овербукинг, опоздания с отгрузкой, часы сверки каждую неделю. Второй признак: готовый модуль уже пробовали, и он не выразил ваши правила остатков или заказов.
Хороший подрядчик начинает с вопросов, а не с кода: какие потоки входят в объём, кто владелец каждого, какие схемы, сколько кабинетов и юрлиц, какая у вас версия и конфигурация 1С. Он должен показать, как будет вестись журнал обмена и как вы увидите ошибку. Если ответы приходят раньше вопросов, будьте осторожны.
Если это про вас, посмотрите нашу услугу по интеграциям. Полезно также почитать про обмен между 1С, CRM и ERP через API.