КОНТРОЛЬ СОСТОЯНИЯ ДОКУМЕНТОВ ЧЕРЕЗ СБИС КОННЕКТ

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

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

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

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

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

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

Примеры конвертов: sbis.xmlnative.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  —  элемент "Редакция", код "Идентификатор").

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

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. Удаляет обработанные файлы конвертов.​

Если в каталоге «Состояние» количество файлов привысит 2000 в СБИС Коннект появится ошибка «Выгрузка статусов невозможна, достигнуто ограничение в 2000 файлов для папки C:\СБИС Коннект\Состояния». В этом случае выгрузка архива, статусов и входящих будет приостановлена. Если вы не планируете отслеживать статусы документов, рекомендуем отключить выгрузку статусов.

0
0
Оставьте свой отзыв:
ОТПРАВИТЬ