За одним заказом стоит несколько корпоративных систем
На этапе проектирования B2B-личный кабинет выглядит относительно просто. Клиент авторизуется, видит каталог со своими ценами, выбирает продукцию, оформляет заказ и отслеживает его выполнение. Такой сценарий легко разложить на страницы, формы и пользовательские действия.
Но за каждым действием стоят корпоративные данные и бизнес-правила. Цена зависит от договора, доступное количество товара — от складских остатков и резервов, возможность оформить заказ — от кредитного лимита и состояния взаиморасчётов. После отправки заказа его обрабатывают сотрудники компании, а документы формируются в учётной системе или через ЭДО.
Сам кабинет может не управлять ни одним из этих процессов. Он предоставляет клиенту доступ к операциям, которые выполняются в других системах. Поэтому до разработки интерфейса необходимо разобраться, как устроен весь процесс и какие компоненты в нём участвуют.
Рассмотрим обычную повторную закупку. Чтобы клиент мог самостоятельно оформить и получить заказ, система должна:
- Определить, от имени какого юридического лица действует пользователь и какие договоры ему доступны.
- Получить применимые к этому договору цены и условия оплаты.
- Проверить возможность поставки выбранного количества продукции.
- Передать заказ в систему исполнения и получить подтверждение его регистрации.
- Сообщить клиенту, принят ли заказ к исполнению, показать дальнейшие статусы и предоставить необходимые документы.
Эти действия могут выполняться в разных корпоративных системах. Если проектировать только видимую пользователю часть, архитектурные ограничения обнаружатся позже: при подключении интеграций, тестировании реальных заказов или уже после запуска.
Задача проектирования — определить, какие операции выполняет кабинет, а какие делегирует другим системам, и договориться, как между ними передаются данные и подтверждаются результаты.
Какая система отвечает за данные и бизнес-правила
В корпоративной инфраструктуре одни и те же сведения часто хранятся в нескольких местах. Контрагенты присутствуют в ERP и CRM, товары — в учётной системе и каталоге, заказы — в кабинете и системе исполнения.
Это не обязательно ошибка. Кабинет может хранить локальную копию каталога для быстрого поиска или собственную историю действий пользователей. Проблемы начинаются, когда системы независимо изменяют одни и те же сведения или по-разному рассчитывают бизнес-показатели.
Для начала полезно составить матрицу ответственности. Она покажет, какой компонент предоставляет данные, где принимается окончательное решение и что кабинет вправе сообщить клиенту.
Ниже — условный пример для торговой компании. В конкретном проекте распределение функций может отличаться.
| Данные или операция | Ответственная система | Роль личного кабинета | Что нужно проверить |
|---|---|---|---|
| Договорная цена | ERP или сервис ценообразования | Передаёт контрагента, договор и состав заказа; показывает результат расчёта | Совпадение условий в кабинете и подтверждённом заказе |
| Доступность товара | ERP и складская система | Показывает предварительную доступность и инициирует проверку | Учитываются ли резервы и параллельные заказы |
| Регистрация заказа | ERP или система управления заказами | Передаёт операцию, сохраняет идентификатор и получает результат | Не создаются ли дубликаты при повторных запросах |
| Статус исполнения | Система, отвечающая за соответствующий этап | Преобразует внутренние состояния в понятные клиенту | Не отображается ли устаревший или неподтверждённый статус |
| Счета и закрывающие документы | Учётная система или ЭДО | Предоставляет документы уполномоченным пользователям | Совпадают ли юридическое лицо, заказ и статус документа |
Матрица не заменяет архитектурную схему и спецификации интеграций, но позволяет выявить спорные места до начала реализации. Например, сразу становится видно, если разработчики планируют рассчитывать цену в кабинете, хотя действующие договорные правила уже реализованы в ERP.
Источник данных и владелец бизнес-правила — не всегда одно и то же
Предположим, ERP рассчитывает договорную цену. Кабинет получает готовое значение и показывает его клиенту. За корректность расчёта отвечает ERP, а кабинет должен правильно передать параметры запроса и отобразить результат.
В другой архитектуре ERP хранит договоры и базовые цены, а расчёт выполняет отдельный сервис ценообразования. Это тоже рабочий вариант, если ответственность компонентов определена.
Риск возникает, когда одни и те же правила независимо реализованы в нескольких местах. Например, скидка рассчитывается и в ERP, и в кабинете. При изменении условий договора обе реализации необходимо обновить одновременно. Если одна из них останется прежней, клиент увидит одну сумму, а учётная система примет заказ с другой.
Поэтому для критичных данных нужно определить не только источник, но и место выполнения бизнес-правила. Особенно важно зафиксировать момент, когда результат расчёта становится обязательным для операции.
Цена, которую пользователь видел при просмотре каталога, может отличаться от окончательной стоимости заказа. Между этими действиями могли измениться условия договора или состав корзины. При подтверждении заказа система должна зафиксировать коммерческие условия, по которым он принят: цены, скидки, применённый договор и другие значимые параметры.
Хранить такую информацию следует в системе, отвечающей за принятый заказ, либо в согласованном с ней контуре. Тогда историю операции можно восстановить, даже если текущие цены в каталоге уже изменились.
Проверка остатков не равна резервированию
Со складскими данными возникает похожая проблема. В WMS товар может физически находиться на складе, но часть количества уже зарезервирована под другие заказы. В ERP могут действовать дополнительные ограничения на отгрузку.
Клиенту же важно знать, сколько продукции компания действительно готова ему поставить.
Предположим, два клиента одновременно оформляют заказ на последние доступные единицы товара. Оба могут увидеть положительный остаток и успешно пройти предварительную проверку. Но если ни одна операция не закрепляет количество за конкретным заказом, подтвердить оба заказа компания не сможет.
Поэтому необходимо разделять предварительный показ доступности, проверку количества и резервирование. Если корпоративная система позволяет выполнить проверку и создание резерва как одну согласованную операцию, это снижает риск конкуренции между заказами. Если нет, нельзя считать предварительно показанный остаток гарантией поставки.
В таком случае кабинет может принять заявку на обработку, но окончательное подтверждение доступного количества должно поступить из системы, которая управляет резервами и обязательствами по поставке.
Для архитектуры здесь важен не только способ получения остатка через API. Нужно установить, какое количество можно обещать клиенту, кто вправе его зарезервировать и что произойдёт, если резервирование не удалось.
Интеграция должна учитывать весь жизненный цикл заказа
Наличие API между личным кабинетом и ERP ещё не означает, что процесс оформления заказа работает надёжно.
Клиент отправляет заказ, ожидает подтверждения, затем получает информацию о его исполнении. На каждом этапе могут возникнуть задержки, ошибки обмена и ситуации, когда одна система выполнила операцию, а другая об этом ещё не знает.
Архитектура должна учитывать такие состояния заранее, а не только успешный путь, который обычно демонстрируют при тестировании интерфейса.
Отправка заказа и его принятие — разные события
Предположим, клиент оформил заказ, кабинет отправил запрос в ERP, а учётная система зарегистрировала документ и вернула идентификатор. Кабинет сохранил результат и показал пользователю номер заказа.
Теперь изменим одно условие: ERP зарегистрировала заказ, но ответ не дошёл до кабинета из-за тайм-аута.
Для отправляющей системы результат неизвестен. Она не может уверенно утверждать ни то, что заказ создан, ни то, что операция завершилась ошибкой. Повторная отправка запроса без дополнительных проверок может привести к появлению второго заказа.
Чтобы этого избежать, необходима идемпотентная обработка — повтор одного и того же запроса не должен создавать новую бизнес-операцию.
Один из вариантов реализации — назначать заказу стабильный идентификатор операции, который сохраняется при повторных запросах. Принимающая сторона должна проверять этот идентификатор и возвращать ранее зафиксированный результат, если операция уже выполнялась. Проверку важно проводить согласованно с созданием заказа, иначе два параллельных одинаковых запроса всё равно могут породить дубликаты.
Если ERP не поддерживает такой механизм, защиту приходится реализовывать в интеграционном слое. Но простого хранения идентификатора в кабинете недостаточно: нужно обеспечить сопоставление с заказом в принимающей системе и возможность восстановить результат после потери ответа.
Отдельно следует различать технические и бизнес-состояния:
- Запрос сохранён — кабинет зафиксировал намерение клиента оформить заказ.
- Передан на обработку — операция отправлена во внутренний контур.
- Зарегистрирован — учётная система подтвердила создание заказа.
- Принят к исполнению — пройдены необходимые бизнес-проверки, и компания подтвердила дальнейшую обработку.
В зависимости от процесса некоторые состояния могут совпадать, но объединять их автоматически нельзя. Регистрация документа в ERP ещё не всегда означает, что товар зарезервирован, кредитный лимит проверен и поставка подтверждена.
Что делать, если заказ создан, а резервирование не удалось
В корпоративных системах не всегда возможно выполнить все этапы заказа в рамках одной общей транзакции. Например, ERP зарегистрировала заказ, а складская система не смогла зарезервировать часть продукции.
Здесь недостаточно записать ошибку в журнал. Нужно определить дальнейшую судьбу операции:
- Если резервирование не произошло из-за временной недоступности склада, система может повторить запрос после восстановления связи. При этом повтор должен быть защищён от создания лишних резервов.
- Если склад подтвердил отсутствие необходимого количества, автоматический повтор ничего не изменит. Заказ может перейти в состояние, требующее согласования: изменить количество, предложить частичную поставку или передать ситуацию ответственному сотруднику.
В некоторых процессах потребуется отменить ранее выполненное действие. Например, снять созданный резерв или аннулировать заказ. Такие операции называют компенсационными, но они не равнозначны простому откату транзакции: уже выполненное действие не всегда можно автоматически отменить без дополнительных проверок.
Поэтому до разработки необходимо согласовать, какие частично выполненные операции допустимы, какие действия можно повторять, а какие требуют компенсации или ручного решения.
Для пользователя это тоже имеет значение. Вместо сообщения «Заказ успешно оформлен» кабинет должен показать подтверждённый результат: например, что заказ зарегистрирован, но доступность части позиций уточняется.
Как не потерять актуальный статус при обмене событиями
После регистрации заказ продолжает изменяться. Он может пройти согласование, резервирование, комплектацию и отгрузку. Эти события часто приходят из разных систем и не обязательно в том порядке, в котором произошли.
Например, кабинет уже получил подтверждение отгрузки, а затем из-за задержки обработки поступило более старое событие о комплектации. Если просто перезаписать статус последним полученным сообщением, пользователь увидит, будто заказ вернулся на предыдущий этап.
Поэтому для обмена статусами нужны правила обработки повторных и запоздавших событий. В зависимости от архитектуры можно использовать версии состояния, последовательные номера событий или проверку допустимых переходов. Ориентироваться только на время получения сообщения недостаточно.
При этом кабинет не обязан воспроизводить все внутренние статусы. Для клиента важны подтверждённые изменения: заказ принят, готовится к отгрузке, отправлен, требуется согласование. Правила преобразования внутренних состояний в пользовательские следует описать отдельно.
Документы — часть того же процесса
Счёт, УПД и другие документы могут формироваться в учётной системе или передаваться через ЭДО. Но наличие файла ещё не всегда означает, что его можно считать окончательным документом по заказу.
Перед отображением необходимо проверить, к какому юридическому лицу относится документ, на основании какой операции он сформирован и в каком состоянии находится. Например, черновик, ожидающий подписания, нельзя безоговорочно представлять как завершённый обмен документами.
Права пользователя тоже должны учитываться. Закупщик может иметь доступ к составу заказа, но не ко всем финансовым документам организации. Поэтому интеграция с документооборотом связана одновременно с данными, статусами и моделью доступа.
Как обнаруживать ошибки до обращения клиента
Для сопровождения интеграций недостаточно проверять доступность API. Сервис может отвечать на запросы, но при этом часть заказов останется без подтверждения или документы перестанут появляться в кабинете.
В мониторинге полезно отслеживать:
- количество необработанных операций,
- время ожидания подтверждений,
- повторные ошибки,
- рост очередей
- и расхождения состояний между системами.
Каждая бизнес-операция должна иметь идентификатор, по которому можно связать действия пользователя, сообщения интеграционного контура и записи в принимающей системе. Тогда специалисты смогут восстановить весь путь заказа и понять, где возникла проблема.
Для ИТ-команды это важное условие эксплуатации. Иначе даже простой вопрос клиента «Почему заказ до сих пор не принят?» превращается в ручной поиск по журналам нескольких систем.
Как определить допустимую задержку обновления данных
При проектировании интеграций нужно решить, какие сведения кабинет получает по запросу, а какие может хранить и обновлять периодически.
Каталог товаров, описания и технические характеристики часто не требуют постоянного обращения к ERP. Их можно передавать по расписанию или обновлять при изменениях. Но к ценам, доступному количеству продукции и кредитным лимитам требования могут быть строже.
При этом получать все данные синхронно тоже не всегда оправданно. Учётная система может иметь ограничения по нагрузке, периоды обслуживания или API, не рассчитанный на большое количество одновременных пользовательских запросов.
Поэтому важен компромисс между актуальностью данных, производительностью и устойчивостью к сбоям.
Например, кабинет может показывать предварительную доступность товара из локальной копии, а перед оформлением заказа выполнять проверку в системе, отвечающей за резервы. Если источник временно недоступен, пользователь может отправить заявку на последующее подтверждение, но не должен получать обещание гарантированной поставки.
Формулировка «данные должны быть актуальными» для архитектурного проектирования слишком неопределённа. Лучше согласовать конкретные условия:
- какую задержку обновления допускает бизнес для каждого типа данных;
- в какой момент требуется повторная проверка;
- можно ли продолжить операцию при недоступности источника;
- что показывать пользователю, если достоверность значения не подтверждена.
Эти требования непосредственно влияют на способ интеграции. Для одних операций достаточно периодической синхронизации, для других нужны запросы при выполнении действия, асинхронные события или отдельный сервис, который управляет состоянием операции.
Почему модель пользователей влияет на архитектуру
В B2B-кабинете за одним клиентом может стоять несколько юридических лиц, филиалов и сотрудников с разными полномочиями. Закупщик оформляет заказы, руководитель согласовывает операции, бухгалтер работает с документами, а администратор управляет доступом коллег.
Например, два сотрудника могут иметь одинаковую роль бухгалтера, но работать в разных юридических лицах. У обоих есть право открывать раздел документов, однако каждый должен получать доступ только к документам своей организации.
Поэтому авторизация должна учитывать одновременно:
- роль пользователя,
- организацию,
- конкретный объект
- и запрашиваемое действие.
Это особенно важно для API. Если пользователь получил доступ к документу по его идентификатору, система должна проверить не только наличие роли, но и принадлежность документа организации, с которой пользователь вправе работать.
Иначе возникает уязвимость доступа на уровне объекта — Broken Object Level Authorization (BOLA), которую OWASP выделяет среди основных рисков безопасности API.
При проектировании следует отдельно определить, как в системе представлены организации и их сотрудники, кто назначает полномочия и может ли один пользователь действовать от имени нескольких юридических лиц.
Не менее важна связь справочников. Если в ERP, CRM и кабинете один контрагент имеет разные идентификаторы, требуется надёжное сопоставление записей. Ошибка здесь может привести не просто к путанице в интерфейсе, а к предоставлению коммерческих данных другой организации.
VEKA: партнёрская система со своей логикой распределения данных
B2B-кабинеты не всегда связаны с закупками. В партнёрской сети ключевым объектом может быть заявка клиента, которую нужно получить, назначить ответственному участнику и провести через установленные этапы обработки.
Такую систему DIGITAL SECTOR модернизировал для VEKA. Личный кабинет объединяет сотрудников компании, партнёров и дилеров. В него поступают заявки с сайта VEKA, лендингов и других площадок, а распределение между участниками сети выполняется по заданным бизнес-правилам.
С архитектурной точки зрения здесь важны три особенности.
- Правила назначения заявок сосредоточены в личном кабинете. Если клиент выбрал конкретную точку продаж, заявка направляется соответствующей компании. Если нет, система определяет получателя по установленным правилам. Это бизнес-логика обработки обращений, а не просто отображение данных из внешней CRM.
- Партнёры отвечают за сведения о своих точках продаж. Они добавляют и обновляют адреса, контакты и другие данные. Из кабинета информация автоматически передаётся на сайт VEKA и используется при распределении обращений. Таким образом, у процесса есть определённый источник данных и понятное направление обмена.
- Доступ разграничен по участникам сети. Сотрудники VEKA контролируют общий поток заявок, а партнёры и дилеры видят назначенные их компаниям обращения. Система также сохраняет историю обработки, а мониторинг сообщает ответственным специалистам об ошибках распределения.
При модернизации DIGITAL SECTOR сохранил действующие правила обработки заявок, обновил интерфейс и провёл рефакторинг технической основы. Это позволило развивать систему без замены уже работающей бизнес-логики.
Пример VEKA показывает ещё один вариант распределения ответственности. Для торгового кабинета основные правила могут находиться в ERP, а для партнёрской системы часть критичной логики — например, маршрутизация заявок — может выполняться непосредственно в самом кабинете.
Как готовность внутренних систем влияет на первую версию
При планировании B2B-кабинета обычно составляют список пользовательских функций и определяют приоритеты. Но для корпоративного проекта важно учитывать ещё и готовность внутренних систем.
Например, заказчик хочет, чтобы клиент отслеживал отгрузку. Интерфейс для этого можно спроектировать достаточно быстро. Однако если данные о доставке не связаны с заказами или статусы ведутся вручную, система не сможет предоставлять достоверную информацию без предварительных изменений в существующих процессах.
Похожая ситуация возникает с кредитными лимитами, персональными ценами и документами. Функция может быть востребована бизнесом, но для её запуска придётся подготовить справочники, правила расчёта или интеграционные интерфейсы.
Поэтому функциональность первой версии полезно разделить на три группы.
- Функции с готовыми источниками данных. Например, история заказов, если сведения доступны через поддерживаемый API и корректно связаны с контрагентами. Такие сценарии могут войти в ранний релиз после проверки качества данных и прав доступа.
- Функции, требующие подготовки интеграций. Данные существуют, но обновляются пакетно, доступны только через внутренний интерфейс или не содержат необходимых идентификаторов. Значительная часть работ здесь будет связана с обменом данными, а не с разработкой экранов.
- Функции, зависящие от изменений бизнес-процесса. Например, в компании нет единого правила расчёта доступного остатка или согласованной модели статусов заказов. В такой ситуации сначала нужно определить ответственность и правила работы, иначе автоматизировать будет нечего.
Это не означает, что весь проект следует откладывать до полной модернизации корпоративной инфраструктуры.
Иногда разумнее запустить ограниченный, но законченный сценарий. Например, разрешить клиенту отправлять заказ на согласование и отслеживать результат обработки, не обещая мгновенное подтверждение всех коммерческих условий.
Главное — заранее зафиксировать границы автоматизации. Если кабинет лишь принимает заявку, он не должен создавать впечатление, что заказ уже принят к исполнению.
Что определить до начала разработки
Перед разработкой ИТ-команде и бизнес-заказчику необходимо согласовать несколько решений. Они помогут установить реальные границы проекта и избежать ситуации, когда интерфейс готов, а необходимые корпоративные процессы ещё не поддерживаются.
1. Сквозные пользовательские сценарии и состояния операций. Для каждого критичного действия нужно описать начало, промежуточные состояния, подтверждённый результат и исключения. Например, какие события проходит заказ от отправки до принятия в ERP и когда клиент получает право считать его подтверждённым.
2. Матрицу ответственности систем. Для цен, остатков, договоров, заказов и документов необходимо указать владельцев данных и бизнес-правил. Отдельно зафиксировать, какие сведения кабинет хранит самостоятельно, а какие получает из корпоративных источников.
3. Модель данных и прав доступа. Нужно согласовать структуру организаций, филиалов и пользователей, правила сопоставления идентификаторов между системами и проверки полномочий на уровне конкретных объектов.
4. Контракты интеграций и правила обработки ошибок. Для критичных операций следует определить направление обмена, формат подтверждения, допустимую задержку, порядок повторов и действия при частично выполненной операции.
5. Требования к эксплуатации и приёмке. Помимо успешных сценариев необходимо проверить потерю ответа, повторное создание заказа, недоступность ERP, запоздавшие события и попытки доступа к чужим данным. Отдельно согласовать показатели мониторинга и порядок разбора ошибок.
Итогом подготовки не обязательно должен становиться большой комплект архитектурной документации. В зависимости от масштаба проекта может быть достаточно схемы взаимодействия систем, матрицы ответственности, модели данных и прав, описания критичных сценариев и интеграционных контрактов.
Но эти решения необходимо зафиксировать до того, как они превратятся в код. Иначе команда будет принимать их по отдельности в ходе разработки, а последствия проявятся уже при интеграционном тестировании или эксплуатации.
Личный кабинет не должен создавать вторую версию корпоративных процессов
Личный кабинет может иметь собственную базу данных, хранить сведения о пользователях, историю действий и локальные копии справочников. Проблема не в наличии собственного хранилища, а в появлении ещё одного независимого источника коммерческих условий, статусов и бизнес-правил.
Если цена рассчитывается в двух системах по разным правилам, заказ может создаваться повторно после сбоя, а его статус — изменяться без подтверждённого события, ошибки рано или поздно дойдут до клиента. Исправлять их только на уровне интерфейса бессмысленно.
При проектировании B2B-кабинета важно заранее договориться, кто отвечает за каждую операцию, какие данные считаются достоверными, как системы подтверждают результат и что происходит при отказах.
Именно эти решения определяют, сможет ли личный кабинет стать надёжной частью корпоративной ИТ-архитектуры и развиваться без постоянного дублирования логики существующих систем.