СБИС Коннект: Отправка документов — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
м (1 версия импортирована)
Строка 1: Строка 1:
Отправка документов является основной функцией утилиты [[CБИС Коннект]]. Существует множество режимов и опций позволяющих сделать этот процесс максимально просты и удобным для пользователей.
+
 
+
 
Для отправки документов СБИС Коннект выполняет следующие действия:
+
==Регламенты отправки==
==Алгоритм стандартной отправки документов (формат обмена - *.sbis.xml)==
+
===Стандартный (*.sbis.xml)===
 +
 
 +
Рекомендованный регламент для отправки документов, позволяет реализовать максимум возможностей СБИС Коннекта.
 +
Единицей передаваемой информации в системе СБИС является пакет документов (письмо), в который может входить произвольное количество документов. Пакет является неделимым целым, т.е. Ваш контрагент долж
 +
 
 +
Информационная система должна выгрузить в каталог Отправляемые XML документы регламентированных форматов, а также описание пакета документов.
 +
 
 +
 
 +
Наибольшая производительность СБИС Коннекта достигается если в одном XML файле выгружать несколько пакетов документов. Оптимальный размер файл
 +
 
 
# Сканирует папку Отправляемые и составляет список содержащихся в нем [[Конверт]]ов (файлов по маске *.sbis.xml).
 
# Сканирует папку Отправляемые и составляет список содержащихся в нем [[Конверт]]ов (файлов по маске *.sbis.xml).
 
# Читаем по очереди все [[Конверты]] из списка.  
 
# Читаем по очереди все [[Конверты]] из списка.  
Строка 18: Строка 27:
 
## Генерирует [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 13 - Загрузка на сервер
 
## Генерирует [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 13 - Загрузка на сервер
  
==Реакция СБИС Коннект на ошибки отправки==
+
Не всегда есть возможность выгрузить документы из учетной системы в регламентированном формате. [[СБИС Коннект]] умеет получать XML документы из файлов наиболее популярных форматов.
 +
 
 +
===Произвольный XML===
 +
 
 +
===Произвольный DBF===
 +
 
 +
Применяется если исходные данные для формирования документов выгружены в формате DBF.
 +
Алгоритм работы:
 +
# Информационная система выгружает dbf/csv файлы в каталог Отправляемые.
 +
# [[СБИС Коннект]] периодически будет составлять список XLS файлов в этой папке. И по очереди их обрабатывать
 +
## Переносит данные из XLS файла в промежуточный XML файл.
 +
## Конвертирует промежуточный XML файл в [[Конверт]] при помощи указанного в настройках регламента XSLT преобразованием
 +
# Передает полученный Конверт в стандартную процедуру отправки
 +
 
 +
Если при выгрузке данных придерживаться рекомендованного формата DBF/CSV файла, то можно воспользоваться готовыми XSLT преобразованиями для стандартных типов документов.
 +
 
 +
===Произвольный CSV===
 +
Регламент полностью аналогичен DBF. Строки в исходном CSV файле разбиваются по указанному в настройках разделителю на столбцы. В результате получается промежуточный файл.
 +
Формат промежуточного файла аналогичен формату промежуточного файла из регламента DBF.
 +
 
 +
===Произвольный XLS===
 +
Применяется если исходные данные для формирования документов выгружены в формате XLS (MS Excel), а также для [[массовой рассылки неформализованных документов по списку контрагентов из Excel таблицы]].
 +
Алгоритм работы аналогичен регламенту DBF.
 +
Пример промежуточного XML файла.
  
