1С:Предприятие 8
Система программ
Обмен данными и интеграция

Прикладной уровень взаимодействия

Данный уровень позволяет обмениваться любыми исходящими и входящими электронными документами, которые возникают в процессе взаимодействия Клиента, работающего в системе «1С:Предприятие 8», и Банка.

Порядок обмена электронными документами

Отправителем и получателем электронного документа могут быть как Клиент (Организация), работающий в системе «1С:Предприятие 8», так и Банк (роли участников обмена зависят от конкретной бизнес-операции). При этом инициатором обмена всегда выступает система «1С:Предприятие 8».

Общий принцип работы на прикладном уровне может быть представлен в виде схемы:

Прикладной уровень взаимодействия

Отправка платежного документа и изменение статусов.

  • В «1С:Предприятии 8» формируется электронный документ «Платежное поручение» (XML-файл с бизнес данными, соответствующий XML-схеме платежного поручения) или «Платежное требование» (XML-файл с бизнес данными, соответствующий XML-схеме платежного требования).
  • Если используется электронная подпись на стороне «1С:Предприятия 8» (см. раздел «Обеспечение безопасности данных»), то система предложит пользователю подписать электронный документ.
  • Электронный документ с электронной подписью (если используется, см. раздел «Обеспечение безопасности данных») помещаются в транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне).
  • Далее передача данных в Банк проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • При этом происходит изменение статусов:
    • Если отправка прошла успешно, то система «1С:Предприятие 8» изменит статус электронному документу на «Отправлен».
    • После получения из Банка ответа по результатам обработки транспортного контейнера система «1С:Предприятие 8» назначит электронному документу статус «Доставлен».
    • По результатам контроля и первичной обработки электронного документа на стороне Банка формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий либо ошибку обработки, либо текущий статус электронного документа, и готовится к отправке.
    • После получения информации о статусе электронного документа или ошибки обработки на стороне Банка система «1С:Предприятие 8» назначит соответствующий статус электронному документу.
    • Статус «Подтвержден» электронному документу «1С:Предприятие 8» назначит только после получения электронного документа «Выписка банка», в которой будет соответствующая операция (OperationInfo.ExtID = PayDocRu.Id).

Пример XML-файла платежного поручения

<?xml version="1.0" encoding="UTF-8"?>
<PayDocRu xmlns="http://directbank.1c.ru/XMLSchema" 
	xmlns:xs="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    id="05688096-0806-4ef0-af4c-572f75dbaf7c" 
    formatVersion="2.3.1" 
    creationDate="2019-04-22T09:38:51" 
    userAgent="1С - БЭД: 1.7.1.1; БиблиотекаЭлектронныхДокументов: 1.7.1.1">
    <Sender id="82007cb2-dfd1-4193-b903-16cc9b7231c9" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
    <Recipient bic="044525888" name="ДЕМО-БАНК"/>
	<Data>
        <DocNo>14</DocNo>
        <DocDate>2019-04-22</DocDate>
        <Sum>15</Sum>
        <Payer>
            <Name>Торговый дом "Комплексный"</Name>
            <INN>7705260699</INN>
            <KPP>770501001</KPP>
            <Account>40702810813123123222</Account>
            <Bank>
                <BIC>044525888</BIC>
                <Name>ДЕМО-БАНК</Name>
                <CorrespAcc>30101810500000000219</CorrespAcc>
            </Bank>
        </Payer>
        <Payee>
            <Name>ООО "Канцтовары"</Name>
            <INN>7704596181</INN>
            <KPP>770401001</KPP>
            <Account>40702810401200000035</Account>
            <Bank>
                <BIC>044525999</BIC>
                <Name>ДЕМО-БАНК2</Name>
                <CorrespAcc>30101810200000000593</CorrespAcc>
            </Bank>
        </Payee>
        <TransitionKind>01</TransitionKind>
        <Priority>3</Priority>
        <Purpose>за товар</Purpose>
	</Data>
</PayDocRu>

Пример XML-файла платежного требования

        

<?xml version="1.0" encoding="UTF-8"?>
<PayRequest xmlns="http://directbank.1c.ru/XMLSchema"
	xmlns:xs="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    id="a4d4c2ac-26dd-43ae-a98b-cb4cebdbd1db" 
    formatVersion="2.3.1" 
    creationDate="2019-04-22T09:50:09" 
    userAgent="1С - БЭД: 1.7.1.1; БиблиотекаЭлектронныхДокументов: 1.7.1.1">
	<Sender id="82007cb2-dfd1-4193-b903-16cc9b7231c9" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
	<Recipient bic="044525888" name="ДЕМО-БАНК"/>
	<Data>
		<DocNo>15</DocNo>
		<DocDate>2019-04-22</DocDate>
		<Sum>15</Sum>
		<Payer>
			<Name>ООО "Канцтовары"</Name>
			<INN>7704596181</INN>
			<KPP>770401001</KPP>
			<Account>40702810401200000035</Account>
			<Bank>
				<BIC>044525999</BIC>
				<Name>ДЕМО-БАНК2</Name>
				<City>Г. МОСКВА</City>
				<CorrespAcc>30101810200000000593</CorrespAcc>
			</Bank>
		</Payer>
		<Payee>
			<Name>Торговый дом "Комплексный"</Name>
			<INN>7705260699</INN>
			<KPP>770501001</KPP>
			<Account>40702810813123123222</Account>
			<Bank>
				<BIC>044525888</BIC>
				<Name>ДЕМО-БАНК</Name>
				<City>Г. МОСКВА</City>
				<CorrespAcc>30101810500000000219</CorrespAcc>
			</Bank>
		</Payee>
		<PaymentKind>Электронно</PaymentKind>
		<TransitionKind>02</TransitionKind>
		<Priority>3</Priority>
		<Purpose>за товар</Purpose>
		<PaymentCondition>1</PaymentCondition>
	</Data>
