Общее описание форматов файлов для выгрузки

Вводные данные

Производитель	Saint Gobain
Цены в файлах указаны с НДС/Без НДС	Без НДС
Единицы измерения продукции производителя	в штуках
Перечень файлов	Delivery, stocks, clients, ta, sku
Загрузка исторических данных	С 01.01.2017

Описание этапов подключения

 

№	Название	Длительность, раб.дни	Ответственный
1	Отправка технического задания на ИТ специалиста дистрибьютора	1	Прадата
2	Подготовка тестовых данных согласно полученного технического задания	5	Дистрибутор
3	Проверка тестовых данных, повтор операции до исправления ошибок:	5	Прадата, Дистрибутор
3.1	- проверка тестовых файлов на соответствие ТЗ
3.2	- проверка полноты тестовых файлов (сверка со стандартными отчетами по продажам, остаткам, приходам из учетной системы дистрибьютора)
3.3	- проверка расчетного остатка (расчетный остаток = stocks на начало + receive - delivery + /- cancellations)
4	Предоставление ИТ специалисту дистрибьютора логина/пароля доступа на сайт, а также инструкции по автоматизации выгрузки данных. Запрос на выгрузку истории продаж	1	Прадата
5	ИТ специалист дистрибьютора настраивает выгрузку данных, о чем сообщает в Pradata, а также предоставляет историю продаж	2	Дистрибутор
6	Подтверждение успешного получения данных от дистрибьютора в автоматическом режиме, уведомление производителя	3	Прадата
7	Проверка результатов подключения дистрибутора (сопоставление продуктов, сверка данных между Spot2D и отчетом дистрибьютора)	3	Производитель

Общее описание форматов файлов для выгрузки

Файлы необходимо подготовить в формате:

· Текстовый файл.CSV с разделителями «;»

· Таблица с обязательными заголовками в первой строке каждого файла (заголовки указаны в описании таблиц)

· Кодировка файла Windows-1251 или UTF-8

· Если значения ячеек содержат зарезервированные символы (двойная кавычка, точка с запятой, переход на новую строку), то данные ячеек этого типа следует взять в двойные кавычки (“). Если в значениях ячеек встречаются кавычки — они представляются в файле в виде двух кавычек подряд (“”). Строки разделяются парой символов CR LF (0x0D 0x0A) (в DOS и Windows эта пара генерируется нажатием клавиши Enter) и LF (0x0A) в системах UNIX.

Описание файла оборота продукции delivery.csv

Данные об обороте продукции (отгрузки на ТТ, возвраты с ТТ, корректировочный СФ) загружаются на сайт ежедневно за период со вчера и минус 45 дней (например, если файлы формируются 15.02.2015, тогда delivery должен содержать информацию за период с 1.01.2015 по 14.02.2015 включительно). 

В файл не должны попадать списания, перемещения, пересортица и другие операции инвентаризации.

 

В столбце «Количество» при продаже позиций Gyproc, Isover, Weber необходимо указывать единицу измерения штуки (кол-во проданных единиц).

 

Обратите внимание, что необходимо создать возможность задавать период выгружаемых данных, так как будут ситуации, когда нужно выгрузить информацию более чем за 45 дней (исторические данные).

Описание таблицы:

 

Название заголовка	Формат	Комментарий
id дистрибьютора	Integer	Код дистрибьютора в системе SPOT 2D, указан в теле письма
Код клиента ERP	String (128)	Уникальный код связки кода клиента (контрагента) и кода торговой точки (точки доставки). Детально описание см. в файле clients.csv
Дата	Date	фактическая дата отгрузки или возврата в ТТ в одном из указанных форматов: dd.mm.yy, dd-mm-yy, dd.m.yy, dd-mm-yyyy, dd.mm.yyyy, dd-m-yyyy, yyyy.mm.dd, yyyy-mm-dd, yyyy-m-dd, yyyy-m-d, yyyy-mm-d
Код продукта дистрибьютора	String (128)	Внутренний код продукта из УС дистрибьютора.
Количество	Float	Размер отгрузки в единицах измерения (штуках) продукции производителя. Возврат со знаком минус.
Сумма отгрузки	Float	Стоимость всей отгрузки/возврата в национальной валюте без НДС. Сумма возврата со знаком минус. В случаи когда сумма отгрузки не будет выгружаться, то в этом поле, ставим константу «0» или «0,01».
Код ТА	String (64)	Код торгового представителя или агента (ТА) на которого зачислена продажа, если к продаже не привязан ТА необходимо оставить поле пустым.
Номер расходной накладной	String (128)	Номер расходной или возвратной накладной из УС дистрибьютора.

 

Пример файла:

 