{| class="wikitable"
+
===по маске (Диадок)===
| Ошибки не связанные с данными пользователей (Отсутствует связь с сервером, системные ошибки не позволяющие в полном объеме выполнить все действия над Пакетом) || Приостанавливает отправку до устранения проблем на сервере, периодически проверяет возможность отправки
+
===по папке===
|-
 
| Ошибки связанные с исходными данными пользователей  (Файлы не прошли форматно-логический контроль, неверно указаны реквизиты Отправителя или Получателя [[Пакет]]а, отсутствует требуемая электронная подпись и т.п.)|| Пакеты загружаются в личный кабинет как ошибочные, информация об ошибке дублируется в лог ошибок, генерируется [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 12 - Ошибка отправки
 
|}
 
  
 
==Дополнительные возможности==
 
==Дополнительные возможности==
Строка 30: Строка 59:
 
===Подписание конкретной подписью или несколькими подписями===
 
===Подписание конкретной подписью или несколькими подписями===
  
==Отправка без Конвертов==
 
===Конвертируем произвольные DBF, CSV, Excel (XLS), XML файлы в XML документы===
 
Не всегда есть возможность выгрузить документы из учетной системы в нужном формате. [[СБИС Коннект]] умеет получать электронные XML документы из файлов наиболее популярных форматов.
 
От Вашей информационной системы только требуется выгрузить данные достаточные для формирования электронных документов в одном из поддерживаемых нами форматов, при этом желательно чтобы данные о документах одного пакета были в одном файле. Далее конвертация проходит в два этапа. Сначала данные переносятся в промежуточный XML документ, затем с помощью XSLT преобразования конвертируются в Конверт, после чего отправляются как обычные XML документы.
 
XSLT преобразование необходимое для подобной конвертации Вы можете разрабатывать и обслуживать самостоятельно.
 
 
   
 
   
  
====Конвертируем Excel (XLS) файлы в XML документы====
+
==Реакция СБИС Коннект на ошибки отправки==
  
# Включите в настройках [[регламент]] Произвольный XLS. Укажите подготовленное XSLT преобразование.
+
{| class="wikitable"
# СБИС Коннект будет составлять список файлов в папке с расширением XLS. И по очереди их обрабатывать
+
| Ошибки не связанные с данными пользователей (Отсутствует связь с сервером, системные ошибки не позволяющие в полном объеме выполнить все действия над Пакетом) || Приостанавливает отправку до устранения проблем на сервере, периодически проверяет возможность отправки
## Переносит данные из XLS файла в промежуточный XML файл
+
|-
## Конвертирует промежуточный XML файл в Конверт при помощи указанного в настройках XSLT преобразованием
+
| Ошибки связанные с исходными данными пользователей  (Файлы не прошли форматно-логический контроль, неверно указаны реквизиты Отправителя или Получателя [[Пакет]]а, отсутствует требуемая электронная подпись и т.п.)|| Пакеты загружаются в личный кабинет как ошибочные, информация об ошибке дублируется в лог ошибок, генерируется [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 12 - Ошибка отправки
# Передает полученный Конверт в стандартную процедуру отправки
+
|}
 
 
 
 
====Преобразование CSV файлов в Конверты====
 
====Преобразование DBF файлов в Конверты====
 
[[Рекомендованная структура для файлов формата DBF или CSV]]
 
  
===Группировка файлов в Пакеты по маске (Диадок)===
 
===Группировка файлов в Пакеты по папке===
 
 
[[Категория:СБИС Коннект]]
 
[[Категория:СБИС Коннект]]

Версия 02:47, 23 января 2015


Регламенты отправки

Стандартный (*.sbis.xml)

Рекомендованный регламент для отправки документов, позволяет реализовать максимум возможностей СБИС Коннекта. Единицей передаваемой информации в системе СБИС является пакет документов (письмо), в который может входить произвольное количество документов. Пакет является неделимым целым, т.е. Ваш контрагент долж

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


Наибольшая производительность СБИС Коннекта достигается если в одном XML файле выгружать несколько пакетов документов. Оптимальный размер файл

  1. Сканирует папку Отправляемые и составляет список содержащихся в нем Конвертов (файлов по маске *.sbis.xml).
  2. Читаем по очереди все Конверты из списка.
    1. Проверяем формат Конверта. Если проверка закончилась неудачно Конверт переносится в папку ОшибкиПодготовки.
    2. Разбиваем Конверт по Пакетам: Создаем в Папке ПодготовленныеКОтправке Конверты с одним Пакетом внутри, назначаем Пакету идентификатор спецоператора (если его не назначил пользователь).
    3. Удаляем исходный Конверт
  3. Читаем по очереди все Конверты из папки ПодготовленныеКОтправке
    1. Проверяем наличие перечисленных в Конверте внешних вложений. Если найдены не все вложения то Конверт переносится в конец очереди отправки (рекомендуется Конверт выгружать после выгрузки всех вложений).
    2. Если у тега Вложение заполнен атрибут XSLT - выполняется соответствующее преобразование.
    3. Загружает Пакет в кабинет.
    4. Определяет наличие необходимой электронной подписи, если явно не указана берется наиболее подходящая.
    5. Вызывает сервис проверки загруженного Пакета, файлы приводятся к соответствующим форматам (добавляются сведения об участниках документооборота и подписантах, имя файла переименовываются в соответствии с шаблоном).
    6. Подписывает файлы.
    7. Запускает Пакет в документооборот (Отправляет).
    8. Генерирует статус 13 - Загрузка на сервер

Не всегда есть возможность выгрузить документы из учетной системы в регламентированном формате. СБИС Коннект умеет получать XML документы из файлов наиболее популярных форматов.

Произвольный XML

Произвольный DBF

Применяется если исходные данные для формирования документов выгружены в формате DBF. Алгоритм работы:

  1. Информационная система выгружает dbf/csv файлы в каталог Отправляемые.
  2. СБИС Коннект периодически будет составлять список XLS файлов в этой папке. И по очереди их обрабатывать
    1. Переносит данные из XLS файла в промежуточный XML файл.
    2. Конвертирует промежуточный XML файл в Конверт при помощи указанного в настройках регламента XSLT преобразованием
  3. Передает полученный Конверт в стандартную процедуру отправки

Если при выгрузке данных придерживаться рекомендованного формата DBF/CSV файла, то можно воспользоваться готовыми XSLT преобразованиями для стандартных типов документов.

Произвольный CSV

Регламент полностью аналогичен DBF. Строки в исходном CSV файле разбиваются по указанному в настройках разделителю на столбцы. В результате получается промежуточный файл. Формат промежуточного файла аналогичен формату промежуточного файла из регламента DBF.

Произвольный XLS

Применяется если исходные данные для формирования документов выгружены в формате XLS (MS Excel), а также для массовой рассылки неформализованных документов по списку контрагентов из Excel таблицы. Алгоритм работы аналогичен регламенту DBF. Пример промежуточного XML файла.

по маске (Диадок)

по папке

Дополнительные возможности

Рассылка документов

Подписание конкретной подписью или несколькими подписями

Реакция СБИС Коннект на ошибки отправки

Ошибки не связанные с данными пользователей (Отсутствует связь с сервером, системные ошибки не позволяющие в полном объеме выполнить все действия над Пакетом) Приостанавливает отправку до устранения проблем на сервере, периодически проверяет возможность отправки
Ошибки связанные с исходными данными пользователей (Файлы не прошли форматно-логический контроль, неверно указаны реквизиты Отправителя или Получателя Пакета, отсутствует требуемая электронная подпись и т.п.) Пакеты загружаются в личный кабинет как ошибочные, информация об ошибке дублируется в лог ошибок, генерируется статус 12 - Ошибка отправки