Конверт: рекомендованная стурктура для файлов формата DBF или CSV — различия между версиями
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 1: | Строка 1: | ||
[[СБИС Коннект]] имеет типовые настройки, позволяющие информационной системе [[СБИС Коннект: Отправка документов#Преобразование dbf файлов в Конверты|отправлять]] и получать документы используя для обмена с личным кабинетом файлы формата DBF и CSV. | [[СБИС Коннект]] имеет типовые настройки, позволяющие информационной системе [[СБИС Коннект: Отправка документов#Преобразование dbf файлов в Конверты|отправлять]] и получать документы используя для обмена с личным кабинетом файлы формата DBF и CSV. | ||
Придерживаясь данного формата, Вы получаете готовые преобразователи Ваших данных в XML регламентированных форматов и обратно. Список поддерживаемых документов постоянно расширяется. | Придерживаясь данного формата, Вы получаете готовые преобразователи Ваших данных в XML регламентированных форматов и обратно. Список поддерживаемых документов постоянно расширяется. | ||
+ | |||
+ | == Логическая схема формата == | ||
Данный формат разрабатывался с целью поместить в один dbf/csv файл (одну таблицу) данные нескольких пакетов документов и всех их вложений. Формат содержит 33 строковых поля. Порядок следования полей фиксированный. Поскольку данный формат применяется одновременно для dbf и csv, то имена столбцов dbf файла служат только для удобства использования, при конвертации имеет смысл только порядковый номер столбца, поэтому нарушение порядка следования столбцов при создании файла приведет к ошибкам конвертации документов. | Данный формат разрабатывался с целью поместить в один dbf/csv файл (одну таблицу) данные нескольких пакетов документов и всех их вложений. Формат содержит 33 строковых поля. Порядок следования полей фиксированный. Поскольку данный формат применяется одновременно для dbf и csv, то имена столбцов dbf файла служат только для удобства использования, при конвертации имеет смысл только порядковый номер столбца, поэтому нарушение порядка следования столбцов при создании файла приведет к ошибкам конвертации документов. | ||
Данные таблицы условно поделены на 6 блоков. | Данные таблицы условно поделены на 6 блоков. | ||
− | + | [[Файл:SBISConnect_DBFScheme.png]] | |
+ | *Packet – информация о пакете | ||
+ | *Document – шапка документа | ||
+ | *Base – информация о документах основаниях (например платежно-расчетные документы или договора на основании которых сделан конкретный документ) | ||
+ | *Party – информация об участнике документооборота, сведения об отправителе получателе пакета, поставщике , покупателе грузоотправителе и грузополучателе) | ||
+ | *RowTable – строка табличной части документа | ||
+ | *Parameter – параметры документа или строки табличной части документа. | ||
− | |||
− | == | + | == Общее описание формата == |
{|class="wikitable" | {|class="wikitable" | ||
Строка 87: | Строка 94: | ||
|33|| BankCorAcc||Номер корр. счета | |33|| BankCorAcc||Номер корр. счета | ||
|} | |} | ||
− | + | ||
− | == Заполнение блока Packet == | + | Ниже описан порядок заполнения каждого блока. Столбцы у которых не заполнено описание, заполнять не нужно. |
+ | |||
+ | ==Порядок заполнения блоков== | ||
+ | === Заполнение блока Packet === | ||
{|class="wikitable" | {|class="wikitable" | ||
!№ || Имя || style="width: 100%"| Описание столбцов применительно к текущему блоку | !№ || Имя || style="width: 100%"| Описание столбцов применительно к текущему блоку | ||
Строка 159: | Строка 169: | ||
|} | |} | ||
− | == Заполнение блока Party для блока Packet == | + | === Заполнение блока Party для блока Packet === |
{|class="wikitable" | {|class="wikitable" | ||
Строка 232: | Строка 242: | ||
− | == Заполнение блока Document == | + | === Заполнение блока Document === |
{|class="wikitable" | {|class="wikitable" | ||
!№ || Имя ||style="width: 100%"| Описание столбцов применительно к текущему блоку | !№ || Имя ||style="width: 100%"| Описание столбцов применительно к текущему блоку | ||
Строка 302: | Строка 312: | ||
|33||BankCorAcc|| | |33||BankCorAcc|| | ||
|} | |} | ||
− | == Заполнение блока Base == | + | === Заполнение блока Base === |
{|class="wikitable" | {|class="wikitable" | ||
Строка 374: | Строка 384: | ||
|} | |} | ||
− | == Заполнение блока Party для блока Document == | + | === Заполнение блока Party для блока Document === |
{|class="wikitable" | {|class="wikitable" | ||
Строка 450: | Строка 460: | ||
|} | |} | ||
− | == Заполнение блока RowTable == | + | === Заполнение блока RowTable === |
{|class="wikitable" | {|class="wikitable" | ||
Строка 532: | Строка 542: | ||
|} | |} | ||
− | == Заполнение блока Parameter == | + | === Заполнение блока Parameter === |
{|class="wikitable" | {|class="wikitable" |
Текущая версия на 10:38, 26 января 2015
СБИС Коннект имеет типовые настройки, позволяющие информационной системе отправлять и получать документы используя для обмена с личным кабинетом файлы формата DBF и CSV. Придерживаясь данного формата, Вы получаете готовые преобразователи Ваших данных в XML регламентированных форматов и обратно. Список поддерживаемых документов постоянно расширяется.
Логическая схема формата
Данный формат разрабатывался с целью поместить в один dbf/csv файл (одну таблицу) данные нескольких пакетов документов и всех их вложений. Формат содержит 33 строковых поля. Порядок следования полей фиксированный. Поскольку данный формат применяется одновременно для dbf и csv, то имена столбцов dbf файла служат только для удобства использования, при конвертации имеет смысл только порядковый номер столбца, поэтому нарушение порядка следования столбцов при создании файла приведет к ошибкам конвертации документов. Данные таблицы условно поделены на 6 блоков.
- Packet – информация о пакете
- Document – шапка документа
- Base – информация о документах основаниях (например платежно-расчетные документы или договора на основании которых сделан конкретный документ)
- Party – информация об участнике документооборота, сведения об отправителе получателе пакета, поставщике , покупателе грузоотправителе и грузополучателе)
- RowTable – строка табличной части документа
- Parameter – параметры документа или строки табличной части документа.
Общее описание формата
№ | Имя | Общее описание |
---|---|---|
1 | PacketId | Уникальный идентификатор пакета документов. По этому идентификатору осуществляется подбор документов в пакет. Обязателен для каждой строки файла. |
2 | RowType | Код блока данных. Обязателен для каждой строки файла. По значению этого поля определяется то, какие данные записаны в строке: данные документа, данные табличной части, данные участника документооборота и пр. Может принимать значения:
|
3 | Documentid | Пользовательский идентификатор документа. По нему собирается информация по конкретному документу. |
4 | RowIndex | Порядковый номер |
5 | Type | Тип |
6 | Id | Идентификатор |
7 | Name | Название |
8 | Value | Значение |
9 | Number | Номер |
10 | Date | Дата |
11 | UnitCode | Код единицы измерения |
12 | UnitName | Наименование единицы измерения |
13 | Amount | Количество |
14 | Price | Цена |
15 | Sum | Сумма без учета налога |
16 | Total | Сумма c учетом налога |
17 | TaxSum | Сумма налога |
18 | TaxType | Тип налоговой ставки |
19 | TaxRate | Значение налоговой ставки |
20 | ExciseSum | Сумма акциза |
21 | GrossWeight | Вес брутто |
22 | NetWeight | Вес нетто |
23 | Pack | Количество упаковок (мест) |
24 | AmountPack | Количество в одной упаковке (месте) |
25 | Inn | ИНН |
26 | Kpp | КПП |
27 | Адрес электронной почты | |
28 | Phone | Номер телефона |
29 | Address | Адрес |
30 | BankName | Наименование банка |
31 | BankId | БИК банка |
32 | BankAcc | Номер Расч. счета |
33 | BankCorAcc | Номер корр. счета |
Ниже описан порядок заполнения каждого блока. Столбцы у которых не заполнено описание, заполнять не нужно.
Порядок заполнения блоков
Заполнение блока Packet
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | Уникальный идентификатор пакета документов в Вашей системе. По данному идентификатору Вашей системе будут возвращаться сообщения о статусах документооборота. Все блоки относящиеся к данному пакету содержат данный идентификатор. |
2 | RowType | Packet |
3 | Documentid | |
4 | RowIndex | |
5 | Type | окОтгрИсх (Реализация), КоррИсх (Корреспонденция), через какой реестр личного кабинета будет отправлен данный пакет документов. Остальные допустимые значения уточняйте в отделе внедрения ЭДО. |
6 | Id | |
7 | Name | Примечание к пакету документов, будет отображаться в реестре личного кабинета |
8 | Value | |
9 | Number | |
10 | Date | |
11 | UnitCode | |
12 | UnitName | |
13 | Amount | |
14 | Price | |
15 | Sum | |
16 | Total | |
17 | TaxSum | |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | |
22 | NetWeight | |
23 | Pack | |
24 | AmountPack | |
25 | Inn | |
26 | Kpp | |
27 | ||
28 | Phone | |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |
Заполнение блока Party для блока Packet
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | Party |
3 | Documentid | |
4 | RowIndex | |
5 | Type | Sender (Отправитель) / Receiver (Получатель), В каждом пакете должен быть указан и отправитель и получатель |
6 | Id | |
7 | Name | Название отправителя или получателя |
8 | Value | |
9 | Number | Код подразделения за которым будет закреплен документ (не обязательно) |
10 | Date | |
11 | UnitCode | Код ответственного за которым будет закреплен документ (не обязательно) |
12 | UnitName | ФИО ответственного за которым будет закреплен документ (не обязательно) |
13 | Amount | |
14 | Price | |
15 | Sum | |
16 | Total | |
17 | TaxSum | |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | |
22 | NetWeight | |
23 | Pack | |
24 | AmountPack | |
25 | Inn | ИНН обязательно |
26 | Kpp | КПП обязательно для юр.лиц |
27 | на данный адрес будет отправлено приглашение если клиент еще не подключен к системе | |
28 | Phone | на данный телефон будет сделан звонок если клиент еще не подключен к системе |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |
Заполнение блока Document
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | Document |
3 | Documentid | Идентификатор документа в Вашей системе или порядковый номер документа в рамках пакета. Обязательно для каждого документа. |
4 | RowIndex | Порядковый номер документа в данном пакете. |
5 | Type | Тип отправляемого документа (Счет- фактура, счет на оплату, акт выполненных работ, товарная накладная и пр.) |
6 | Id | |
7 | Name | Заголовок документа (например, Счет-фактура №1 от 23.04.2014 на сумму 23 руб.) Будет отображать в списке документов (кроме счетов-фактур, актов и накладных). |
8 | Value | |
9 | Number | Номер документа |
10 | Date | Дата документа |
11 | UnitCode | |
12 | UnitName | |
13 | Amount | Общее количество товаров/услуг |
14 | Price | |
15 | Sum | Сумма по документу без налога |
16 | Total | Сумма по документу с налогом |
17 | TaxSum | Сумма налога по документу |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | Брутто всего |
22 | NetWeight | Нетто всего |
23 | Pack | Количество мест всего |
24 | AmountPack | |
25 | Inn | |
26 | Kpp | |
27 | ||
28 | Phone | |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |
Заполнение блока Base
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | Base |
3 | Documentid | Documentid |
4 | RowIndex | |
5 | Type | Название документа основания, например Договор, ПРД |
6 | Id | |
7 | Name | Заголовок документа основания (например, Реализация товаров услуг №1 от 23.04.2014 на сумму 23 руб.) (не обязательно) |
8 | Value | |
9 | Number | Номер документа основания |
10 | Date | Дата документа основания |
11 | UnitCode | |
12 | UnitName | |
13 | Amount | |
14 | Price | |
15 | Sum | Сумма документа основания (не обязательно) |
16 | Total | |
17 | TaxSum | |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | |
22 | NetWeight | |
23 | Pack | |
24 | AmountPack | |
25 | Inn | |
26 | Kpp | |
27 | ||
28 | Phone | |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |
Заполнение блока Party для блока Document
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | Party |
3 | Documentid | Documentid |
4 | RowIndex | |
5 | Type |
|
6 | Id | |
7 | Name | Название организации |
8 | Value | |
9 | Number | |
10 | Date | |
11 | UnitCode | |
12 | UnitName | |
13 | Amount | |
14 | Price | |
15 | Sum | |
16 | Total | |
17 | TaxSum | |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | |
22 | NetWeight | |
23 | Pack | |
24 | AmountPack | |
25 | Inn | ИНН организации |
26 | Kpp | КПП организации |
27 | Адрес электронной почты | |
28 | Phone | Номер телефона |
29 | Address | Адрес |
30 | BankName | Наименование банка |
31 | BankId | БИК банка |
32 | BankAcc | Номер лицевого банковского счета |
33 | BankCorAcc | Номер корр. Счета |
Заполнение блока RowTable
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | RowTable |
3 | Documentid | Documentid |
4 | RowIndex | Порядковый номер строки, уникальный в рамках одного документа |
5 | Type | |
6 | Id | Уникальный идентификатор товара/услуги |
7 | Name | |
8 | Value | |
9 | Number | |
10 | Date | |
11 | UnitCode | Код единицы измерения по ОКЕИ |
12 | UnitName | Наименование единицы измерения |
13 | Amount | Количество товара |
14 | Price | Цена |
15 | Sum | Сумма без учета налога |
16 | Total | Сумма c учетом налога |
17 | TaxSum | Сумма налога |
18 | TaxType | Тип налоговой ставки. Может принимать значение:
|
19 | TaxRate | Величина налоговой ставки. Может принимать значения:
|
20 | ExciseSum | Сумма акциза. Указывается сумма или «без акциза» |
21 | GrossWeight | Вес брутто |
22 | NetWeight | Вес нетто |
23 | Pack | Количество мест (упаковок) |
24 | AmountPack | Количество в одном месте (упаковке) |
25 | Inn | |
26 | Kpp | |
27 | ||
28 | Phone | |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |
Заполнение блока Parameter
№ | Имя | Описание столбцов применительно к текущему блоку |
---|---|---|
1 | PacketId | PacketId |
2 | RowType | Parameter |
3 | Documentid | Documentid |
4 | RowIndex | Пусто для параметров документа, для параметров строки табличной части - порядковый номер строки. |
5 | Type | |
6 | Id | |
7 | Name | Имя параметра |
8 | Value | Значение параметра |
9 | Number | |
10 | Date | |
11 | UnitCode | |
12 | UnitName | |
13 | Amount | |
14 | Price | |
15 | Sum | |
16 | Total | |
17 | TaxSum | |
18 | TaxType | |
19 | TaxRate | |
20 | ExciseSum | |
21 | GrossWeight | |
22 | NetWeight | |
23 | Pack | |
24 | AmountPack | |
25 | Inn | |
26 | Kpp | |
27 | ||
28 | Phone | |
29 | Address | |
30 | BankName | |
31 | BankId | |
32 | BankAcc | |
33 | BankCorAcc |