</PayRequest>

Отправка платежного документа и изменение статусов при SMS-подтверждении

Прикладной уровень взаимодействия

В «1С:Предприятии 8» формируется электронный документ, например «Платежное поручение» (XML-файл с бизнес данными, соответствующий XML-схеме платежного поручения) или «Платежное требование» (XML-файл с бизнес данными, соответствующий XML-схеме платежного требования).

Электронный документ помещаются в транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне).

Далее передача данных в Банк проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».

После отправки в банк, 1С будет ожидать, когда в банке все отправленные документы пройдут первичный контроль.

После этого 1С отправит в банк запрос на подписание платежей по SMS. Банк вернет ссылку, которая откроется в браузере, а пользователю придет код в SMS сообщении. Причем один запрос подтверждения по SMS может быть сразу на несколько платежных документов. ИД всех документов для подтверждения передаются при одном вызове GenSMSSign. Банку на странице для ввода кода из SMS необходимо предусмотреть отображение основной информации из всех таких платежей.

Если код введенный пользователем совпадет с отправленным банком, то платежи станут принятыми банком. Исключением из этого правила является ситуация, когда каждый платеж нужно подтверждать несколькими лицами. Тогда после подтверждения платежка вводом кода из SMS в браузере, нужно еще подтвердить платеж другими лицами в личном кабинете банка.

При этом происходит изменение статусов:

  • Если отправка прошла успешно, то система «1С:Предприятие 8» изменит статус электронному документу на «Отправлен».
  • После получения из Банка ответа по результатам обработки транспортного контейнера система «1С:Предприятие 8» назначит электронному документу статус «Доставлен».
  • По результатам контроля и первичной обработки электронного документа на стороне Банка формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий либо ошибку обработки, либо текущий статус электронного документа, и готовится к отправке.
  • После получения информации о статусе электронного документа или ошибки обработки на стороне Банка система «1С:Предприятие 8» назначит соответствующий статус электронному документу.
  • Банк присваивает Платежному документу статус «Не подтвержден».
  • После подтверждения кодом из SMS Банк изменит статус электронного документа на следующий. Если платежный документ подтверждается по SMS одним лицом, то ему банком будет назначен статус «Принят», если несколькими «Частично подтвержден».
  • Если платежный документ подтверждается по SMS несколькими лицами, то Банк после его подтверждения в личном кабинете банка должен сменить статус с «Частично подтвержден» на «Принят».
  • Статус «Подтвержден» электронному документу «1С:Предприятие 8» назначит только после получения электронного документа «Выписка банка», в которой будет соответствующая операция (OperationInfo.ExtID = PayDocRu.Id). 

Пример XML-файла запроса подписания по SMS

               <?xml version="1.0" encoding="UTF-8"?>
<GenSMSSign xmlns="http://directbank.1c.ru/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="d218eb7a-cd90-40a4-b883-ad19b021df81" formatVersion="2.3.3" creationDate="2023-08-18T15:51:20" userAgent="1С - БЭД: 1.9.9.56; БухгалтерияПредприятияКОРП: 3.0.140.551">
	<Sender id="261020181" name="Торговый дом Комплексный" inn="612804198815"/>
	<Recipient bic="041111111" name="ДЕМО-БАНК"/>
	<ExtID>6b777376-baed-4069-a51f-c16434e9d5d1</ExtID>
	<ExtID>4a6827d1-1bf0-4d99-b360-72c599270071</ExtID>
</GenSMSSign>

Пример XML-файла успешного ответа банка

               <?xml version="1.0" encoding="UTF-8"?>
<ResultBank xmlns="http://directbank.1c.ru/XMLSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" formatVersion="2.3.3" userAgent="DirectBankService">
	<Success>
		<GenSMSSignResponse>
			<SigningURL>
				<URL>http://localhost/directbank/GenHTMforSMSSign?ExtIDGenSMSSign=38e4a469-df68-45cb-95a8-bbb83d818637</URL>
			</SigningURL>
			<ExtIDGenSMSSign>d218eb7a-cd90-40a4-b883-ad19b021df81</ExtIDGenSMSSign>
		</GenSMSSignResponse>
	</Success>
</ResultBank>

