SiteLab

Обмен между сайтом, учётом и сервисами

Разработка API и интеграция бизнес-систем.

Минск · Беларусь · удалённая работа с экспортными проектами

Обсудить проект

Связываем сайт, CRM, учётную систему, склад и сервисы доставки. Разрабатываем REST API и вебхуки, настраиваем передачу заказов, остатков и статусов. Берёмся за новый обмен и восстановление действующей интеграции.

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

API

контракты и документация

Webhooks

входящие события

Очередь

фоновые операции

Журнал

сверка и диагностика

Стоимость по сметеСрок после проверки систем

Когда это решение окупается

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

01

Интернет-магазины

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

02

Производители и дистрибьюторы

Дилерский портал должен получать данные из учёта, а заявки партнёров должны возвращаться в систему, с которой работает отдел продаж.

03

Продуктовые команды

Требуется API для нового интерфейса, партнёра или мобильного приложения. Уже работающие клиенты должны пройти регрессионную проверку.

Типовые сигналы

Задачу уже пора систематизировать

  1. 01Заявки приходится переносить из сайта в CRM вручную
  2. 02Заказы дублируются после повторного запроса
  3. 03Статус доставки обновляется у перевозчика и не доходит до покупателя
  4. 04Склад и витрина расходятся в идентификаторах и остатках
  5. 05После ошибки никто не видит, какой пакет данных пропал

Что проектируем и внедряем

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

01

Проектирование API

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

  • REST и OpenAPI
  • версии и авторизация
  • модели и идентификаторы
  • вебхуки и подтверждения
02

Синхронизация

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

  • очередь и история обработки
  • правила сопоставления
  • контроль повторов
  • сверка записей
03

Эксплуатация

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

  • журнал с идентификаторами
  • уведомления об ошибках
  • тестовый контур
  • инструкция для дежурного

Что получите на выходе

Готовый и проверенный результат, который можно принять по понятному списку.

01

Карта систем и владельцев данных

02

Контракт API и карта полей

03

Рабочие адаптеры

04

Журнал и уведомления

05

Сценарии приёмки и инструкция

Витрина и учёт в одном процессе

DTL.by. Серверный API для витрины на Next.js

Подключили новую витрину к действующему OpenCart через серверный API. В кейсе показано, как связали каталог и оформление заказа с существующей системой магазина.

Next.js

публичная витрина

OpenCart

существующий бэкенд

API

связь каталога и оформления

DTL.by. Серверный API для витрины на Next.js
Посмотреть кейс DTL

Разработка и приёмка обмена

Как связать системы и увидеть, где застрял заказ

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

Контракт между системами

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

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

Вебхуки, сбои и повторная обработка

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

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

Arctic Fox × MAXTARGET. Обработка заказов по API 1.5

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

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

На тестовом контуре проверили оформление заказа и возвраты. Совместная проверка с реальным клиентом MAXTARGET 1.5 — отдельный этап приёмки обмена.

Что проверяем перед запуском

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

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

Единый контур

Связываем с системами бизнеса

Для каждого обмена определяем источник истины, формат, частоту, поведение при ошибке и ответственного.

01

1С и ERP по доступному интерфейсу

02

Битрикс24, amoCRM и заказные CRM

03

Сайт и личный кабинет

04

Складские системы

05

Сервисы доставки

06

API поставщиков и маркетплейсов

География и локальный контекст

Интеграция систем для бизнеса в Беларуси

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

01Работа с вашей командой или подрядчиком
02Согласованные тестовые данные
03Документация для эксплуатации

Как проходит работа

До первого изменения фиксируем объём, зависимости, критерии приёмки и безопасный сценарий запуска.

  1. 01

    Разбираем текущий процесс

    Записываем участников, системы и наблюдаемую проблему. Берём примеры нормальной и сбойной записи.

  2. 02

    Согласуем контракт

    Утверждаем поля, права, статусы, обработку повторов и границы первого этапа.

  3. 03

    Подключаем и тестируем

    Реализуем интеграцию и прогоняем контрольные сценарии на тестовой среде.

  4. 04

    Принимаем и передаём

    Проверяем согласованный обмен, передаём описание API и инструкцию для разбора сбоев.

Быстрая оценка

Уточним цену и следующий шаг

Оставьте контакт. Если добавите один комментарий о задаче, ответ будет предметнее.

Форматы и стоимость

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

Когда обмен уже существует

Диагностика обмена

По смете
  • Карта потока и журналов
  • Воспроизведение ошибки
  • Приоритеты и оценка первого этапа
Получить оценку
Первый рабочий обмен

Один маршрут данных

По смете
  • Контракт и подключение
  • Тестовые записи и повторы
  • Журнал и вебхуки
  • Инструкция для команды
Получить оценку
CRM, учёт, склад и сервисы

Интеграция нескольких систем

По смете
  • Карта владельцев данных
  • Поэтапный запуск
  • Сверка и уведомления
  • План сопровождения
Получить оценку

FAQ

Что важно до старта

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

Можно ли подключить старую систему?

Начинаем с проверки доступного интерфейса, форматов и ограничений. Если система предоставляет проверяемый файловый обмен, его можно обсудить как основной согласованный интерфейс.

Можно ли подключить напрямую 1С к Битрикс24?

Оценим сценарий по вашей конфигурации 1С и действующей CRM. Согласуем данные, направление обмена и работу на стороне учёта с вашим специалистом по 1С.

Как исключить повторное создание заказа?

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

Как защищаются данные в API?

Согласуем ограничения доступа, набор передаваемых полей, правила хранения секретов и ограничения журналов. Для проверки выделяем тестовые учётные данные.

Можно начать с одного проблемного обмена?

Да. Пришлите системы, проблемный шаг и время последнего сбоя. По ним предложим объём диагностики и способ проверить результат.

Наши гарантии.

Фиксируем правила работы заранее: деньги, сроки, доступы и результат. Так проект не превращается в бесконечную переписку.

01

Цена и срок — в договоре

Фиксируем стоимость и дату до старта. Не растут по ходу проекта.

02

Код и доступы — ваши

Весь код в вашем репозитории + документация. Никаких привязок к нашим сервисам.

03

Результат виден по этапам

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

04

Не продаём лишнее

Решается проще или дешевле — скажем прямо. Платите за то, что реально нужно.

Первичный разбор

Разберём задачу без продажи лишнего

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

Обсудить с разработчиком