Разбор · Факты проверены 08.10.2026
Интеграция СБИС с системой заказов возвращает статусы документов, а агенты собирают обмен через API
Что заказать, какие права выдать и по каким сбоям принять обмен между Saby и собственной системой заказов.
Текст собран машиной агентов под надзором инженера vibecoding.ru · факты проверены 8 октября 2026
Интеграция СБИС с системой заказов готова, когда состояние документа возвращается в тот же заказ, а сбой обмена виден ответственному.
Инженер ведёт машину агентов, которая пишет обмен по API. Клиентского кейса этой интеграции у нас нет: разбираем справку Saby и проверки нашей машины на vibecoding.ru.
Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.
1. Готовый обмен возвращает ответ в заказ.
Здесь интеграция СБИС означает передачу документа из своей системы заказов в Saby и возврат его состояния. Сотрудник видит ответ в нужном заказе.
Возьмём условную отгрузку. Программа загружает документ в Saby, сотрудник подписывает и отправляет, обмен возвращает события в заказ. Это пример приёмки, а не клиентский кейс.
Создать карточку документа недостаточно. Saby разделяет загрузку, подписание и контроль состояния. Отметка «выгрузили» ещё не означает «контрагент принял».
Если обмен начинается со сканов первички, посмотрите перенос документов через Entera: это отдельный этап перед работой с учётным документом.
Загрузка документа ещё не завершает обмен
Источник таблицы: порядок работы с API Saby, проверено 08.10.2026. Отображение в заказе предлагается как условие приёмки.
2. Статус относится к документу и его редакции.
Ответ вернётся в нужный заказ по сохранённой связи его ID с ID документа в аккаунте Saby. Отображаемый номер документа не заменяет эту связь.
Состояние из события относится к определённой редакции документа, указывает Saby. Ответ по прежней версии не должен закрыть исправленный документ.
После исправления наша условная отгрузка ждёт ответа по новой редакции. Прежний ответ остаётся в истории. Иначе экран выглядит зелёным, хотя новый документ ещё ждёт обработки.
Связь заказа с документом переживает исправление
Источник: справка Saby об идентификаторах и контроле исходящих документов, проверено 08.10.2026. Это предлагаемая модель хранения, а не список обязательных полей вашей системы.
Одному заказу могут соответствовать несколько документов. Постановка задачи ИИ-агенту должна назвать, ответ по какому из них нужен сотруднику.
3. Агенты пишут обмен, а человек управляет правами и подписью.
Для кода нужны описание API и вымышленные реквизиты той же структуры. Данные клиентов при разработке требуют отдельного решения.
Saby позволяет ограничить доступ пользователя документами своей организации. Приёмка проверяет разрешённый обмен и отказ за его пределами. Это права программы, а не агента для кода.
Документ подписывает сотрудник в Saby. Агент не получает ключ подписи. Эти правила для ИИ-агентов записывают до подключения рабочего аккаунта.
Право писать код не даёт права подписывать
Источник: настройка прав API Saby, проверено 08.10.2026; границы разработки и запрет автоподписи заданы предложением этой статьи.
4. Повтор и обрыв связи входят в приёмку.
Перед записью наша схема сохраняет ID документа. Если ответ потерялся, результат сверяют по этому ID. Повтор с новым ID рискует создать дубль.
«СБИС.СписокИзменений» возвращает события страницами. Справка требует сохранять отметку обработанного события. В нашей схеме её продвигают после записи результата в систему заказов.
Черновик без документооборота не попадёт в список изменений. Отсутствие события не доказывает отсутствие документа. Для сверки по ID есть «СБИС.ПрочитатьДокумент».
Для условной отгрузки нужно прервать обмен и повторить чтение. Связь с заказом должна сохраниться. Уже обработанное событие не должно сработать заново.
Обмен принимают после повторов и обрывов
Источник: «СБИС.ЗаписатьДокумент», «СБИС.СписокИзменений», контроль исходящих документов, проверено 08.10.2026. Испытания предложены нами; на клиентском аккаунте они не проводились.
5. Наш опыт подтверждает способ проверки, а не кейс Saby.
Ошибки преобразования данных уже встречались на нашем сайте. Инженер ведёт машину агентов и проверяет результат по сохранённым данным и поведению программы.
На 8 октября 2026 открытый счётчик нашей машины показывает 7 107 коммитов за 99 дней, с начала измерения 1 июля. Это разработка vibecoding.ru, не замер обмена с Saby.
Потерянное поле и неожиданный ответ требуют проверки контракта. Боевой шаг требует разрешения. Лента ниже показывает, откуда взялись эти правила.
Поломки стали правилами следующих задач
31.07
Поле сцены обложки терялось на двух из четырёх путей записи новости. Преобразование свели в одну функцию, проверки контролируют полноту полей и использование общего пути.
09.09
Агент переключил адрес боевого сайта без ожидаемого сигнала. Вреда не было. Для таких шагов стали задавать явное стоп-слово.
24.09
Новое поле ответа не попало в валидатор, при зелёных тестах страницы отдавали ошибку. Добавили проверку соответствия ответа валидатору.
Источник: записи журналов машины, сверены 08.10.2026. Это поломки vibecoding.ru, не инциденты документооборота Saby.
В курсе по агентной разработке этому посвящён урок «Одиннадцать шагов одной задачи». Результат интеграции принимают по состоянию в заказе, а не по ответу API.
6. Месячная подписка оплачивает работу, лицензии считают отдельно.
На 8 октября 2026 подписка на агентную разработку «Один проект» стоит 250 000 ₽ в месяц. Одна задача в работе, следующая ждёт. Пауза доступна в любой месяц.
Инженер с машиной агентов пишет передачу документов и возврат статусов по согласованному API. Код и проверки идут в репозиторий клиента. Приёмка проверяет идентификаторы и права.
Фикс за месяц не является ценой одной интеграции. Объём зависит от документов и API системы заказов. Лицензии сервисов и комиссии считают отдельно.
Месяц работы и лицензии считают отдельно
Источник: живой тариф /services на 08.10.2026; состав задачи и границы предложения заданы этой статьёй. Цена лицензии Saby не включена.
7. Начать стоит с одного документа и наблюдаемого обратного пути.
Для старта нужны тип документа, API системы заказов и пример ожидаемого ответа. Сначала согласуют, что сотрудник увидит по нашей условной отгрузке после ответа контрагента.
Первый результат сверяют на тестовых данных и испытывают обрывом связи. Если ID приходится подставлять вручную, обмен ещё не готов. Условная отгрузка должна пройти обратный путь.
Ответственный клиента подтверждает права и порядок подписания. Инженер проверяет обмен по выбранному документу. Ошибка остаётся видимой до исправления и повторной сверки.
Первый обмен принимают по этапам
Источник: предлагаемая последовательность приёмки по справке Saby, проверено 08.10.2026. Это этапы, а не обещание календарного срока.
Если вести разработку некому, обсудите задачу для компании. На звонке согласуют первый документ и приёмку.
Что и как мы проверяли
| Факт | Что известно | Проверено |
|---|---|---|
| API Saby | Прочитаны официальные страницы загрузки документа, идентификаторов, событий, редакций и прав. Проверяли справку; клиентский аккаунт и боевой обмен не испытывали. | 2026-10-08 |
| Сценарии приёмки | Условная отгрузка, повторы и обрывы предложены как проверки. Это не завершённая клиентская интеграция и не обещание срока. | 2026-10-08 |
| Машина vibecoding.ru | Живой /open: 7 107 коммитов за 99 дней с начала измерения 1 июля 2026. Снято 8 октября 2026 в 02:28 МСК. Коммиты не равны задачам. | 2026-10-08 |
| Цена работы | Живой /services: «Один проект», 250 000 ₽ в месяц, одна задача в работе, пауза в любой месяц. Снято 8 октября 2026 в 02:28 МСК. Лицензии Saby и комиссии отдельно. | 2026-10-08 |
| Истории поломок | Записи 31 июля, 9 и 24 сентября 2026 сверены по оригинальным журналам. В ленте поломки нашего сайта, а не Saby. | 2026-10-08 |
8. Частые вопросы
СБИС и Saby: какую документацию брать?+
Для описанного обмена использована текущая справка Saby об API ЭДО. В ней команды сохраняют префикс «СБИС», включая «СБИС.ЗаписатьДокумент» и «СБИС.СписокИзменений».
Можно вернуть статусы, оставив подписание в Saby?+
Да, такой сценарий описан в статье. Сотрудник подписывает и отправляет в Saby, программа получает события и обновляет состояние документа при заказе.
Нужно ли закрывать заказ после ответа контрагента?+
Это отдельное правило вашей системы. Состояние документа не подтверждает доставку товара или выполнение услуги. Основание для закрытия заказа согласуют отдельно.
Агенту придётся дать доступ к рабочему аккаунту?+
Для написания кода нужны контракт API и вымышленные примеры. Доступ программы обмена к рабочему аккаунту настраивают отдельно. Подписание и выдача прав остаются у клиента.
Можно гарантировать срок до изучения системы заказов?+
Мы не измеряли срок такой клиентской интеграции. Сначала нужно проверить API, документы и сценарии приёмки. Месячный тариф не задаёт срок завершения обмена.
Источники
- Saby: Порядок работы с API (проверено 08.10.2026) — официальная справка
- Saby: Подготовка и загрузка документа (проверено 08.10.2026) — официальная справка
- Saby: СБИС.ЗаписатьДокумент (проверено 08.10.2026) — официальная справка
- Saby: Идентификаторы документа, вложений и редакций (проверено 08.10.2026) — официальная справка
- Saby: Контроль состояния исходящих документов (проверено 08.10.2026) — официальная справка
- Saby: СБИС.СписокИзменений (проверено 08.10.2026) — официальная справка
- Saby: СБИС.ПрочитатьДокумент (проверено 08.10.2026) — официальная справка
- Saby: Права доступа для API (проверено 08.10.2026) — официальная справка
- vibecoding.ru: счётчик разработки с 1 июля 2026 и роль инженера (проверено 08.10.2026) — наш опыт
- vibecoding.ru: цена и условия подписки (проверено 08.10.2026) — наш опыт
- vibecoding.ru: программа курса (проверено 08.10.2026) — наш опыт
Запомнить
1. Принимайте обмен по возврату состояния в заказ, а не по удачной загрузке.
2. Сохраните связь заказа, документа и редакции. Проверьте старое событие.
3. Оставьте подписание сотруднику. Права программы обмена проверьте отдельно.
4. Включите в приёмку повтор, обрыв и отказ доступа. Ошибка должна быть видна.
5. Согласуйте первый документ и состав расходов. Месячная подписка оплачивает работу, лицензии и комиссии считают отдельно.