Получение выписки банка и изменение статусов

  • В «1С:Предприятии 8» формируется электронный документ «Запрос выписки банка» (XML-файл, соответствующий XML-схеме запроса на выписку).
  • Если используется электронная подпись на стороне «1С:Предприятия 8» (см. раздел «Обеспечение безопасности данных»), то система предложит пользователю подписать электронный документ.
  • Электронный документ «Запрос выписки банка» и электронная подпись (если используется) помещаются в транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне).
  • Далее передача данных в Банк проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • При этом происходит изменение статусов:
    • Если отправка прошла успешно, то система «1С:Предприятие 8» изменит статус электронному документу на «Отправлен».
    • После получения из Банка ответа по результатам обработки транспортного контейнера система «1С:Предприятие 8» назначит электронному документу статус «Доставлен».
    • По результатам контроля и первичной обработки электронного документа на стороне Банка формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий либо ошибку обработки, либо текущий статус электронного документа, и готовится к отправке. После получения информации о статусе электронного документа или ошибки обработки на стороне Банка система «1С:Предприятие 8» назначит соответствующий статус электронному документу.
  • По мере готовности электронного документа «Выписка банка» (XML-файл, соответствующий XML-схеме выписка банка) и формированию электронной подписи Банка (если используется) банковская система формирует транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне) и ставит в очередь на передачу в «1С:Предприятие 8».
  • Далее получение данных из Банка проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • Статус, что электронный документ «Выписка банка» получен, система «1С:Предприятие 8» назначит после успешного разбора входящего транспортного контейнера из Банка.

Пример XML-файла запроса выписки

   

<?xml version="1.0" encoding="UTF-8"?>
<StatementRequest xmlns="http://directbank.1c.ru/XMLSchema"
	xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    id="da06dc8f-afbe-4172-89c8-0d4492c2dd25"
    formatVersion="2.3.1"
    creationDate="2019-04-22T09:52:27"
    userAgent="1С - БЭД: 1.7.1.1; БиблиотекаЭлектронныхДокументов: 1.7.1.1">
	<Sender id="82007cb2-dfd1-4193-b903-16cc9b7231c9" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
	<Recipient bic="044525888" name="ДЕМО-БАНК"/>
	<Data>
		<StatementType>0</StatementType>
		<DateFrom>2019-04-21T00:00:00</DateFrom>
		<DateTo>2019-04-21T23:59:59</DateTo>
		<Account>40702810500000000001</Account>
		<Bank>
			<BIC>044525888</BIC>
			<Name>ДЕМО-БАНК</Name>
		</Bank>
	</Data>
</StatementRequest>

Пример XML-файла выписки банка

   

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Statement xmlns="http://directbank.1c.ru/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	id="f7cbc6af-33dd-4c37-b67d-7400e1c327ad"
	formatVersion="2.3.1"
	creationDate="2019-05-13T13:51:21.829"
	userAgent="DemoBankService">
	<Sender name="ДЕМО-БАНК" bic="044525888"/>
	<Recipient id="c8d57b00-530d-4a2e-86c1-aa9d5e4fafbd" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
	<Data>
		<StatementType>0</StatementType>
		<DateFrom>2019-05-04T00:00:00.000</DateFrom>
		<DateTo>2019-05-13T11:51:13.000</DateTo>
		<Account>40702810500000000001</Account>
		<Bank>
			<BIC>044525888</BIC>
			<Name>ДЕМО-БАНК"</Name>
			<City>МОСКВА</City>
			<CorrespAcc>30101810500000000219</CorrespAcc>
		</Bank>
		<OpeningBalance>139280.91</OpeningBalance>
		<ClosingBalance>88970.02</ClosingBalance>
		<OperationInfo>
			<PayDoc id="768" docKind="10">
				<PayDocRu>
					<DocNo>768</DocNo>
					<DocDate>2019-05-04</DocDate>
					<Sum>14</Sum>
					<Payer>
						<Name>Торговый дом Комплексный</Name>
						<INN>7705260699</INN>
						<KPP>770501001</KPP>
						<Account>40702810500000000001</Account>
						<Bank>
							<BIC>044525888</BIC>
							<Name>ДЕМО-БАНК</Name>
							<City>МОСКВА</City>
							<CorrespAcc>30101810500000000219</CorrespAcc>
						</Bank>
					</Payer>
					<Payee>
						<Name>Индивидуальный предприниматель Иванов Иван Иванович</Name>
						<INN>0</INN>
						<KPP>0</KPP>
						<Account>40802810300020007955</Account>
						<Bank>
							<BIC>046577413</BIC>
							<Name>ФИЛИАЛ ДЕМО-БАНК БТВ</Name>
							<City>ЕКАТЕРИНБУРГ</City>
							<CorrespAcc>30101810965770000413</CorrespAcc>
						</Bank>
					</Payee>
					<Priority>5</Priority>
					<Purpose>За транспортные услуги по счету № Ек2Тюм003221 от 18 Апреля 2019г. Сумма 2 999-00руб без НДС</Purpose>
				</PayDocRu>
			</PayDoc>
			<DC>1</DC>
			<Date>2019-05-04</Date>
			<Stamp>
				<BIC>044525888</BIC>
				<Name>ДЕМО-БАНК</Name>
				<City>МОСКВА</City>
				<CorrespAcc>30101810500000000219</CorrespAcc>
				<Status>
					<Code>02</Code>
					<Name>Исполнен</Name>
					<MoreInfo>Платежный документ исполнен банком</MoreInfo>
				</Status>
			</Stamp>
		</OperationInfo>
		<Stamp>
			<BIC>044525888</BIC>
			<Name>ДЕМО-БАНК</Name>
			<City>МОСКВА</City>
			<CorrespAcc>30101810500000000219</CorrespAcc>
		</Stamp>
	</Data>
	<ExtIDStatementRequest>39f9553d-67b1-4314-a2b1-8bddc99e0f42</ExtIDStatementRequest>
