Калуга Астрал ЭДО

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

После включения интеграции в карточках документов появляется виджет Калуга Астрал. Через него пользователь может загрузить сформированный PDF или DOCX в Астрал.ЭДО, выбрать получателя из адресной книги, отправить документ контрагенту, увидеть DraftId, DocflowId, DocumentId, последнее событие и статус подписи.

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

Интеграция работает через официальный API Калуга Астрал: S+ создаёт черновик документа, заполняет метаданные получателя, запускает отправку по настройке и затем читает события документооборота обратно.

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

Виджет Калуга Астрал доступен в:

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

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

Если интеграция Калуга Астрал не подключена или отключена, виджет этого оператора не отображается в документах.

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

Данные	Направление
PDF или DOCX документа S+	из S+ в Калуга Астрал
abonentId вашей организации	из S+ в Калуга Астрал
recipientId, ИНН/КПП и название контрагента	из S+ в Калуга Астрал
DraftId, DocflowId, DocumentId	из Калуга Астрал в S+
Последнее событие, статус документа и статус подписи	из Калуга Астрал в S+
Входящие события по новым документооборотам	из Калуга Астрал в S+

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

Подключение

1. Откройте Интеграции → Маркетплейс.
2. Найдите Калуга Астрал ЭДО в категории ЭДО и документы.
3. Установите интеграцию.
4. Укажите API-токен Калуга Астрал и abonentId вашей организации.
5. При необходимости измените URL API. По умолчанию используется https://api.doc.astral.ru.
6. Если у вашей организации есть подразделение или маршрут отправки, заполните departmentId.
7. Выберите режим загрузки: обычный импорт или withoutModify, если документ нужно передавать без модификации.
8. Включите автоматическую отправку после загрузки, если документ должен уходить контрагенту сразу после создания черновика.
9. Включите запрос подписи получателя, если документ должен быть подписан контрагентом.
10. Проверьте соединение и включите интеграцию.

Для подключения нужен действующий доступ к API Калуга Астрал и abonent, от имени которого разрешено создавать черновики, отправлять документы и читать события документооборота.

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

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

Если автоматическая отправка включена, S+ после загрузки черновика сразу передаёт метаданные получателя и запускает отправку. Если Астрал требует подпись отправителя перед отправкой, документ остаётся в статусе На подписи, а в виджете отображается запрос подписи.

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

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

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

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

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

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

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

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

• astral.status;
• astral.signatureStatus;
• astral.statusText;
• astral.statusDetails;
• astral.direction;
• astral.senderAbonentId;
• astral.recipientId;
• astral.draftId;
• astral.docflowId;
• astral.documentId;
• astral.signingRequestId;
• astral.counterpartyName;
• astral.counterpartyInn;
• astral.counterpartyKpp;
• astral.lastEventId;
• astral.lastEventName;
• astral.sentAt;
• astral.syncedAt;
• astral.signedAt.

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

Статус Астрал: {{astral.statusText|default:документ ещё не отправлен}}
DocflowId: {{astral.docflowId|default:нет}}

Ограничения

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

Официальная документация API Калуга Астрал: info.edo.astral-dev.ru/docs/main/api/intro.