Документооборот с контрагентами

Получить документы и проверить их состояние в API

Получить документы и проверить их состояние в API

Изменения в документообороте по входящим документам отражаются в наборе событий. События возвращаются возвращаются в результате выполнения команды «СБИС.СписокИзменений».

Например, при поступлении входящего документа сервером online.sbis.ru было сгенерировано событие «Получение». Нужно загрузить все входящие вложения (первичные и служебные) и сохранить под каждым вложением связанные с этим событием ЭП.

  1. Выполните команду «СБИС.СписокИзменений», чтобы получить список измененных документов, по которым произошли события документооборота в СБИС.
  2. Если получено событие:
    • не по входящему или исходящему документу («Документ.Направление»≠«Входящий»/«Исходящий») — пропустите его;
    • с извещением об удалении документа противоположной стороной («Документ.Событие.Название»=«Уведомление об удалении на стороне отправителя») — остановите документооборот и пометьте документ в вашей ИС как удаленный;
    • с запросом на аннулирование («Документ.Событие.Название»=«Получение соглашения об аннулировании») — предусмотрите в вашей системе возможность ответа. Для этого добавьте в систему возможность запросить ответственного по документу на подтверждение/отклонение аннулирования;
    • со значением поля «Документ.Событие.Название» отличными от «Получение» — пропустите его.
  3. Убедитесь, что ваша система поддерживает версионность документов (несколько редакций).
  4. Поддерживает версионность
    Не поддерживает версионность
    • С помощью поля «Документ.Идентификатор» выполните поиск и определите наличие предыдущих редакций документа в вашей системе.
    • Если редакции найдены, пометьте их как неактуальные. При необходимости, синхронизируйте состояния редакции документа в вашей системе и СБИС с помощью «СБИС.ПрочитатьДокумент» с адресацией по полю «Документ.Редакция.Идентификатор».
    • Зарегистрируйте новую редакцию документа по полю «Документ.Редакция.Идентификатор».
  5. Загрузите вложения входящего документа в вашу информационную систему.

Комментарий

С событием может быть ассоциирована одна или несколько ЭП («Документ.Вложение.Ссылка» — пустая, а «Документ.Вложение.Подпись.Ссылка» — не пустая). Это означает, например, отправку подписи под первичным документом при утверждении.

Чтобы получить содержимое вложения, выполните GET-запрос по URL-адресу в поле «Документ.Событие.Вложение.Ссылка».

Для получения содержимого ЭП, выполните GET-запрос по URL-адресу в поле «Документ.Событие.Вложение.Подпись.Ссылка».

«Документ.Состояние» описывает состояние для редакции, по которой зарегистрировано событие. Учитывайте это при обработке события.

Описанные алгоритмы работы могут не охватывать все возможные действия, которые нужны для полноценной интеграции вашей ИС.

Лицензия

Тарифы «Обмен с контрагентами» и «Внедрение ЭДО» сервиса «Электронный документооборот».