</Statement>

Получение состояния электронного документа

На любом из этапов работы с электронным документом на стороне Банка может возникнуть ошибка обработки, о которой надо проинформировать Клиента. — Банковская система формирует электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий ошибку обработки. — Если используется электронная подпись (см. раздел «Обеспечение безопасности данных»), то электронный документ подписывается. — Затем создает транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера) и ставит в очередь на передачу в «1С:Предприятие 8». — Далее получение данных из Банка проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне». — После получения информации об ошибке обработки на стороне Банка, система «1С:Предприятие 8» назначит соответствующий статус электронному документу с пояснением причины отказа в обработке Банком.

Пример XML-файла извещения о состоянии электронного документа

             

<?xml version="1.0" encoding="utf-8"?>
<StatusDocNotice xmlns="http://directbank.1c.ru/XMLSchema"
	id="204e36e4-6910-416d-99b2-e8109e518744"
	formatVersion="2.3.1"
    creationDate="2019-04-22T09:34:46+03:00"
    userAgent=" DemoBankService">
	<Sender>
		<Bank bic="044525888"/>
	</Sender>
	<Recipient>
		<Customer id="82007cb2-dfd1-4193-b903-16cc9b7231c9"/>
	</Recipient>
	<ExtID>eafa28b5-6600-424c-b0d3-3785274d570d</ExtID>
    <Result>
        <Status>
            <Code>01</Code>
            <Name>Подписан</Name>
        </Status>
    </Result>
</StatusDocNotice>

Запрос состояния электронного документа

На любом из этапов работы с электронным документом на стороне Клиента может возникнуть потребность узнать актуальное состояние электронного документа в Банке.

  • По команде в «1С:Предприятии 8» формируется электронный документ «Запрос о состоянии электронного документа» (XML-файл, соответствующий XML-схеме запроса о состоянии).
  • Если используется электронная подпись на стороне «1С:Предприятия 8» (см. раздел «Обеспечение безопасности данных»), то система предложит пользователю подписать электронный документ.
  • Электронный документ с электронной подписью (если используется, см. раздел «Обеспечение безопасности данных») помещаются в транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне).
  • Далее передача данных в Банк проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • Если отправка прошла успешно, то система «1С:Предприятие 8» изменит статус электронного документа запрос на «Отправлен».
  • После получения из Банка ответа по результатам обработки транспортного контейнера система «1С:Предприятие 8» назначит электронному документу запроса статус «Доставлен».
  • Если по результатам контроля и первичной обработки электронного документа на стороне Банка выявляется ошибка, то формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий ошибку обработки запроса, и готовится к отправке. После получения ошибки обработки из Банка система «1С:Предприятие 8» назначит соответствующий статус запросу.
  • Если запрос корректный, то на стороне Банка выполняется запрос на получение актуального статуса исходного электронного документа, затем формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий 2 идентификатора (ИД исходного электронного документа и ИД запроса), а также, либо ошибку обработки исходного электронного документа, либо его текущий статус.
  • Если используется электронная подпись (см. раздел «Обеспечение безопасности данных»), то электронный документ извещения подписывается.
  • Банковская система формирует транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне) и ставит в очередь на передачу в «1С:Предприятие 8».
  • Далее получение данных из Банка проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • Текущий статус исходного электронного документа и статус запроса система «1С:Предприятие 8» назначит после успешного разбора входящего транспортного контейнера из Банка.

Пример XML-файла запроса состояния электронного документа

             

<?xml version="1.0" encoding="UTF-8"?>
<StatusRequest xmlns="http://directbank.1c.ru/XMLSchema"
	xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    id="0fa540c3-1aaa-4e06-8883-2c936fef05a5"
    formatVersion="2.3.1"
    creationDate="2019-04-22T10:09:11"
    userAgent="1С - БЭД: 1.7.1.1; БиблиотекаЭлектронныхДокументов: 1.7.1.1">
	<Sender id="82007cb2-dfd1-4193-b903-16cc9b7231c9" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
	<Recipient bic="044525888" name="ДЕМО-БАНК"/>
	<ExtID>05688096-0806-4ef0-af4c-572f75dbaf7c</ExtID>
</StatusRequest>

Запрос об отзыве электронного документа

