Интеграция 1С с маркетплейсами: архитектура данных и приёмочный план

Заказы поступают, товары отгружаются, а обмен всё равно приходится поправлять руками: на площадке остался лишний товар, цена вернулась к прежней, один заказ появился в 1С дважды. Разберите каждый поток отдельно: карточки, остатки, цены, заказы и расчёты. Для каждого найдите источник, ключ сопоставления и способ проверки результата.
Этот план настройки и приёмки рассчитан на руководителя интернет-продаж и интегратора 1С. Основной сценарий — продажа со склада продавца. Примеры запросов, уведомлений и ошибок относятся к API Яндекс Маркета. Для Ozon и Wildberries ту же схему проверки наполняют их методами и правилами; коды Маркета на другие площадки не переносят.
С чего начать: кто меняет каждое поле
Менеджер поправил цену в кабинете, а очередной обмен снова отправил прежнюю цену из 1С. В таком случае проверьте, какая система управляет этим полем и в каком порядке его обновляет. Для каждого поля определите, какая система вправе его изменять. Вторая система получает результат или выполняет заранее описанное преобразование.
В таблице — пример разделения потоков. Сопоставьте его с возможностями вашего модуля.
| Поток | Откуда берётся значение | Что хранить для сопоставления | Что сравнивать после обмена |
|---|---|---|---|
| Карточка товара | Из 1С либо кабинета — по отдельным полям | Номенклатуру, характеристику и идентификатор предложения площадки | Название, вариант и другие передаваемые поля одной карточки |
| Остаток | Из расчёта доступности в учётной системе | Предложение, магазин и склад площадки | Рассчитанное количество, отправленное количество и доступность на площадке |
| Цена | Из назначенного вида цены или отдельного расчёта | Предложение и уровень применения цены | Значение в 1С, отправленную цену и результат её обработки |
| Заказ | Из заказа площадки | Площадку, магазин, внешний номер и документ 1С | Товары, количество, статус и связь с документом |
| Расчёты | Из отчётов площадки и операций учёта | Внешний отчёт, период и связанные операции | Продажи, возвраты, удержания и выплату |
Необязательно передавать все поля карточки в одном направлении. Например, название можно вести в 1С, а описание для витрины — в кабинете. Тогда настройте состав выгрузки так, чтобы она не перезаписывала описание. Проверьте это на одной карточке: измените поле в его основной системе, выполните обмен, затем повторите обмен без новых изменений. Значение должно остаться прежним.
Для остатков проверьте ещё один участок кода: в какой момент заказ уменьшает доступное количество. Если один обработчик создаёт резерв, а другой отдельно вычитает заказ из выгрузки, один товар может уменьшить доступность дважды. На числовом примере ниже видно, как возникает двойное вычитание.
Как связать номенклатуру, характеристику и склад
Начните с товара, у которого есть варианты: размер, цвет или другая характеристика. Одного названия для связи недостаточно. В предложенной схеме связь указывает на конкретную номенклатуру и характеристику 1С, а с другой стороны — на предложение в определённом магазине площадки.
В API Маркета для передачи остатков SKU должен точно совпадать с указанным в каталоге. Метод работы с партнёрскими складами также использует идентификатор склада. Это условия передачи остатков Маркету: правильное количество с ошибочным SKU или складом не решает задачу доступности нужного товара.
Условный пример. В 1С есть футболка с характеристиками «чёрная, M» и «чёрная, L». На площадке им соответствуют разные предложения. Сопоставление только по общей номенклатуре смешает варианты: проданный размер M может уменьшить выгрузку размера L. Поэтому сначала найдите в настройках обмена обе связи и сравните их с карточками площадки. Затем отправьте разные количества по вариантам и посмотрите результат отдельно для каждого.
В описанном 1С подключении Wildberries для УНФ и Розницы одной позиции учётной системы могут соответствовать несколько карточек площадки, а склады площадки сопоставляются со складами учётной системы. Учитывайте такую связь при проверке: правило «одна позиция 1С — только одна карточка» здесь не подходит.
Если разрабатываете свой слой соответствий, выстройте обработку так:
- Найти запись по площадке, магазину и внешнему SKU.
- Получить из неё номенклатуру и характеристику 1С.
- Найти связь внутреннего склада со складом площадки.
- Если связи нет или она неоднозначна, остановить обработку этой позиции и показать, какой идентификатор не удалось разобрать.
Если храните связи в регистре сведений, проверьте его измерения и периодичность. Платформа 1С определяет ключ записи по измерениям и, для периодического регистра, периоду. Период в ключе может позволить хранить разные связи одного внешнего объекта во времени. Решите, нужна ли вам история или одна текущая связь, и настройте чтение соответственно. Такой регистр вы проектируете сами; готовый объект модуля нужно изучить отдельно.
Не подставляйте первый похожий товар вместо отсутствующего соответствия. Такая подстановка делает сбой менее заметным и позволяет обмену менять чужую карточку.
Отдельно проверьте упаковки. Если учёт ведётся в штуках, а предложение продаётся комплектом, в расчёте должно быть явное преобразование количества. Условный пример: из 11 свободных единиц можно собрать только 3 полных комплекта по 3 единицы. Отправка числа 11 как количества комплектов завысит доступность. Это учебная арифметика для такого состава комплекта, а не правило всех модулей 1С.

