Маркетплейс как внешняя система со своим контрактом
Интеграция Bitrix/сайта с marketplace API
Подключаем API маркетплейса к сайту или Битрикс. Товары, остатки, заказы и статусы включаются в интеграцию в заранее выбранном составе.

Данные имеют владельца
Определяем, откуда берётся каждая сущность и в какую сторону меняется. Учитываем идентификаторы, ограничения API и доступные операции. Согласуем правила конфликтов и расписание обновлений. Не переносим всю спецификацию площадки в объём по умолчанию: выбираем сценарий, который нужен бизнесу на первом этапе.
Маркетплейсы различаются контрактами, ограничениями и состояниями операций. Уточняем конкретные кабинеты и сценарии: остатки, цены, заказы или документы. Один универсальный обмен без учёта этих различий создаёт ошибки, которые трудно заметить на этапе отправки запроса.
Определяем источник истины для каждого поля. Например, внутренний склад может управлять доступным количеством, но статус отгрузки приходит от площадки. Обратные события должны дополнять процесс, сохраняя правила изменения данных в вашей системе.
Повтор и лимит — обычные условия обмена
Настраиваем авторизацию, очередь и обработку ошибок в применимом контуре. Проверяем повторное событие, ограничение запросов и изменение статуса. Журнал должен показывать, какие данные переданы и что требует внимания. Перед выпуском используем тестовую среду или согласованные контрольные операции.
Планируем поведение при лимите запросов, временной недоступности и частично принятом пакете. Повтор должен касаться неуспешной операции и учитывать уже принятые данные. Иначе попытка восстановить обмен способна создать дубли или вернуть устаревшие значения.
Сопоставление идентификаторов хранится явно. При изменении карточки или ошибке отдельного товара сотрудник должен понимать, что исправлять и можно ли продолжить остальные операции. Отчёт обмена отделяет ожидание обработки площадкой от подтверждённого результата.
Как принимать интеграцию
Сверяем выбранные объекты на обеих сторонах и отдельно воспроизводим повтор и ошибку. Команда знает, как продолжить неуспешную операцию и где искать её состояние.
С чего ограничить первый запуск
Выбираем один поток и контрольную группу товаров или заказов. Нужны доступы к тестовому режиму, если он существует, описание справочников и примеры проблемных операций. Возможности конкретного API проверяем до окончательной оценки.
Определить сценарий marketplace API
Расскажите о текущем процессе, используемых системах и нужном результате. Для начала подойдёт краткое описание — уточняющие вопросы разберём вместе.
PORTcore · От задачи к решению
Работа с площадкой требует согласованного движения данных
Товары, остатки и заказы проходят через разные состояния, и сотрудникам важно понимать, какое из них уже подтверждено. Выберем поток, который сейчас требует больше ручных сверок. Интеграция по этому маршруту даст основу для дальнейшего подключения API с понятными идентификаторами, правилами повторов и ответственностью систем.