Просмотр исходного текста страницы СБИС Коннект: Отправка документов



==Регламенты отправки==
===Стандартный (*.sbis.xml)===

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

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


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

# Сканирует папку Отправляемые и составляет список содержащихся в нем [[Конверт]]ов (файлов по маске *.sbis.xml).
# Читаем по очереди все [[Конверты]] из списка. 
## Проверяем формат [[Конверт]]а. Если проверка закончилась неудачно Конверт переносится в папку ОшибкиПодготовки.
## Разбиваем [[Конверт]] по Пакетам: Создаем в Папке ПодготовленныеКОтправке Конверты с одним Пакетом внутри, назначаем Пакету идентификатор спецоператора (если его не назначил пользователь).
## Удаляем исходный [[Конверт]]
# Читаем по очереди все Конверты из папки ПодготовленныеКОтправке
## Проверяем наличие перечисленных в Конверте внешних вложений. Если найдены не все вложения то Конверт переносится в конец очереди отправки (рекомендуется Конверт выгружать после выгрузки всех вложений).
## Если у тега Вложение заполнен атрибут XSLT - выполняется соответствующее преобразование.
## Загружает Пакет в кабинет.
## Определяет наличие необходимой электронной подписи, если явно не указана берется наиболее подходящая.
## Вызывает сервис проверки загруженного [[Пакет]]а, файлы приводятся к соответствующим форматам (добавляются сведения об участниках документооборота и подписантах, имя файла переименовываются в соответствии с шаблоном).
## Подписывает файлы. 
## Запускает Пакет в документооборот (Отправляет).
## Генерирует [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 13 - Загрузка на сервер

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

===Произвольный XML===
Если по какой то причине Вы не можете или не хотите выгружать данные в регламентированном формате. 

Например если из одного набора данных делаются все печатные формы, или Ваша система не поддерживает кириллицу, или Вы не хотите следить за изменениями в требованиях к формата электронных документов. 

То вы можете выгрузить в каталог Отправляемые произвольный XML файл.


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

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

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

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

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

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

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

===По маске===
Иногда у системы клиента нет возможности сформировать Конверт. Но систему уже научили выгружать xml или неформализованные документы для отправки, например через других операторов. Данный регламент позволяет объединить файлы в пакет на основании общих реквизитов в имени файла. 

Имя файла при выгрузке из информационной системы клиента желательно формировать по шаблону «R_T_A_O_GGGGMMDD_N». Где:
•	R_T - префикс имени файла, принимающий значение ON_SFAKT, ON_SAVA, ON_SPEN, ON_ASVER, ON_SOP, ON_APRIPER, ON_VEDPOK, DP_OTORG12 и пр.
•	А - идентификатор получателя счета-фактуры (покупатель), где идентификатор получателя совпадает с идентификатором участника электронного документооборота в рамках выставления и получения счетов-фактур; в качестве идентификатора может использоваться пара ИНН/КПП (записывается слитно)
•	О - идентификатор отправителя счета-фактуры, где идентификатор отправителя совпадает с идентификатором участника электронного документооборота в рамках выставления и получения счетов-фактур; в качестве идентификатора может использоваться пара ИНН/КПП (записывается слитно)
•	GGGG - год формирования передаваемого файла, MM - месяц, DD - день;
•	N - 36 символьный глобально уникальный идентификатор GUID (Globally Unique IDentifier).

Параметры регламента:

Маска файлов – указывается маска, по которой СБИС Коннект будет искать файлы в каталоге Отправляемые. В маске можно использовать обычные символы, например если задать маску "123_A_O_*", то будут отобраны файлы, начинающиеся с "123_"

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

ON_SFAKT_2BE7cb1ebb6f8d811e1925d9b6b0b63404e_2BE75700500fd1611b2bcba83f15e3510d5_20130415_dee97884-5c30-b4b9-0996-981960b2c823.xml

Пример имени файла с указанием ИНН/КПП участников документооборота:

ON_SFAKT_1211111135000000000_1111111237000000000_20130415_dee97884-5c30-b4b9-0996-981960b2c824.xml

Алгоритм работы СБИС Коннекта:
# Ждет пока прекратится выгрузка в каталог отправки (По умолчанию это отсутствие активности в течении 1 минуты).
# Берет первый попавшийся файл в каталоге «Отправляемые».
# Получает из имени файла значения элементов R_T_A_O_GGGGMMDD_N.
# По заданной пользователем маске и по значениям из п.2 ищет файлы для формирования пакета.
## Если в параметрах регламента не указано XSLT преобразование, то на основании идентификаторов участников документооборота или ИНН/КПП из имени первого файла определяет Отправителя Получателя пакета документов, формирует Конверт передает его стандартному регламенту.
## Если в параметрах регламента указано XSLT преобразование, то СБИС Коннект формирует [Конверт] из найденных файлов и применяет к нему указанное преобразование, а результат выполнения передает стандартному регламенту.

===По папке===
Иногда у системы клиента нет возможности сформировать Конверт. Но систему уже научили выгружать xml или неформализованные документы для отправки, например через других операторов. Данный регламент позволяет объединить файлы в пакет на основании нахождения из в одном каталоге. 

Алгоритм работы:
# Информационная система клиента должна выгрузить документы отправляемые в одном пакете в отдельную папку каталога Отправляемые (вложенность папок в данном случае значения не имеет). Например может получиться следующая структура:
*Отправляемые
**Папка1
***Файл1.xml
***Файл2.pdf
**Папка2
***Папка4
****Файл5.xml
****Папка5
*****Файл6.xml
*****Файл7.pdf
# СБИС Коннект Ждет пока прекратится выгрузка в каталог отправки (По умолчанию это отсутствие активности в течении 1 минуты).
# СБИС Коннект перебирает все папки начиная с самой «глубокой» (максимальная вложенность). Перебирает в каждой папке все файлы и формирует из них Конверт:
# К каждому Конверту применяет указанное в настройках регламента XSLT преобразование. 
# В результате преобразования должен быть сформирован Конверт который обрабатывается по стандартному регламенту, а исходная папка со всеми файлами удаляется.

Пример [Конверт]а сформированного из папки:

<source lang="xml">
<?xml version="1.0" encoding="windows-1251"?>
<Реестр>
    <Пакет ИдДок="Папка5">
        <Вложение ИмяФайла="Файл6.xml">
            <Содержимое Файла6.xml”>
        </Вложение>
        <Вложение ИмяФайла="Файл7.pdf ">
            <Содержимое Файла7.pdf в виде строки закодированной в Base64”>
        </Вложение>
    </Пакет>
</code>

==Дополнительные возможности==
===[[Массовая рассылка при помощи СБИС Коннект|Рассылка документов]]===

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

 

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

{| class="wikitable"
| Ошибки не связанные с данными пользователей (Отсутствует связь с сервером, системные ошибки не позволяющие в полном объеме выполнить все действия над Пакетом) || Приостанавливает отправку до устранения проблем на сервере, периодически проверяет возможность отправки
|-
| Ошибки связанные с исходными данными пользователей  (Файлы не прошли форматно-логический контроль, неверно указаны реквизиты Отправителя или Получателя [[Пакет]]а, отсутствует требуемая электронная подпись и т.п.)|| Пакеты загружаются в личный кабинет как ошибочные, информация об ошибке дублируется в лог ошибок, генерируется [[СБИС Коннект: Обратная связь#Коды статусов|статус]] 12 - Ошибка отправки
|}

[[Категория:СБИС Коннект]]