Определение наличия новых документов в системе
Для получения своевременной информации о поступлении новых входящих документов и получения статуса по исходящим документам необходимо настроить чтение ленты событий.
При первичной настройке интеграции необходимо получить идентификатор последнего события: /v2/docflow/events/get-last-event-id. Также данный метод полезен для синхронизации вашего приложения с актуальными данными, чтобы не пропустить важные изменения. Если для клиента, чей токен указан в заголовке, в системе отсутствуют документы, либо не настроен API, то вернется пустой ответ.
В зависимости от объема документооборота необходимо настроить регулярный вызов метода /v2/docflow/events/{id}, чтобы своевременно получать информацию о поступающих документах в систему. В качестве id необходимо передавать значение из ответа /v2/docflow/events/get-last-event-id или идентификатор последнего события, который был получен в предыдущем вызове /v2/docflow/events/{id}.
По id документов, которые получены в ленте, можно запросить дополнительную информацию, чтобы:
-
Увидеть ошибки по исходящим документам (если у исходящего документа статус ERROR).
-
Получить информацию о МЧД по входящим документам.
-
Получить информацию об участниках документооборота.
Для этого нужно воспользоваться методом /v2/doc/{id}.