Доступный остаток: где появляется двойное вычитание
Сначала выясните, что означает исходное поле 1С. Физическое наличие, свободный остаток и количество к продаже могут различаться. Название поля в настройке обмена само по себе не объясняет расчёт: проследите, из какого отчёта, запроса или расчётной функции модуль получает число и какие резервы уже учёл.
Условный пример расчёта. На складе физически есть 20 единиц, 6 зарезервированы. Для этого примера магазин дополнительно оставляет 2 единицы как защитный буфер:
- если модуль берёт физическое наличие:
20 − 6 − 2 = 12; - если модуль уже получает свободный остаток 14:
14 − 2 = 12; - повторное вычитание резерва из свободного остатка даст
14 − 6 − 2 = 6— это ошибка именно в условиях примера.
Буфер — отдельное решение магазина, а не обязательное число для любой интеграции. Включайте буфер в расчёт один раз. Если результат отрицательный, в предлагаемой схеме отправляйте ноль.
Для Маркета поле количества в методе остатков означает доступный товар. При этом способ обновления зависит от организации складов. Сначала определите подходящий метод для своей схемы, затем проверяйте арифметику; смена формулы не исправит запрос, направленный не на тот склад.
Оверселл при нескольких каналах требует отдельного теста. Условный сценарий: в 1С осталась одна доступная единица, а два магазина почти одновременно прислали заказы. Запустите обработку обоих событий и посмотрите, где программа проверяет доступность и создаёт резерв. Если каждый обработчик успевает прочитать старое значение до изменения другим, одной периодической выгрузки недостаточно. Разработчику нужно обеспечить согласованную проверку и изменение доступности, например последовательной обработкой операций над общим запасом. Конкретный механизм выбирают по архитектуре базы и модуля.
После теста посмотрите, какие документы и резервы появились, кому досталась последняя единица и как система обработала второй заказ. Если склад общий, отдельно оцените, допустимо ли показывать весь свободный запас одновременно в каждом канале или его нужно распределять.
Цена ушла, но витрина показывает другое
Разделите три значения: цену в 1С, цену в отправленном запросе и цену после обработки на стороне площадки. Сравнение покажет, на каком участке искать расхождение.
- Цена неверна уже в 1С — проверьте вид цены и расчёт, из которого читает обмен.
- В 1С значение верное, в запросе другое — проверьте преобразование и связь предложения.
- Запрос содержит нужную цену, но результат отличается — разбирайте обработку на стороне площадки и область применения метода.
У Маркета есть метод цен на уровне бизнеса. Его документация предупреждает, что каталог обновляется не мгновенно. Поэтому сразу после отправки нельзя считать отсутствие новой цены на витрине доказательством неисправности обмена.
Сначала проверьте ответ метода и ошибки по конкретному предложению. После обработки прочитайте цену и состояние нужного товара на стороне Маркета; при ограничении изменения разберите его причину. До повторной отправки убедитесь, что работаете с тем же предложением и нужным уровнем цены: настройку бизнеса нельзя механически принять за отдельную цену магазина.
Практический тест — изменить цену одной позиции, найти её в отправленном наборе и проследить до результата. Затем повторить выгрузку без изменения исходной цены. Если второе задание возвращает старое значение, ищите конкурирующий источник: другой вид цены, вторую обработку или ручную настройку кабинета. Не меняйте сразу весь ассортимент, пока маршрут одной цены остаётся непонятным.
Один заказ — один документ: повторы, параллельность и отмена
Яндекс Маркет может отправить несколько уведомлений об одном событии — это описано в документации уведомлений. Поэтому запуск обработчика по каждому уведомлению не должен безусловно создавать новый документ 1С.
Для собственного обмена используйте постоянную связь внешнего заказа с документом. В предлагаемой схеме ключ включает площадку, магазин и внешний номер заказа. Обработчик сначала ищет эту связь: если заказ уже есть, обновляет допустимые поля; если нет — создаёт документ и сохраняет связь. Само уведомление и получение полного состава заказа рассматривайте как отдельные шаги, если так устроен API.
Но проверки «нашёл или не нашёл» недостаточно при параллельной работе. Два обработчика могут одновременно не найти связь и оба перейти к созданию. Участок поиска, создания и сохранения связи нужно защитить от такого соревнования. Можно последовательно обрабатывать события одного внешнего заказа или использовать подходящий механизм транзакций и блокировок. Это требование к реализации, а не обещание готовой защиты в любом модуле.
Проверка состоит из трёх разных сценариев:
- Последовательный повтор. Передайте одно событие дважды. В 1С должен остаться один связанный документ, без удвоения количества и резерва.
- Параллельный повтор. Запустите обработку того же заказа одновременно. Снова проверьте число документов и связей; успешные записи в журнале запусков здесь недостаточны.
- Отмена рядом с обновлением. Смоделируйте обработку отмены и запоздавшего изменения заказа. Итог в 1С должен соответствовать текущему состоянию площадки; старое событие не должно самовольно возвращать отменённый заказ в работу.
Для последнего сценария разработчик определяет допустимые переходы состояний и способ проверки текущего заказа. Время доставки не описывает последовательность бизнес-операций. Поэтому нельзя определять состояние заказа только по последнему пришедшему сообщению.
Ошибка API: повторять запрос или сначала читать результат
В запись об ошибке включайте операцию, внешний идентификатор, время отправки, HTTP-код и ответ площадки. Тогда разработчик сможет отличить неудачное обновление цены от ограничения доступа к другому магазину. Общая запись «ошибка обмена» для этого бесполезна.
Для Маркета различайте как минимум два случая из справочника ошибок API.
Код 420 — превышение лимитов. При ресурсном ограничении документация указывает срок его действия в заголовке X-RateLimit-Resource-Until. Обработчик должен учитывать ограничение, а не отправлять тот же запрос без паузы. После возобновления проверьте, что накопленные операции действительно обработались и очередь не потеряла позиции.
Код 499 — клиент закрыл соединение до завершения обработки запроса. В этом случае нельзя делать вывод о результате операции только по оборванному соединению. Если повтор может создать документ или изменить состояние заказа, сначала прочитайте результат на площадке по сохранённому идентификатору. Затем решайте, нужна ли повторная операция.
При ошибке доступа проверьте, к какому магазину относится запрос и какой доступ требуется именно этому методу. Повторять запрос с теми же правами без изменения причины бессмысленно. Код, заголовки и порядок восстановления берите из документации своей площадки: код 420 Маркета нельзя использовать как универсальное правило для Ozon или Wildberries.
Проверяйте восстановление на управляемом сбое в тестовой среде, на копии базы. Остановите тестовый обработчик после отправки, но до сохранения локального результата. После запуска обработчик должен выяснить результат операции и лишь затем решать, какие действия повторить. Для операций чтения и создания документов последствия повторов различаются — тестируйте их раздельно.
Возвраты и отчёты: проверка по операциям, а не по общей сумме
В описанном 1С рабочем месте для УНФ и Розницы есть отдельные виды документов для передачи на комиссию, возврата и отчёта комиссионера. По ним можно проследить операции после создания заказа. Документация по продажам на маркетплейсах описывает их в контексте этих продуктов; состав документов вашей базы нужно сопоставить с используемым модулем.
Начните с цепочки одного заказа: продажа, возврат, удержания, выплата. Для каждого элемента найдите внешний идентификатор и соответствующую операцию в 1С. Такая связь позволяет разобрать расхождение, даже когда итоговый отчёт содержит много заказов.
Не загружайте отчёт повторно только потому, что сумма выплаты не совпала с ожиданием. Сначала определите, какие операции вошли в отчёт и период сверки. Отмена до продажи, возврат после продажи и удержание требуют разного разбора; считать их одной отрицательной строкой без связи с исходной операцией неудобно для поиска ошибки.
Для сверки можно собрать две связанные таблицы в обработке или выгрузке:
- по заказам — внешний номер, продажа, возврат и документы 1С;
- по расчётам — идентификатор отчёта, период, начисления, отдельные удержания, выплата и связанные операции.
Названия документов и состав строк берите из своего модуля и формата отчёта. Для проверки выберите не только обычную продажу, но и частичный возврат. Сравните количество возвращённых единиц и сумму по этой операции; оставшаяся часть заказа должна сохранять свою связь с продажей.
Затем загрузите тот же отчёт ещё раз. В предлагаемой схеме приёмки повтор не создаёт вторую продажу, второй возврат или удвоенное удержание. Если площадка выпускает исправление отчёта, отдельно проверьте, как модуль отличает новую редакцию от повторной доставки старой: простое игнорирование уже знакомого номера способно пропустить изменения. Способ обновления нужно определить по формату отчёта, а не угадывать по имени файла.
Приёмочный план перед расширением ассортимента
Проводите проверки на копии базы и в доступной тестовой среде площадки. Если для проверки нужен рабочий кабинет, заранее отделите тестовые позиции и операции от продаж клиентам.
Соберите небольшой набор с разными свойствами: товар без вариантов, товар с характеристиками, комплект, позицию с резервом и товар на нескольких складах. Такой набор охватит разные ветки расчёта и сопоставления. Его объём подбирайте под свой обмен.
| Что проверить | Что сделать | По какому результату принимать |
|---|---|---|
| Разделение полей | Изменить поле в основной системе и дважды запустить обмен | Повтор не возвращает старое значение |
| Варианты и склады | Передать разные количества по характеристикам и складам | Результат относится к нужным предложениям и складам |
| Резервы | Создать резерв и пересчитать выгрузку | Резерв уменьшил доступность ровно в том месте, где предусмотрен расчёт |
| Комплект | Посчитать доступность при неполном последнем комплекте | Площадка получает число полных продаваемых комплектов |
| Цена | Изменить одну цену и проследить обработку | На нужном уровне применяется правильное значение либо видна конкретная причина отказа |
| Повтор заказа | Обработать событие последовательно и параллельно | Один внешний заказ связан с одним документом, количество не удвоилось |
| Отмена | Передать отмену рядом с запоздавшим обновлением | Заказ не возвращается в работу из-за порядка доставки |
| Ограничение API | Смоделировать ответ с ограничением | Обработчик учитывает правила площадки и затем разбирает накопленные операции |
| Неясный результат | Остановить обработчик после отправки операции | Восстановление сначала проверяет результат и не создаёт повторный документ |
| Возврат и отчёт | Обработать частичный возврат и дважды загрузить отчёт | Количества и операции верны, повторная загрузка не удваивает учёт |
К каждой проверке сохраняйте исходные значения, отправленную операцию и фактический результат. Для этого подойдёт строка с идентификаторами, значениями и ссылкой на документ.
Не расширяйте ассортимент, если ошибка затрагивает общий принцип: связь характеристик, расчёт доступности или создание заказов. Исправление одной карточки вручную не проверяет механизм. Повторите сценарий на другой позиции с тем же свойством, а затем весь связанный участок — например, резерв, отмену и восстановление остатка.
Когда хватит настройки, а когда нужна доработка
Если модуль поддерживает вашу конфигурацию, схему продаж и необходимые операции, начинайте с его настройки. Проверьте соответствия, виды цен, склады и доступные способы загрузки отчётов. Параллельные события и повторную загрузку проверьте отдельно: наличие настроек ещё не показывает, как модуль обрабатывает эти ситуации.
Подключать интегратора имеет смысл, когда обмен создаёт дубли, несколько каналов спорят за общий остаток, состав складов и юридических лиц не укладывается в настройки модуля либо бухгалтерия вручную разбирает операции отчётов. Опишите задачу на доработку через конкретный сбой: какой заказ повторился, какой резерв посчитался дважды, какой возврат не связался с продажей.
Механизм расширений 1С позволяет вынести доработки из основной конфигурации. Если доработки находятся в расширении, а сама типовая конфигурация не изменяется, она может остаться на полной поддержке. Уже изменённую типовую установкой файла .cfe обратно на полную поддержку не вернуть.
До подключения расширения проверьте его применимость к конкретной конфигурации. Перед обновлением повторите эту проверку на копии базы с будущим релизом и пройдите основные сценарии обмена: товар, остаток, цена, заказ, отмена. Так вы отделите ошибку подключения расширения от сбоя в отдельной операции. Успешная проверка применимости не заменяет функциональные тесты. После обновления также повторите проверку применимости и основные сценарии обмена.
Если нужна помощь с настройкой или доработкой, расскажите Forbion, какую конфигурацию 1С и площадки используете, что уже подключено и где возникают ошибки. Обсудим настройку или доработку интеграции и проверки перед запуском. Обсудить проект с Forbion →
Частые вопросы
Можно ли вести цены одновременно в 1С и кабинете?
Для разных полей или областей применения — можно построить такую схему. Для одной и той же цены нужен понятный приоритет записи. Иначе очередной обмен может отменить ручную правку. Проверьте, какие значения отправляет каждая обработка и на какой уровень площадки она их записывает.
Как часто выгружать остатки?
Выбирайте период по скорости изменений запаса, способу резервирования и ограничениям конкретного API. Проверьте сценарий продажи последней единицы между двумя обменами. Если в нём возникает лишняя доступность, одного сокращения интервала может оказаться недостаточно: разбирайте распределение общего запаса между каналами.
Как понять, что проблема именно в обмене, а не в исходном учёте?
Сравните значение до отправки, содержимое запроса и результат на площадке. Если число неверно ещё в исходном расчёте 1С, начинайте с него. Если оно изменилось при подготовке запроса — с преобразования. Если запрос верен, смотрите ответ, состояние товара и правила обработки на стороне площадки.
Что передать разработчику вместо сообщения «заказы иногда дублируются»?
Внешний номер заказа и магазин, номера документов 1С, время обработки и события, после которых появились копии. Добавьте шаги воспроизведения: повтор уведомления, параллельный запуск или восстановление после остановки. Так можно проверить конкретный участок создания документа и сохранения связи.