Конверт: рекомендованная стурктура для файлов формата DBF или CSV

Материал из razgovorov.ru
Перейти к: навигация, поиск

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

Логическая схема формата

Данный формат разрабатывался с целью поместить в один dbf/csv файл (одну таблицу) данные нескольких пакетов документов и всех их вложений. Формат содержит 33 строковых поля. Порядок следования полей фиксированный. Поскольку данный формат применяется одновременно для dbf и csv, то имена столбцов dbf файла служат только для удобства использования, при конвертации имеет смысл только порядковый номер столбца, поэтому нарушение порядка следования столбцов при создании файла приведет к ошибкам конвертации документов. Данные таблицы условно поделены на 6 блоков.

SBISConnect DBFScheme.png

  • Packet – информация о пакете
  • Document – шапка документа
  • Base – информация о документах основаниях (например платежно-расчетные документы или договора на основании которых сделан конкретный документ)
  • Party – информация об участнике документооборота, сведения об отправителе получателе пакета, поставщике , покупателе грузоотправителе и грузополучателе)
  • RowTable – строка табличной части документа
  • Parameter – параметры документа или строки табличной части документа.


Общее описание формата

Имя Общее описание
1 PacketId Уникальный идентификатор пакета документов. По этому идентификатору осуществляется подбор документов в пакет. Обязателен для каждой строки файла.
2 RowType Код блока данных. Обязателен для каждой строки файла. По значению этого поля определяется то, какие данные записаны в строке: данные документа, данные табличной части, данные участника документооборота и пр. Может принимать значения:
  • Packet – информация о пакете
  • Document – Блок содержит информацию о документах, в одном пакете может передаваться несколько документов, например счет фактура и накладная. Данный блок заполняется для каждого документа пакета.
  • Base – информация о документах основаниях (например платежно-расчетные документы или договора на основании которых сделан конкретный документ)
  • Party – информация об участнике документооборота, сведения об отправителе получателе пакета, поставщике , покупателе грузоотправителе и грузополучателе)
  • RowTable – строка табличной части документа
  • Parameter - параметры документа или строки табличной части документа.
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 Email Адрес электронной почты
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 Email
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 Email на данный адрес будет отправлено приглашение если клиент еще не подключен к системе
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 Email
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 Email
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
  • Seller – поставщик
  • Buyer - покупатель
  • Shipper – грузоотправитель (не обязательно)
  • Consignee – грузополучатель (не обязательно)
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 Email Адрес электронной почты
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 Тип налоговой ставки. Может принимать значение:
  • Текст - Для величины налоговой ставки, принимающей значение "без НДС"
  • Процент - Для величины налоговой ставки, принимающей значения 0,10,18,20
  • Дробь- Для величин налоговой ставки, принимающей значения 10/110,18/118
19 TaxRate Величина налоговой ставки. Может принимать значения:
  • 0
  • 10
  • 18
  • 20
  • 10/110
  • 18/118
  • без НДС
20 ExciseSum Сумма акциза. Указывается сумма или «без акциза»
21 GrossWeight Вес брутто
22 NetWeight Вес нетто
23 Pack Количество мест (упаковок)
24 AmountPack Количество в одном месте (упаковке)
25 Inn
26 Kpp
27 Email
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 Email
28 Phone
29 Address
30 BankName
31 BankId
32 BankAcc
33 BankCorAcc