На стороне Клиента может возникнуть потребность направить запрос об отзыве электронного документа, ранее переданного в Банк.

  • По команде в «1С:Предприятии 8» формируется электронный документ «Запрос об отзыве электронного документа» (XML-файл, соответствующий XML-схеме запроса об отзыве), пользователь может указать причину отзыва документа.
  • Если используется электронная подпись на стороне «1С:Предприятия 8» (см. раздел «Обеспечение безопасности данных»), то система предложит пользователю подписать электронный документ.
  • Электронный документ «Запрос об отзыве электронного документа» помещается в транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне).
  • Далее передача данных в Банк проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • Если отправка прошла успешно, то система «1С:Предприятие 8» изменит статус электронного документа запрос на «Отправлен».
  • После получения из Банка ответа по результатам обработки транспортного контейнера система «1С:Предприятие 8» назначит электронному документу запроса статус «Доставлен».
  • Если по результатам контроля и первичной обработки электронного документа на стороне Банка выявляется ошибка, то формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий ошибку обработки запроса, и готовится к отправке. После получения ошибки обработки из Банка система «1С:Предприятие 8» назначит соответствующий статус запросу.
  • Если запрос корректный, то на стороне Банка определяется, возможен ли отзыв исходного электронного документа и если возможен, то электронный документ аннулируется, если нет, то готовится описание ошибки выполнения запроса об отзыве. Затем формируется электронный документ «Извещение о состоянии электронного документа» (XML-файл, соответствующий XML-схеме извещения о состоянии электронного документа), содержащий 2 идентификатора (ИД исходного электронного документа и ИД запроса), а также, либо ошибку обработки запроса, либо тек. статус исходного электронного документа — «Аннулирован».
  • Если используется электронная подпись (см. раздел «Обеспечение безопасности данных»), то электронный документ извещения подписывается.
  • Банковская система формирует транспортный контейнер (XML-файл, соответствующий XML-схеме транспортного контейнера), согласно настройкам обмена между Клиентом и Банком (в частности, применение сжатия данных на прикладном уровне) и ставит в очередь на передачу в «1С:Предприятие 8».
  • Далее получение данных из Банка проходит согласно протоколу, описанному в разделе «Порядок взаимодействия на транспортном уровне».
  • Текущий статус исходного электронного документа и статус запроса система «1С:Предприятие 8» назначит после успешного разбора входящего транспортного контейнера из Банка.

Пример XML-файла запроса состояния электронного документа

             
<?xml version="1.0" encoding="UTF-8"?>
<CancelationRequest xmlns="http://directbank.1c.ru/XMLSchema"
	xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    id="e8caa148-82a3-446d-a10f-ff82ad514b7e"
    formatVersion="2.3.1"
    creationDate="2019-04-22T10:11:25"
    userAgent="1С - БЭД: 1.7.1.1; БиблиотекаЭлектронныхДокументов: 1.7.1.1">
    <Sender id="82007cb2-dfd1-4193-b903-16cc9b7231c9" name="Торговый дом Комплексный" inn="7705260699" kpp="770501001"/>
    <Recipient bic="044525888" name="ДЕМО-БАНК"/>
    <ExtID>05688096-0806-4ef0-af4c-572f75dbaf7c</ExtID>
    <Reason>Описание причины отзыва</Reason>
</CancelationRequest>

Описание формата документа Поручение на перевод валюты (ISO 20022)

Элемент Описание элемента Тип Мн.
CstmrCdtTrfInitn              CustomerCreditTransferInitiationV03 [1]
  GrpHdr Секция: Реквизиты сообщения GroupHeader32 [1]
   MsgId Уникальный идентификатор сообщения. Max35Text [1]
   CreDtTm Дата и время формирования сообщения. ISODateTime [1]
   NbOfTxs Общее число поручений в сообщении.
Всегда содержит значение 1.		 Max15NumericText [1]
   InitgPty Секция: Иницииатор(отправитель) сообщения.
Всегда пустое.		 PartyIdentification32 [1]
  PmtInf Секция: Реквизиты распоряжения по дебету (списания).
Всегда состоит из одного элемента.		 PaymentInstructionInformation3 [1..n]
   PmtInfId Уникальный идентификатор распоряжения.
Такое же значение должна содержать операция в выписке в поле BkToCstmrStmt.Stmt.Ntry.NtryDtls.TxDtls.Refs.MsgId.		 Max35Text [1]
   PmtMtd Всегда содержит значение "TRF" PaymentMethod3Code [1]
   ReqdExctnDt Дата исполнения. ISODate [1]
   Dbtr Секция: Плательщик PartyIdentification32 [1]
    Nm Наименование Max140Text [0..1]
    PstlAdr Секция: Адрес PostalAddress6 [0..1]
     PstCd Индекс Max16Text [0..1]
     TwnNm Город Max35Text [0..1]
     Ctry Код страны CountryCode [0..1]
     AdrLine Адрес.
Может содержать только один элемент.		 Max70Text [0..n]
    Id Секция: идентификация участника платежа Party6Choice [0..1]
     OrgId Секция: идентификация компании OrganisationIdentification4 [1]
      Othr Секция: иной вид идентификации
Может содержать только один элемент		 GenericOrganisationIdentification1 [0..n]
       Id ИНН Max35Text [1]
       SchmeNm Секция: идентификация вида кода OrganisationIdentificationSchemeName1Choice [0..1]
        Cd Код типа данных в поле Id
Всегда содержит значение "TXID"		 ExternalOrganisationIdentification1Code [1]
    CtryOfRes Код страны регистрации CountryCode [0..1]
    CtctDtls Секция: контактная информация ContactDetails2 [0..1]
     Nm ФИО Max140Text [0..1]
     PhneNb Телефон PhoneNumber [0..1]
     EmailAdr Email адрес Max2048Text [0..1]
   DbtrAcct Секция: Счет плательщика CashAccount16 [1]
    Id Секция: идентификатор счета AccountIdentification4Choice [1]
     Othr Секция: другой тип счета GenericAccountIdentification1 [1]
      Id Cчет Max34Text [1]
      SchmeNm Секция: тип счета AccountSchemeName1Choice [0..1]
       Cd Вид счета.
