СБИС / SABY ЭДО

СБИС / SABY ЭДО подключает электронный документооборот к исходящим документам SNABZHENETS+: счетам клиенту, договорам и документам поставки.

После включения интеграции в карточках документов появляется виджет СБИС / SABY. Через него пользователь может отправить сформированный PDF или DOCX контрагенту, увидеть ID документа в SABY, последнее событие, статус доставки и статус подписи.

Если у клиента одновременно подключены СБИС / SABY ЭДО и Контур.Диадок, в карточке документа отображается единый блок ЭДО с выбором оператора. Пользователь выбирает СБИС / SABY перед отправкой или проверкой статуса, а S+ хранит состояние SABY отдельно от состояния Диадок.

Интеграция работает через официальный API СБИС/SABY ЭДО: S+ авторизуется в SABY, создаёт документ методом записи, при необходимости выполняет действие отправки и затем читает изменения документооборота обратно.

Где используется

Виджет SABY доступен в:

• карточке исходящего счёта клиенту;
• карточке договора;
• истории документов поставки в логистике.

Если документ связан с контрагентом, S+ подставляет название, ИНН и КПП. Пользователь может указать ID участника SABY вручную или отправить документ по реквизитам контрагента, если такой сценарий поддерживается настройками SABY.

Что передаётся

Данные	Направление
PDF или DOCX документа S+	из S+ в SABY
Реквизиты вашей организации	из S+ в SABY
ID участника, ИНН/КПП и название контрагента	из S+ в SABY
ID документа, редакции и вложения	из SABY в S+
Ссылка на документ в SABY	из SABY в S+
Последнее событие, статус документа и статус подписи	из SABY в S+

Секреты авторизации, пароль, настройки подключения, raw-ответы SABY и файловые хэши не показываются пользователям и не доступны в переменных документов.

Подключение

1. Откройте Интеграции → Маркетплейс.
2. Найдите СБИС / SABY ЭДО в категории ЭДО и документы.
3. Установите интеграцию.
4. Укажите номер телефона в формате +7... или email для входа в SABY, пароль SABY, ИНН вашей организации и при необходимости КПП.
5. Если у вашей организации несколько аккаунтов или направлений обмена, заполните номер аккаунта, ID участника или название организации.
6. Проверьте тип документа, тип вложения и действие отправки. По умолчанию S+ отправляет неформализованный PDF/DOCX.
7. Включите запрос подписи получателя, если документ должен быть подписан контрагентом.
8. Проверьте соединение и включите интеграцию.

Для подключения нужен аккаунт SABY с доступом к ЭДО вашей организации. Если в компании используются отдельные маршруты или формализованные типы документов, согласуйте значения полей с администратором SABY.

Отправка документа

1. Откройте счёт, договор или документ поставки.
2. В блоке СБИС / SABY проверьте получателя. Если открыт общий блок ЭДО, сначала выберите вкладку СБИС / SABY.
3. Укажите ID участника SABY, если он известен, или оставьте ИНН/КПП контрагента.
4. При необходимости добавьте комментарий.
5. Нажмите Отправить.
6. После отправки S+ сохранит ID документа SABY, имя файла, дату отправки и текущий статус.

Если в настройках включена автоматическая отправка, S+ после создания документа сразу выполняет действие отправки в SABY. Если автоматическая отправка выключена, документ создаётся в SABY и остаётся готовым к дальнейшему действию по правилам вашего ЭДО.

Двусторонние статусы

S+ отправляет документ в SABY и получает состояние документооборота обратно. В карточке документа отображаются:

• Черновик;
• Готов к отправке;
• Отправлено;
• Доставлено;
• На подписи;
• Подписано;
• Отказано;
• Отменено;
• Ошибка.

Статус можно обновить кнопкой Статус в виджете. Для установленной интеграции также доступна ручная синхронизация: S+ запрашивает список изменений SABY и обновляет известные документы, а входящие или ещё не привязанные документы сохраняет как входящие события ЭДО.

Когда счёт отправлен через SABY, S+ переводит исходящий счёт в статус Отправлен, если он ещё не находится в финальном состоянии.

Когда договор подписан в SABY, S+ переводит договор в статус Подписан, если договор ещё не закрыт, не отменён и не архивирован.

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

Для счетов, договоров и документов поставки доступны переменные:

• saby.status;
• saby.signatureStatus;
• saby.statusText;
• saby.statusDetails;
• saby.documentId;
• saby.revisionId;
• saby.attachmentId;
• saby.counterpartyParticipantId;
• saby.counterpartyName;
• saby.counterpartyInn;
• saby.counterpartyKpp;
• saby.lastEventId;
• saby.lastEventName;
• saby.sentAt;
• saby.syncedAt;
• saby.signedAt.

Их можно использовать в шаблонах и через Variable API. Например:

Статус СБИС: {{saby.statusText|default:документ ещё не отправлен}}
ID документа СБИС: {{saby.documentId|default:нет}}

Ограничения

• Для отправки нужен доступ пользователя к экспорту соответствующего документа.
• Если у контрагента нет ИНН/КПП или в SABY несколько подходящих участников, укажите ID участника вручную.
• Для формализованных документов тип, маршрут и действие должны соответствовать правилам SABY и договорённостям с контрагентом.
• Если SABY возвращает незнакомое состояние, S+ показывает его как неизвестный статус и сохраняет текст события для ручной проверки.

Официальная документация API SABY ЭДО: saby.ru/help/integration/api/edo.