Контроль состояния документов через СБИС Коннект

Для того чтобы отслеживать прохождение документов, необходимо "научить" вашу информационную систему обновлять состояние документа по данным файла конверта, который СБИС Коннект выгружает в каталог «Состояние».

Формат файла конверта

Файл конверта со списком статусов документов содержит следующую информацию:

• данные о пакете документов — идентификатор пакета, ИНН/КПП отправителя и получателя, дату отправки и т.д.;
• код состояния обработки пакетов документов;
• время формирования документов в случае, если документ был утвержден/отклонен или был сформирован на стороне контрагента.

Стандартные форматы:

Файл со списком статусов — это обычный конверт, в котором в обязательном порядке заполнен блок, описывающий состояние пакета. Соответственно список статусов может быть выгружен СБИС Коннектом в любом из стандартных форматов конверта:

• формат native.xml (произвольный xml)
• формат sbis.xml

Примеры конвертов: sbis.xml, native.xml (с загрузкой документов), native.xml (без загрузки документов).

Нестандартные форматы статусов:

Если ваша система не может загрузить информацию о статусах из xml-файла стандартного формата, СБИС Коннект может выгрузить список состояний входящих/исходящих документов в одном из следующих форматов:

• произвольный csv-файл — с помощью xslt-преобразования конверт из стандратного формата будет преобразован в csv-файл;
• dbf-файл фиксированного формата — без дополнительных преобразований СБИС Коннект выгрузит конверт со списком статусов в dbf-файл фиксированного формата;
• произвольный dbf-файл — аналогично произвольному csv-файлу, dbf-файл будет сформирован с помощью xslt-преобразования из стандартного конверта.

Для форматов native.xml, произвольный CSV(*.dbf), произвольный DBF(*.dbf) в файл статуса могут подгружаться документы, по которым сгенерировано изменение и соответственно выгружен статус.

Алгоритм обработки статусов документов

Информационная система следует определенному алгоритму обработки статусов документов:

1. В каталоге «Состояние» отслеживает появление новых файлов конвертов.
2. Обрабатывает файлы конвертов одним из способов:
   • по дате создания файлов в каталоге — от самого "старого" файла конверта к более новому. Дата и время установки состояния на документе, которое принес файл статуса определяется по значениям атрибутов:
     • для sbis.xml — "Реестр.Пакет.ДатаВремяФормирования".
     • для native.xml — "Документ.СписокСобытие.Событие.ДатаВремя".
   • либо по приоритету событий документооборота — начиная обработку с файлов, в которых приоритет события самый высокий (найболее высокий приоритет имеют события внизу списка).
3. Определяет состояние пакета с документами — по коду состояния.
4. Находит идентификатор пакета, к которому относятся данное состояние.
5. Отображает состояние документов в вашей информационной системе.
6. Удаляются обработанные файлы конверта.

Рассмотрим два способа обработки файлов конверта:

1. По дате создания:

Ваша информационная система:

1. Отслеживает появление новых файлов в каталоге «Состояние». Например, по двум документам появилось пять файлов конвертов:
   • файл 1 (от 01.01.17) по документу №1 — код состояния "3"
   • файл 2 (от 03.01.17) по документу №1 — код состояния "4"
   • файл 3 (от 02.01.17) по документу №2 — код состояния "1"
   • файл 4 (от 06.01.17) по документу №2 — код состояния "7"
   • файл 5 (от 04.01.17) по документу №1 — код состояния "7"
2. Сортирует файлы по дате создания их в каталоге — от самого "старого" файла конверта к более новому:
   • файл 1 (от 01.01.17) по документу №1 — код состояния "3"
   • файл 3 (от 02.01.17) по документу №2 — код состояния "1"
   • файл 2 (от 03.01.17) по документу №1 — код состояния "4"
   • файл 5 (от 04.01.17) по документу №1 — код состояния "7"
   • файл 4 (от 06.01.17) по документу №2 — код состояния "7"

3. Документ определяется по:

   «Идентификатору комплекта документов» (для sbis.xml — элемент "ИдДокСпецоператора", для native.xml — элемен "Документ", код "Идентификатор");
   или «Пользовательскому идентификатор комплекта документов» (для sbis.xml — элемент "ИдДок", для native.xml — элемент "Редакция", код "Идентификатор").

4. Отображает состояние документов в вашей системе в следующем порядке:
   • для документа №1:
     • "3" — "Отправлен"
     • "4" — "Доставлен"
     • "7" —"Выполнение завершено успешно"
   • для документа №2:
     • "1" — "Есть документ"
     • "7" —"Выполнение завершено успешно"

Дата и время установки состояния на документе, которое принял файл статуса определяется по значениям атрибутов:

• для sbis.xml — "Реестр.Пакет.Событие.ДатаВремяФормирования".
• для native.xml — "Документ.СписокСобытие.Событие.ДатаВремя".

Документ определяется по:

«Идентификатору комплекта документов» (для sbis.xml — элемент "ИдДокСпецоператора", для native.xml — элемен "Документ", код "Идентификатор");
или «Пользовательскому идентификатор комплекта документов» (для sbis.xml — элемент "ИдДок", для native.xml — элемент "Редакция", код "Идентификатор").

5. Удаляет обработанные файлы конвертов.

2. По приоритету событий документооборота

Ваша информационная система:

1. Отслеживает появление новых файлов в каталоге «Состояние». Например, по двум документам появилось пять файлов конвертов:

   • файл 4 (от 06.01.17) по документу №2 — код состояния "7"

   • файл 2 (от 03.01.17) по документу №1 — код состояния "4"

   • файл 3 (от 02.01.17) по документу №2 — код состояния "1"

   • файл 1 (от 06.01.17) по документу №2 — код состояния "7"

   • файл 5 (от 04.01.17) по документу №1 — код состояния "7"

2. Для каждого файла конверта идентифицирует документ и находит к какому состоянию он относится. В зависимости от кода состояния в файле конверта определяется его приоритет. Если код состояния из конверта больше, чем текущеее значение состояния документа в вашей информационной системе — необходимо изменить его.
3. Удаляет обработанные файлы конвертов.​