Описание форматов файлов экспорта документов.docx

Экспорт товарных документов

Описание форматов файлов экспорта документов

Оглавление

Параметры экспорта документов настраиваются на форме Администрирование – Приложение – Интеграция на вкладке Экспорт документов . Все документы, подходящие под параметры выгрузки, выгружаются одним файлом выбранного формата. Название экспортированного файла состоит из текста “ skuLedger ” и дат начала и окончания периода, за который выгружаются документы, например, “ skuLedger_2025-05-31_2025-06-29.xml” .

Экспорт документов в файлы XLSX и CSV

При экспорте документов в файл формата xlsx или csv файл будет содержать перечень строк всех экспортированных документов. По каждой строке файл содержит перечень данных, приведенные в таблице (рис. 1). Если документ не содержит данные по какому-либо из полей , то его значение принимается равным нулю и не отображается в документе экспорта (рис.2).

Структура файлов xlsx, csv

Имя поля	Значение	Тип поля	Max длина
type	тип документа	STRING	50
number	номер документа	STRING	48
series	серия документа	STRING	2
dateTime	дата и время документа	DATETIME	YYYY-MM-DDTHH:MM:SS (csv) YYYY.MM.DD,THH:MM:SS ( xlsx )
idOperation	идентификатор операции документа	STRING	100
nameOperation	наименование операции документа	STRING	100
idStock	идентификатор склада	STRING	100
nameStock	наименование склада	STRING	150
idLegalEntity	идентификатор организации-контрагента	STRING	100
nameLegalEntity	наименование организации- контрагента	STRING	150
idLegalEntityStock	идентификатор склада организации- контрагента	STRING	100
nameLegalEntityStock	наименование склада организации- контрагента	STRING	150
idBarcode	штрихкод товара	STRING	15
idSKU	код товара	STRING	100
nameSKU	наименование товара	STRING	225
measurement	единица измерения товара	STRING	100
valuVAT	ставка НДС	NUMERIC	10, 5
signedQuantity	количество товара	NUMERIC	16, 5
signedSum	сумма	NUMERIC	18, 4

Рис. 1 Пример экспорта документов закупки в формате xlsx

Рис. 2 Пример экспорта документа инвентаризация в формате csv , в котором нет данных по контрагенту

Экспорт документов в файл XML

При экспорте документов в файл формата xml данные каждого документа содержатся в элементе < documents >, а данные товарных строк в дочерних элементах < documentDetails > (рис. 3). Если документ не содержит данные по какому-либо элементу, пустые тэги в файл выгрузки не добавляются.

Структура файла xml

Родительский элемент	Элемент	Значение	Тип значения	Max длина
<documents>		включает элементы, содержащие данные об отдельном документе и строках этого документа
	<type>	тип документа	STRING	50
	<number>	номер документа	STRING	48
	<series>	серия документа	STRING	2
	<dateTime>	дата и время документа	DATETIME	YYYY-MM-DDTHH:MM:SS
	<idOperation>	идентификатор операции документа	STRING	100
	<nameOperation>	наименование операции документа	STRING	100
	<idStock>	идентификатор склада	STRING	100
	<nameStock>	наименование склада	STRING	150
	<idLegalEntity>	идентификатор организации-контрагента	STRING	100
	<nameLegalEntity>	наименование организации- контрагента	STRING	150
	<idLegalEntityStock>	идентификатор склада организации- контрагента	STRING	100
	<nameLegalEntityStock>	наименование склада организации- контрагента	STRING	150
	<sum>	общая сумма по документу	NUMERIC	18, 4
	<documentDetails>	включает элементы, содержащие данные по отдельной товарной строке
<documentDetails>		включает элементы, содержащие данные по отдельной товарной строке
	<idBarcode>	штрихкод товара	STRING	15
	<idSKU>	код товара	STRING	100
	<nameSKU>	наименование товара	STRING	225
	<measurement>	единица измерения товара	STRING	100
	<valuVAT>	ставка НДС	NUMERIC	10, 5
	<signedQuantity>	количество товара	NUMERIC	16, 5
	<signedSum>	сумма	NUMERIC	18, 4

Рис. 3 Пример экспорта документа закупки в формате xml

Экспорт документов в файл JSON

JSON файл для экспорта документов представляет собой массив объектов – документов (“ documents ”), каждый элемент которого содержит ключи – характеристики документа и вложенный массив объектов – строки документа (“ documentDetails ”), который содержит ключи – данные строк документа (рис. 4). Если экспортируемый документ не содержит данные по какой-либо характеристике, ключи с нулевыми значениями в файл выгрузки не добавляются.

Структура файла JSON

Массив	Ключ св-ва документа	Значение св-ва документа	Тип значения ключа	Max длина
“documents”		массив, каждый объект массива содержит данные по 1 документу
	“type”	тип документа	STRING	50
	“number”	номер документа	STRING	48
	“series”	серия документа	STRING	2
	“dateTime”	дата и время документа	DATETIME	YYYY-MM-DDTHH:MM:SS
	“idOperation”	идентификатор операции документа	STRING	100
	“nameOperation”	наименование операции документа	STRING	100
	“idStock”	идентификатор склада	STRING	100
	“nameStock”	наименование склада	STRING	150
	“idLegalEntity”	идентификатор организации-контрагента	STRING	100
	“nameLegalEntity”	наименование организации- контрагента	STRING	150
	“idLegalEntityStock”	идентификатор склада организации- контрагента	STRING	100
	“nameLegalEntityStock”	наименование склада организации- контрагента	STRING	150
	“sum”	общая сумма по документу	NUMERIC	18, 4
	“documentDetails”	вложенный массив, содержащий данные по строкам документа
“documentDetails”		вложенный массив, каждый объект массива содержит данные по 1 строке документа
	“idBarcode”	штрихкод товара	STRING	15
	“idSKU”	код товара	STRING	100
	“nameSKU”	наименование товара	STRING	225
	“measurement”	единица измерения товара	STRING	100
	“valuVAT”	ставка НДС	NUMERIC	10, 5
	“signedQuantity”	количество товара	NUMERIC	16, 5
	“signedSum”	сумма	NUMERIC	18, 4

Рис. 4 Пример экспорта документов закупка-возврат в формате json

Page tree