Заявка пришла — и сразу в работу: разбираем Orders Intake
Webhook принимает заказ, проверяет поля и сумму. До 1000 ₽ — автоматическое одобрение, выше — ручная проверка. Ошибка возвращается понятным JSON, а не тишиной.
Заказ без order_id — это не заказ, а сюрприз. Особенно если он пришёл ночью, а менеджер узнал о нём только после звонка клиента. Workflow Orders Intake ставит на входе проверяющего: он принимает JSON, валидирует структуру, считает сумму и сразу говорит, что делать дальше.
Как выглядит путь заказа
- Order Webhook принимает POST на
/webhook/orders. - Validate Order проверяет
order_id, клиента, непустой массивitems, SKU, целое количество и неотрицательную цену. Сумма считается по строкам. - High Value? сравнивает итог с порогом 1000 ₽.
- Если сумма меньше порога — Approve ставит
auto_approvedи возвращает 200. - Если больше или равна — Flag For Review ставит
manual_reviewи возвращает 202. - При ошибке валидации Format Error формирует
rejectedи 400 с причиной.
Ответы — это отдельная ценность. Внешняя система не гадает, что произошло: 200 — принято автоматически, 202 — принято, но ждёт человека, 400 — данные неверные и вот почему. Такой контракт сильно упрощает интеграцию с сайтом, CRM или 1С.
Почему порог 1000 ₽ — это не про деньги
Порог в демо-версии выбран как пример. Смысл не в конкретной сумме, а в идее: мелкие заказы можно проводить автоматически, крупные — отдавать человеку. Это снижает риск ошибки и не тормозит поток.
Автоматизация не обязана принимать все решения. Иногда лучший результат — быстро отличить рутину от случая, который требует внимания.
После ветки Approve можно поставить создание сделки в CRM, запись в Google Sheets или отправку письма. После Flag For Review — сообщение менеджеру с подсвеченной суммой. Сам workflow уже даёт готовый JSON, с которым удобно работать дальше.
Что получается на выходе
- Единая точка приёма заказов с понятным API-контрактом.
- Валидация до того, как данные попадут в CRM.
- Автоматическое одобрение типовых заказов.
- Ручная проверка крупных или подозрительных.
- Ошибки с кодом 400 и объяснением, а не «что-то пошло не так».
Кому подойдёт
Интернет-магазинам, сервисным компаниям и командам, которые собирают заявки с сайта, лендинга или партнёрского API. Особенно если заказы уже приходят в JSON, но обрабатываются вручную или скриптом без валидации.
Что внутри технического задания
ТЗ фиксирует схему запроса, обязательные поля, правила расчёта суммы, коды ответов, порог ручной проверки и точки подключения CRM. Отдельный раздел — тесты на «плохие» заказы: пустой массив, отрицательная цена, дробное количество. Именно они чаще всего ломают интеграции.