Всегда содержит значение "BBAN"		 ExternalAccountIdentification1Code [1]
   DbtrAgt Секция: Банк плательщика BranchAndFinancialInstitutionIdentification4 [1]
    FinInstnId Секция: идентификация банка FinancialInstitutionIdentification7 [1]
     BIC SWIFT BICIdentifier [0..1]
     Nm Наименование Max140Text [0..1]
     PstlAdr Секция: Адрес PostalAddress6 [0..1]
      TwnNm Город Max35Text [0..1]
      AdrLine Адрес.
Может содержать только один элемент.		 Max70Text [0..n]
   ChrgBr С кого списывается комиссия.
Возможные значения: "CRED", "DEBT", "SHAR"		 ChargeBearerType1Code [0..1]
   ChrgsAcct Секция: счет комиссии. CashAccount16 [0..1]
    Id Секция: идентификатор счета AccountIdentification4Choice [1]
     Othr Секция: другой тип счета GenericAccountIdentification1 [1]
      Id Счет Max34Text [1]
      SchmeNm AccountSchemeName1Choice [0..1]
       Cd Всегда содержит значение "BBAN" ExternalAccountIdentification1Code [1]
   CdtTrfTxInf Секция: Реквизиты по кредиту (зачисления).
Всегда содержит один элемент.		 CreditTransferTransactionInformation10 [0..n]
    PmtId Секция: идентификаторы платежа PaymentIdentification1 [1]
     InstrId Уникальный номер поручения Max35Text [0..1]
     EndToEndId Номер платежного поручения Max35Text [1]
    PmtTpInf Секция: тип платежа PaymentTypeInformation19 [0..1]
    Amt Секция: сумма платежа AmountType3Choice [1]
     InstdAmt Сумма ActiveOrHistoricCurrencyAndAmount [1]
      @Ccy Валюта перевода ActiveOrHistoricCurrencyCode [1]
    XchgRateInf Секция:курс конверсии ExchangeRateInformation1 [0..1]
     XchgRate Курс BaseOneRate [0..1]
     RateTp Тип курса.
Всегда имеет значение "SPOT"		 ExchangeRateType1Code [0..1]
    IntrmyAgt1 Секция: Банк посредник BranchAndFinancialInstitutionIdentification4 [0..1]
     FinInstnId Секция: идентификация банка FinancialInstitutionIdentification7 [1]
      BIC SWIFT BICIdentifier [0..1]
      Nm Наименование банка Max140Text [0..1]
      PstlAdr Секция: Адрес PostalAddress6 [0..1]
       Ctry Код страны CountryCode [0..1]
       AdrLine Адрес.
Может содержать только один элемент		 Max70Text [0..n]
    CdtrAgt Секция: Банк получателя BranchAndFinancialInstitutionIdentification4 [0..1]
     FinInstnId Секция: идентификация банка FinancialInstitutionIdentification7 [1]
      BIC SWIFT BICIdentifier [1]
      ClrSysMmbId Секция: идентификация участника клиринга ClearingSystemMemberIdentification2 [0..1]
       MmbId БИК Max35Text [1]
      Nm Наименование Max140Text [0..1]
      PstlAdr Секция: Адрес PostalAddress6 [0..1]
       Ctry Код страны CountryCode [0..1]
       AdrLine Адрес банка.
Может содержать только один элемент.		 Max70Text [0..n]
    CdtrAgtAcct Счет банк посредника получателя CashAccount16 [0..1]
      Id Секция: идентификация счета Max34Text [1]
       Othr Секция: не IBAN счет Max34Text [1]
        Id Счет Max34Text [1]
        SchmeNm AccountSchemeName1Choice [0..1]
         Cd Всегда содержит значение "BBAN" ExternalAccountIdentification1Code [1]
    Cdtr Секция: Получатель PartyIdentification32 [0..1]
     Nm Наименование Max140Text [0..1]
     PstlAdr Секция: адрес PostalAddress6 [0..1]
      Ctry Код страны CountryCode [0..1]
      PstCd Индекс Max16Text [0..1]
      TwnNm Город Max35Text [0..1]
      AdrLine Неструктурированный адрес.