id дистри бьютора	Код клиента ERP	Дата	Код продукта дистри бьютора	Коли чество	Сумма отгрузки	Код ТА	Номер расходной накладной
39	8000759#1	15.01.2018	6107	12	0,01	5167	Т000002638
39	8000759#1	15.01.2018	6118	12	0,01	5167	Т000002638
39	8000759#1	15.01.2018	6113	12	0,01	5167	Т000002638
39	8000759#1	15.01.2018	9210	6	0,01	5167	Т000002638
39	8000759#1	15.01.2018	6395	6	0,01	5167	Т000002638

 

Таблица торговых точек (clients.csv)

Файл clients должен содержать только те торговые точки, по которым были продажи или возвраты продукции производителя за период, указанный в файле delivery. Файл должен выгружаться на сайт ежедневно.

Описание таблицы:

Название заголовка	Формат (размер)	Комментарий
ID дистрибьютора	Integer	Код дистрибьютора в системе SPOT 2D, указан в теле письма.
Код клиента ERP	String (128)	Уникальный код связки кода клиента и кода точки доставки. Пример правильного кода XXXXXXX#YYYYYY Где, XXXXXXX – код клиента (контрагента) YYYYYY – код точки доставки # - разделитель # без пробелов. Например, 000002599#000003727 Если в системе дистрибутора есть только один из кодов (клиента или точки доставки), то формат связки кода должен выгружаться в виде XXXXXXX#XXXXXXX
Название клиента	String (128)	Краткое юридическое название клиента. Например, Абишева А.М. ИП
Адрес клиента	String (255)	Фактический адрес доставки в системе дистрибьютора.   Необходимый формат адресной строки:

Дата

Название клиента

Код клиента

Название продукта

Код продукта

Сумма продажи без НДС

Сумма продажи с НДС

       

 

 

 

 

 

 

 

 

   

 

 

 

 

 

 

 

 

   

 

Пример отчета по остаткам, сформированный за тот же период, что и файл stocks.csv:

Дата остатка	Название продукта	Код продукта	Остаток, шт	Сумма остатка в закупочных ценах с НДС	Сумма остатка в закупочных ценах без НДС

 

 

Эти отчеты могут быть размещены в любом удобном для Вас порядке, например, отдельный файл для каждого отчета, 2 отчета в одном файле на разных листах, 2 отчета в одном файле на одном листе.

 

Вводные данные

Производитель	Saint Gobain
Цены в файлах указаны с НДС/Без НДС	Без НДС
Единицы измерения продукции производителя	в штуках
Перечень файлов	Delivery, stocks, clients, ta, sku
Загрузка исторических данных	С 01.01.2017

Описание этапов подключения

 

№	Название	Длительность, раб.дни	Ответственный
1	Отправка технического задания на ИТ специалиста дистрибьютора	1	Прадата
2	Подготовка тестовых данных согласно полученного технического задания	5	Дистрибутор
3	Проверка тестовых данных, повтор операции до исправления ошибок:	5	Прадата, Дистрибутор
3.1	- проверка тестовых файлов на соответствие ТЗ
3.2	- проверка полноты тестовых файлов (сверка со стандартными отчетами по продажам, остаткам, приходам из учетной системы дистрибьютора)
3.3	- проверка расчетного остатка (расчетный остаток = stocks на начало + receive - delivery + /- cancellations)
4	Предоставление ИТ специалисту дистрибьютора логина/пароля доступа на сайт, а также инструкции по автоматизации выгрузки данных. Запрос на выгрузку истории продаж	1	Прадата
5	ИТ специалист дистрибьютора настраивает выгрузку данных, о чем сообщает в Pradata, а также предоставляет историю продаж	2	Дистрибутор
6	Подтверждение успешного получения данных от дистрибьютора в автоматическом режиме, уведомление производителя	3	Прадата
7	Проверка результатов подключения дистрибутора (сопоставление продуктов, сверка данных между Spot2D и отчетом дистрибьютора)	3	Производитель

Общее описание форматов файлов для выгрузки

Файлы необходимо подготовить в формате:

· Текстовый файл.CSV с разделителями «;»

· Таблица с обязательными заголовками в первой строке каждого файла (заголовки указаны в описании таблиц)

· Кодировка файла Windows-1251 или UTF-8

· Если значения ячеек содержат зарезервированные символы (двойная кавычка, точка с запятой, переход на новую строку), то данные ячеек этого типа следует взять в двойные кавычки (“). Если в значениях ячеек встречаются кавычки — они представляются в файле в виде двух кавычек подряд (“”). Строки разделяются парой символов CR LF (0x0D 0x0A) (в DOS и Windows эта пара генерируется нажатием клавиши Enter) и LF (0x0A) в системах UNIX.