Конверт
Функция «Конверт» предназначена для обработки файлов конвертов с реестром документов формата sbis.xml после 01.01.2015 года:
- отправка пакета с документами контрагенту;
- аннулирование документа;
- запрос на аннулирование документа;
- подтверждение аннулирования документа.
Описание формата сбис-конверта
Элемент Реестр состоит из множества элементов Пакет.
Каждый элемент Пакет содержит данные по отправке документов или данные для аннулирования документов.
<?xml version="1.0" encoding="windows-1251"?>
<Реестр>
<Пакет ДатаДок="28.12.2010" ТипДок="ДокОтгрИсх" ИдДок="31" НомерДок="55">
<Получатель ИНН="1111111199" КПП="000000000" Название="Лютик"/>
<Отправитель ИНН="1111111188" КПП="000000000">
<Подразделение Код="0006"/>
</Отправитель>
<Вложение ИмяФайла="ON_SFAKT_1001009551104050001_1001009551104050001_1001000598104050001_20111124_1398c8656527.xml">
<Файл ИдФайл="ON_SFAKT_1001009551104050001_1001009551104050001_1001000598104050001_20111124_1398c8656527" ВерсПрог="2" ВерсФорм="5.01">
<Документ КНД="1115101">
<Подписант ПрПодп="1">
<ФИО Фамилия="Груздева" Имя="Елена" Отчество="Витальевна"/>
</Подписант>
<СвСчФакт НомерСЧ="К0000252" ДатаСЧ="30.09.2011" НомерПРС="23" ДатаПРС="01.02.2012">
<СведПокуп>
<РегСвед>
<СведЮЛ НаимОрг="ЗАО "Карелтрансгаз"" ИННЮЛ="1001009551" КПП="104050001"/>
</РегСвед>
<АдресСвед>
<АдрПокупРФ КодРегион="35" Город="Вологда" Улица="Мира" Дом="22"/>
</АдресСвед>
</СведПокуп>
<СведПрод>
<РегСвед>
<СведЮЛ НаимОрг="Открытое акционерное общество "Карелгаз"" ИННЮЛ="1001000598" КПП="104050001"/>
</РегСвед>
<АдресСвед>
<АдрПокупРФ Индекс="185011" КодРегион="10" Город="Петрозаводск г" Улица="Балтийская ул" Дом="22а"/>
</АдресСвед>
</СведПрод>
</СвСчФакт>
<ТаблСчФакт СумНДСВс="0.00" СтТРУУчНалВс="33630.00" ОКВ_СФ="643">
<СведТРУ НаимТРУ="АДО внутренних систем газоснабжения" КолТРУ="1.00000" ЦенаТРУ="33630.00" СтТРУБезНДС="28500.00" НалСтав="18.00" СумНДС="5130.00" СтТРУУчНал="33630.00" СтрПроисх=" " КодПроисх=" " НомерТД=" "/>
</ТаблСчФакт>
</Документ>
</Файл>
</Вложение>
</Пакет>
<Пакет ДатаДок="28.12.2010" ТипДок="ДокОтгрИсх" ИдДок="31" НомерДок="55">
<Получатель ИНН="7714016580" КПП="7714016580"/>
<Отправитель ИНН="1111111188" КПП="000000000"/>
<Вложение ИмяФайла="ON_ACCOUNTS_7714016580_7714016580_7701002626_28122010.pdf"/>
<Вложение ИмяФайла=" ON_SFAKT_7714016580_7714016580_7701002626_28122010.pdf"/>
</Пакет>
<Пакет ИдДокСпецоператора="5b5c31c7-bd06-4e6a-8028-3265744576e2"> // ИдДокСпецоператора содержит идентификатор пакета в Диадоке — messageId <Команда Название="ЗапроситьАннулирование">
<Параметр Название="Примечание" Значение="Запрос аннулирования со стороны отправителя"/>
</Команда>
</Пакет>
</Реестр>Загрузка документов в Диадок
Файл конверта определяется по имени, которое задается произвольным образом. В качестве шаблона в имени файла можно использовать специальный символ «*», обозначающий любое количество символов в имени или расширении. Например, «*.sbis.xml» может удовлетворять файлам: «KONVERT.sbis.xml», «KONVERT_032609359328_7536066430032345002_20200415_9586ccb4ae5c.sbis.xml».
- В шаблоне должен присутствовать один непробельный символ, кроме «*».
- Шаблон, состоящий из одного символа «*», считается некорректным.
Файлы конвертов и файлы документов могут быть размещены в локальной или сетевой папке.
Документы, указанные в одном элементе Реестр/Пакет в файле конверта, группируются в пакет и отправляются получателю одним сообщением.
Получатель документа определяется по ИНН-КПП, указанным в Реестр/Пакет/Получатель[@ИНН='<ИНН>'] и Реестр/Пакет/Получатель[@КПП='<КПП>']. Логика определения получателя совпадает с той, что указана в Коннекторе.Доставка.
Ящик и подразделение отправителя определяется по ИНН-КПП, указанным в Реестр/Пакет/Отправитель[@ИНН='<ИНН>'] и Реестр/Пакет/Отправитель[@КПП='<КПП>'].
Если подразделение не найдено, то документ попадет в ящик получателя с указанным ИНН или парой ИНН-КПП.
Коннектор предусматривает следующие варианты загрузки документов в Диадок:
- Черновики.
- Исходящие для последующей отправки и подписания.
- Подписание и оправка документов получателям. Потребуется обязательная авторизация пользователя в коннекторе по сертификату.
Если документ подписывается сертификатом физлица, выполните настройки по работе с доверенностями.
- Отправка получателю без подписания.
Коннектор предусматривает обязательное архивирование обработанных файлов конвертов, как успешно обработанных, так и необработанных файлов, в соответствующие локальные папки. Опционально доступно архивирование на SFTP/FTP-сервер.
Поддерживаемые типы документов.
Аннулирование документов в Диадоке
В формате конверта предусмотрена возможность аннулирования документов. Чтобы выполнить аннулирование, выгрузите из учетной системы файл конверта, в котором будет указана информация о документах/пакетах, требующих аннулирования.
Например, через коннектор в Диадок был загружен пакет с документами:
<?xml version="1.0" encoding="windows-1251"?> <Реестр> <Пакет ДатаДок="28.12.2010" ТипДок="ДокОтгрИсх" ИдДок="45673945" НомерДок="55"> <Получатель ИНН="7714016580" КПП="7714016580"/> <Отправитель ИНН="1111111188" КПП="000000000"/> <Вложение ИмяФайла="ON_ACCOUNTS_7714016580_7714016580_7701002626_28122010.pdf"/> <Вложение ИмяФайла="Протокол согласования.pdf"/> </Пакет> </Реестр>При загрузке документа в Диадок:
- В метаинформацию по каждому документу был записан идентификатор пакета «ИДДок» со значением «45673945» из поля Реестр.Пакет.ИдДок.
- Автоматически сформировался идентификатор пакета системы Диадок messageId со значением «5b5c31c7-bd06-4e6a-8028-3265744576e2».
Далее указаны примеры файлов конвертов с разными операциями аннулирования, которые выполняются над выше приведенным конвертом.
ИдДокСпецоператора может содержать идентификатор пакета в Диадоке — messageId или значение параметра из поля Реестр.Пакет.ИдДок, указанного при загрузке документа в Диадок.
<?xml version="1.0" encoding="WINDOWS-1251"?> <Реестр> <Пакет ИдДокСпецоператора="5b5c31c7-bd06-4e6a-8028-3265744576e2"> // ИдДокСпецоператора содержит идентификатор пакета в Диадоке — messageId <Команда Название="ЗапроситьАннулирование"> <Параметр Название="Примечание" Значение="Запрос аннулирования со стороны отправителя"/> </Команда> </Пакет> </Реестр><?xml version="1.0" encoding="WINDOWS-1251"?> <Реестр> <Пакет ИдДокСпецоператора="45673945"> // ИдДокСпецоператора содержит значение параметра из поля Реестр.Пакет.ИдДок, указанного при загрузке документа в Диадок <Команда Название="УтвердитьАннулирование"/> </Пакет> </Реестр><?xml version="1.0" encoding="WINDOWS-1251"?> <Реестр> <Пакет ИдДокСпецоператора="45673945"> // ИдДокСпецоператора содержит значение параметра из поля Реестр.Пакет.ИдДок, указанного при загрузке документа в Диадок <Команда Название="ОтклонитьАннулирование"> <Параметр Название="Примечание" Значение="Отклонение аннулирования на стороне получателя"/> </Команда> </Пакет> </Реестр>Чтобы аннулировать все документы в пакете, включите настройку «Применять команды аннулирования ко всем документам в пакете?» Рекомендуется использовать при аннулировании закрытых пакетов.