Может содержать только один элемент.		 Max70Text [0..n]
     Id Идентификатор получателя Party6Choice [0..1]
      OrgId OrganisationIdentification4 [1]
       Othr Может содержать только один элемент GenericOrganisationIdentification1 [0..n]
        Id ИНН получателя Max35Text [1]
        SchmeNm OrganisationIdentificationSchemeName1Choice [0..1]
         Cd Всегда содержит значение "TXID" ExternalOrganisationIdentification1Code [1]
     CtryOfRes Код страны получателя CountryCode [0..1]
     CtctDtls Контактная информация организации получателя ContactDetails2 [0..1]
      Nm ФИО Max140Text [0..1]
      PhneNb Телефон PhoneNumber [0..1]
      EmailAdr Email адрес Max2048Text [0..1]
    CdtrAcct Секция: Счет получателя CashAccount16 [1]
     Id Счет AccountIdentification4Choice [1]
      Othr Секция: другой тип счета GenericAccountIdentification1 [1]
       Id Номер счета Max34Text [1]
       SchmeNm AccountSchemeName1Choice [0..1]
        Cd Всегда содержит значение "BBAN" ExternalAccountIdentification1Code [1]
    RgltryRptg Секция: информация для регулятора RegulatoryReporting3 [0..n]
     Dtls StructuredRegulatoryReporting3 [0..n]
      Tp Всегда содержит значение "VO" Max35Text [0..1]
      Cd Код вида операции Max10Text [0..1]
      Amt Сумма ActiveOrHistoricCurrencyAndAmount [0..1]
       @Ccy Код валюты ActiveOrHistoricCurrencyCode [1]
      Inf Номер паспорта сделки Max35Text [0..n]
    RmtInf Секция: Информация о платеже RemittanceInformation5 [0..1]
     Ustrd Назначение платежа Max140Text [0..n]
     Strd Секция: Структурированная информация о платеже StructuredRemittanceInformation7 [0..n]
      RfrdDocInf Секция: Информация о связанных документах ReferredDocumentInformation3 [0..n]
       Tp Секция: Тип связанного документа ReferredDocumentType2 [0..n]
        CdOrPrtry ReferredDocumentType1Choice [1]
         Prtry Тип документа.
Всегда имеет значение "POD"		 Max35Text [1]
       Nb Номер документа Max35Text [0..1]
       RltdDt Дата документа ISODate [0..1]

Описание формата документа Выписка банка в валюте (ISO 20022)

Элемент Описание элемента Тип Мн.
BkToCstmrStmt              BankToCustomerStatementV02 [1]
  GrpHdr Секция: Заголовок GroupHeader42 [1]
   MsgId Системный идентификатор сообщения. Max35Text [1]
   CreDtTm Дата и время создания сообщения системой. ISODateTime [1]
   AddtlInf Идентификатор запроса выписки. Max500Text [0..1]
  Stmt Секция: Выписка по счету AccountStatement2 [1..n]
   Id Системный идентификатор выписки. Max35Text [1]
   CreDtTm Дата / время создания выписки. ISODateTime [1]
   FrToDt Секция: Период выписки DateTimePeriodDetails [0..1]
    FrDtTm Дата начала периода ISODateTime [1]
    ToDtTm Дата конца периода ISODateTime [1]
   Acct Секция: Реквизиты счета, владелеца, обслуживающего банка CashAccount20 [1]
    Id Секция: Идентификация организации AccountIdentification4Choice [1]
     IBAN IBAN IBAN2007Identifier [1]
     Othr Секция: другие идентификаторы GenericAccountIdentification1 [1]
      Id Номер счета Max34Text [1]
    Nm Наименование организации Max70Text [0..1]
    Ownr Секция: владелец счета PartyIdentification32 [0..1]
     Nm Наименование владельца счета Max140Text [0..1]
     Id Секция: Идентификация владельца счета Party6Choice [0..1]
      OrgId Секция: Идентификация организации OrganisationIdentification4 [1]
       Othr Секция: Другие реквизиты.
Должен содержать только один элемент		 GenericOrganisationIdentification1 [0..n]
        Id ИНН / КИО владельца счета Max35Text [1]
    Svcr Секция: Обслуживающий банк BranchAndFinancialInstitutionIdentification4 [0..1]
     FinInstnId FinancialInstitutionIdentification7 [1]
      BIC SWIFT BICIdentifier [0..1]
      ClrSysMmbId ClearingSystemMemberIdentification2 [0..1]
       MmbId БИК банка/отделения обслуживающего счет Max35Text [1]
      Nm Наименование банка/отделения обслуживающего счет Max140Text [0..1]
   Bal Секция: Информация о балансах CashBalance3 [1..n]
    Tp BalanceType12 [1]
     CdOrPrtry BalanceType5Choice [1]
      Cd Тип баланса.
"OPBD" - начальный остаток
"CLBD" - конечный остаток		 BalanceType12Code [1]
    Amt Сумма остатка ActiveOrHistoricCurrencyAndAmount [1]
     @Ccy Код валюты ActiveOrHistoricCurrencyCode [1]
   TxsSummry Секция: Итоговая информация о транзакциях TotalTransactions2 [0..1]
    TtlCdtNtries Секция: Итоговая информация о транзакциях по кредиту NumberAndSumOfTransactions1 [0..1]
     Sum Обороты по кредиту DecimalNumber [0..1]
    TtlDbtNtries Секция: Итоговая информация о транзакциях по дебиту NumberAndSumOfTransactions1 [0..1]
     Sum Обороты по дебету DecimalNumber [0..1]
   Ntry Секция: Информация о транзакции (если были) ReportEntry2 [0..n]
    Amt Сумма операции ActiveOrHistoricCurrencyAndAmount [1]
     @Ccy Код валюты ActiveOrHistoricCurrencyCode [1]
    CdtDbtInd Индикатор Дебет ('DBIT') /Кредит ('CRDT') CreditDebitCode [1]
    Sts Статус операции Исполняется ('PDNG') / Исполнено ('BOOK') EntryStatus2Code [1]
    BookgDt Секция: дата отражения по выписке DateAndDateTimeChoice [0..1]
     Dt Дата ISODate [1]
     DtTm Дата и время ISODateTime [1]
    ValDt Секция: Дата валютирования DateAndDateTimeChoice [0..1]
     Dt Дата ISODate [1]
     DtTm Дата и время ISODateTime [1]
    AcctSvcrRef Идентификатор транзакции. Max35Text [0..1]
    BkTxCd Секция: Информация о типе транзакции BankTransactionCodeStructure4 [1]
    NtryDtls Секция: Детали строки выписки.
