| B.1. Формат импорта данных | ||
|---|---|---|
 |
Приложение B. Текстовый формат обмена данными с БС | 
|
| B.1. Формат импорта данных | ||
|---|---|---|
|
|
Приложение B. Текстовый формат обмена данными с БС |
|
Один импортируемый файл может содержать данные о любом количестве документов любых типов, для которых описаны форматы импорта.
Начало каждого нового документа идентифицируется служебной строкой. В данной строке содержится название формата преобразования, который должен быть применен к импортируемому документу для получения документа ДБО:
#|FormatName или #N|FormatName, где
# – служебный символ, являющийся указателем начала нового документа в файле импорта.
N – порядковый номер документа в файле.
| – служебный символ, являющийся разделителем записей в служебной строке.
FormatName – наименование формата, в соответствии с которым импортируемый документ будет преобразовываться в документ ДБО.
После служебной строки должны быть представлены значения полей документа, причем каждое значение должно быть записано с новой строки файла.
В виде значений полей документа могут быть представлены вложенные таблицы. В качестве вложенных таблиц представляется дополнительная информация о документе (например, поручений на продажу валюты, которые могут содержать обосновывающие сделку документы).
При импорте вложенные таблицы сохраняются в виде BLOB-полей.
Во входном потоке для идентификации раздела вложенной таблицы используются следующие служебные строки:
;NestedTable – информирует о начале секции вложенной таблицы. Далее во входном потоке передается первое поле первой записи вложенной таблицы.
;EndNestedTableRow – конец записи вложенной таблицы. Далее во входном потоке передается первое поле следующей записи вложенной таблицы.
;EndNestedTable – конец секции вложенной таблицы. Далее во входном потоке передается поле основного документа.
Количество записей вложенной таблицы произвольно. В случае если нет данных для импорта во вложенную таблицу, необходимо обязательно указать пустую секцию вложенной таблицы.
Последней строкой документа должна являться запись ";end".
Строки документа между первой и последней должны содержать значения строго в той последовательности, которая определена в формате преобразования документа. В противном случае импорт в систему "ДБО BS-Client x64" не сможет быть выполнен, либо документ будет импортирован с ошибочными данными.
В стандартной поставке системы предопределены следующие форматы импорта:
PayDocRu – платежное поручение;
PayDocRu383P – платежное поручение с возможностью заполнения кода вида платежа (см. разд. «Код вида платежа в платежных поручениях»);
PayDocRu5286U – платёжное поручение с возможностью заполнения поля Код вида дохода.
PayDocRuAE – платежное поручение в расширенном формате;
PayDocRuCS – шаблон для импорта документа "Платежное поручение" с БИК банка плательщика;
PayDocRuUIP – шаблон для импорта документа "Платежное поручение" с возможностью заполнения кода (см. разд. «Код в платежных поручениях»);
PayDocRuXE – платежное поручение с учетом требований Указания Банка России №1256-У от 03.03.2003. Данный формат является наиболее актуальным;
PayRollDoc – зарплатная ведомость;
PayRollDoc_Ex – зарплатная ведомость c возможностью заполнения ИНН организации;
PayRollDoc_5286U – зарплатная ведомость с возможностью заполнения поля Код вида дохода.
В стандартной поставке системы заданы форматы преобразования только импортируемых из БС платежных поручений. В случае необходимости могут быть заданы форматы импортирования документов других типов, например, если Ваша БС поддерживает работу с валютными документами, могут быть созданы форматы для преобразования поручений на перевод валюты.
Формат преобразования включает в себя:
формат полей документа (описание порядка, внутренних имен и типов полей);
алгоритм сохранения значений полей в таблице БД.
В следующей таблице приведен список полей, установленных для платежного поручения в формате PayDocRuXE.
| Название поля | Тип поля | Макс. длина | Содержание |
|---|---|---|---|
| DocumentDate | Date | 10 | Дата создания документа. |
| DocumentNumber | String | 15 | Номер документа. |
| CurrCode | String | 3 | Код валюты документа |
| PayerAccount | String | 25 | Счет плательщика |
| ReceiverBIC | String | 9 | БИК получателя |
| ReceiverAccount | String | 25 | Счет получателя |
| Receiver | String | 160 | Название получателя |
| ReceiverINN | String | 14 | ИНН получателя |
| Amount | Money | 15 | Сумма |
| Ground | String | 255 | Основание платежа |
| PaymentUrgent | String | 2 | Очередность платежа |
| PayUntil | Date | 10 | Срок оплаты |
| OperType | String | 2 | Вид операции |
| SendType | String | 15 | Вид платежа |
| NDS | Money | 25 | НДС |
| Stat1256 | String | 2 | Показатель статуса (101) |
| PayerKPP | String | 9 | КПП плательщика (102) |
| ReceiverKPP | String | 9 | КПП получателя (103) |
| CBCcode | String | 20 | Код бюджетной классификации (104) |
| OKATOcode | String | 11 | Код ОКАТО (105) |
| PayGrndParam | String | 2 | Показатель основания платежа (106) |
|
TaxPeriodParam1 TaxPeriodParam2 TaxPeriodParam3 |
String |
2 2 4 |
Показатель налогового периода (107): TaxPeriodParam1 + '.' + TaxPeriodParam2 + '.' + TaxPeriodParam3 |
|
DocNumParam1 DocNumParam2 |
String |
2 15 |
Показатель номера документа (108) |
|
DocDateParam1 DocDateParam2 DocDateParam3 |
String |
2 2 4 |
Показатель даты документа (109) DocDateParam1 (dd), DocDateParam2 (mm), DocDateParam3 (yyyy) |
| PayTypeParam | String | 2 | Показатель типа платежа (110) |
В табл. B.1 «Список полей формата PayDocRuUIP» приведен список полей, установленных для платежного поручения в формате PayDocRuUIP.
Таблица B.1. Список полей формата PayDocRuUIP
| Название поля | Тип поля | Макс. длина | Содержание |
|---|---|---|---|
| DocumentDate | Date | 10 | Дата создания документа. |
| DocumentNumber | String | 15 | Номер документа. |
| CurrCode | String | 3 | Код валюты документа |
| PayerAccount | String | 25 | Счет плательщика |
| PayerName | String | 80 | Название плательщика |
| PayerKPP | String | 9 | КПП плательщика (102) |
| ReceiverBIC | String | 9 | БИК получателя |
| ReceiverAccount | String | 25 | Счет получателя |
| Receiver | String | 160 | Название получателя |
| ReceiverINN | String | 14 | ИНН получателя |
| Amount | Money | 15 | Сумма |
| Ground | String | 255 | Основание платежа |
| NDS | Money | 25 | НДС |
| PaymentUrgent | String | 2 | Очередность платежа |
| PayUntil | Date | 10 | Срок оплаты |
| OperType | String | 2 | Вид операции |
| SendType | String | 15 | Вид платежа |
| ReceiverKPP | String | 9 | КПП получателя (103) |
| Stat1256 | String | 2 | Показатель статуса (101) |
| CBCcode | String | 20 | Код бюджетной классификации (104) |
| OKATOcode | String | 11 | Код ОКАТО (105) |
| PayGrndParam | String | 2 | Показатель основания платежа (106) |
|
TaxPeriodParam1 TaxPeriodParam2 TaxPeriodParam3 |
String |
8 2 4 |
Группа полей служит для хранения одной из следующих информаций:
|
|
DocNumParam2 |
String |
15 |
Показатель номера документа (108) |
|
DocDateParam1 DocDateParam2 DocDateParam3 |
String |
2 2 4 |
Показатель даты документа (109) DocDateParam1 (dd), DocDateParam2 (mm), DocDateParam3 (yyyy) |
| PayTypeParam | String | 2 | Показатель типа платежа (110) |
| SendTypeCode | Integer | - | Код вида платежа |
| CodeUIP | String | 25 | Уникальный идентификатор платежа (УИП) или уникальный идентификатор начисления (УИН) (20) |
В табл. B.2 «Список полей формата PayDocRu5286U» приведен список полей, установленных для платежного поручения в формате PayDocRu5286U.
Таблица B.2. Список полей формата PayDocRu5286U
| Название поля | Тип поля | Макс. длина | Содержание |
|---|---|---|---|
| DocumentDate | Date | 10 | Дата создания документа. |
| DocumentNumber | String | 15 | Номер документа. |
| CurrCode | String | 3 | Код валюты документа |
| PayerAccount | String | 25 | Счет плательщика |
| PayerName | String | 80 | Название плательщика |
| PayerKPP | String | 9 | КПП плательщика (102) |
| ReceiverBIC | String | 9 | БИК получателя |
| ReceiverAccount | String | 25 | Счет получателя |
| Receiver | String | 160 | Название получателя |
| ReceiverINN | String | 14 | ИНН получателя |
| Amount | Money | 15 | Сумма |
| Ground | String | 255 | Основание платежа |
| NDS | Money | 25 | НДС |
| PaymentUrgent | String | 2 | Очередность платежа |
| PayUntil | Date | 10 | Срок оплаты |
| OperType | String | 2 | Вид операции |
| SendType | String | 15 | Вид платежа |
| ReceiverKPP | String | 9 | КПП получателя (103) |
| Stat1256 | String | 2 | Показатель статуса (101) |
| CBCcode | String | 20 | Код бюджетной классификации (104) |
| OKATOcode | String | 11 | Код ОКАТО (105) |
| PayGrndParam | String | 2 | Показатель основания платежа (106) |
|
TaxPeriodParam1 TaxPeriodParam2 TaxPeriodParam3 |
String |
8 2 4 |
Группа полей служит для хранения одной из следующих информаций:
|
|
DocNumParam2 |
String |
15 |
Показатель номера документа (108) |
|
DocDateParam1 DocDateParam2 DocDateParam3 |
String |
2 2 4 |
Показатель даты документа (109) DocDateParam1 (dd), DocDateParam2 (mm), DocDateParam3 (yyyy) |
| PayTypeParam | String | 2 | Показатель типа платежа (110) |
| SendTypeCode | Integer | - | Код вида платежа |
| CodeUIP | String | 25 | Уникальный идентификатор платежа (УИП) или уникальный идентификатор начисления (УИН) (20) |
| IncomeTypeCode | String | Код вида дохода |
В табл. B.3 «Список полей формата PayRollDoc_5286U» приведен список полей, установленных для зарплатной ведомости в формате PayRollDoc_5286U.
Таблица B.3. Список полей формата PayRollDoc_5286U
| Название поля | Тип поля | Содержание |
|---|---|---|
| CustomerINN | String | ИНН клиента. |
| DocumentDate | Date | Дата документа. |
| DocumentNumber | String | Номер документа |
| PhoneOfficials | String | Номер телефона ответственного лица |
| SenderOfficials | String | Исполнитель |
| CurrCode | String | Код валюты |
| AccountDebet | String | Счет, с которого перечисляется заработная плата |
| AccountDebetBIC | String | БИК банка, со счета которого перечисляется заработная плата |
| PeriodMonth | Integer | Месяц отчетного периода |
| PeriodYear | Integer | Год отчетного периода |
| PlatPorNumber | String | Номер платежного поручения |
| PlatPorDate | Date | Дата платежного поручения |
| PlatPorGoal | String | Назначение платежа |
| IncomeTypeCode | String | Код вида дохода |
| SalaryBlob.NoticeNumber | Номер информации о начислении | |
| SalaryBlob.EmployeeName | Имя сотрудника | |
| SalaryBlob.EmployeeINN | ИНН сотурдника | |
| SalaryBlob.EmployeeAccount | Счет сотрудника | |
| SalaryBlob.EmployeeBankBIC | БИК банка счета сотрудника | |
| SalaryBlob.EmployeeAmount | Сумма для зачисления | |
| SalaryBlob.Description | Комментарий | |
| SalaryBlob.EmployeeIncomeTypeCode | Код вида дохода в начислении | |
|
SalaryBlob.EmployeeRetentionAmount |
Сумма удержания |
|
|
AmountTotal |
Integer | Общая сумма платежного поручения |
|
|
 |
|
| Приложение B. Текстовый формат обмена данными с БС |  |
B.2. Формат экспорта данных |