Должен содержать только 1 элемент		 EntryDetails1 [0..n]
     TxDtls Секция: Детали транзакции.
Должен содержать только 1 элемент		 EntryTransaction2 [0..n]
      Refs Секция: Референсы TransactionReferences2 [0..1]
       MsgId Идентификатор исходного документа Поручение на перевод валюты Max35Text [0..1]
       EndToEndId Номер документа Max35Text [0..1]
      RltdPties Секция: Реквизиты участников платежа TransactionParty2 [0..1]
       Dbtr Секция: Реквизиты плательщика PartyIdentification32 [0..1]
        Nm Наименование плательщика Max140Text [0..1]
        Id Секция: Идентификация плательщика Party6Choice [0..1]
         OrgId Секция: Идентификация организации OrganisationIdentification4 [1]
          Othr Секция: Другие реквизиты
Должен содержать только 1 элемент		 GenericOrganisationIdentification1 [0..n]
           Id ИНН / КИО плательщика Max35Text [1]
        CtryOfRes Код страны CountryCode [0..1]
       DbtrAcct Секция: счет плательщика CashAccount16 [0..1]
        Id AccountIdentification4Choice [1]
         Othr Секция: Другие реквизиты GenericAccountIdentification1 [1]
          Id Номер счета плательщика Max34Text [1]
       Cdtr Секция: Реквизиты получателя PartyIdentification32 [0..1]
        Nm Наименование получателя Max140Text [0..1]
        Id Секция: Идентификация получателя Party6Choice [0..1]
         OrgId Секция: Идентификация организации OrganisationIdentification4 [1]
          Othr Секция: Другие реквизиты.
Должен содержать только 1 элемент		 GenericOrganisationIdentification1 [0..n]
           Id ИНН / КИО получателя Max35Text [1]
        CtryOfRes Код страны CountryCode [0..1]
       CdtrAcct Секция: Cчет получателя CashAccount16 [0..1]
        Id AccountIdentification4Choice [1]
         Othr GenericAccountIdentification1 [1]
          Id Номер счета получателя Max34Text [1]
      RltdAgts Секция: Реквизиты банков TransactionAgents2 [0..1]
       DbtrAgt Секция: Реквизиты банка плательщика BranchAndFinancialInstitutionIdentification4 [0..1]
        FinInstnId FinancialInstitutionIdentification7 [1]
         BIC SWIFT банка плательшика BICIdentifier [0..1]
         Nm Наименование банка плательщика Max140Text [0..1]
         PstlAdr Адрес PostalAddress6 [0..1]
          Ctry Код страны CountryCode [0..1]
       CdtrAgt Секция: Реквизиты банка получателя BranchAndFinancialInstitutionIdentification4 [0..1]
        FinInstnId FinancialInstitutionIdentification7 [1]
         BIC SWIFT банка получателя BICIdentifier [0..1]
         Nm Наименование банка получателя Max140Text [0..1]
         PstlAdr Адрес PostalAddress6 [0..1]
          Ctry Код страны CountryCode [0..1]
      RmtInf Секция: Детали документа RemittanceInformation5 [0..1]
       Ustrd Назначение платежа, может быть более одного поля Max140Text [0..n]
       Strd Секция: Структурные детали StructuredRemittanceInformation7 [0..n]
        RfrdDocInf ReferredDocumentInformation3 [0..n]
         RltdDt Дата документа ISODate [0..1]

Автоматическое получение выписки банка

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

При автоматическом получении выписки используется только базовая аутентификация. Логин и пароль сохраняются в информационной базе, поэтому данная учетная запись должна иметь строгое ограничение на стороне сервера банка: она должна иметь только право получения выписки. Запросы выписок при автоматическом получении не имеют электронной подписи.

Особенности автоматического получения выписки:

  • Используется базовая аутентификация по отдельной ограниченной учетной записи.
  • Запрос выписки отправляется каждый час.
  • Период запроса определяется автоматически с даты последней операции по счету по текущий день.
  • Период запроса выписки не может превышать 7 дней.
  • Запрос выписки не имеет электронной подписи.

Порядок действий при очередной итерации получения выписки:

Таким образом после отправки система не ждет от банка выписки. Если после отправки запроса система банка не успела сформировать выписку, то она будет получена в следующем сеансе через один час.

Необходимые действия на стороне банка:

  • Создать учетную запись, у которой есть только право получения выписки, но нет права создания платежных документов.
  • Отправить клиенту файл настроек, в котором присутствует секция ReceiptStatement. Значения полей Logon.Login.User и ReceiptStatement.Login обязательно должны отличаться.
  • Обеспечить возможность получения пользователем пароля по инструкции, переданной в ReceiptStatement.Instructions.