Результатом работы обработки является 5 файлов формата csv. Подробное описание этих файлов приведу прямо из документации любезно предоставленной сотрудниками компании Pradata:
Форматы файлов для системы SPOT 2D
- все файлы необходимо готовить в кодировке Windows-1251
- при написании выгрузок из учетной системы нужно создать возможность задавать период выгружаемых данных, так возможны ситуации, когда нужно выгрузить данные более чем за 45 дней (стандартная выгрузка)
1.1. Tаблица продуктов products (products.csv)
Предоставить из Вашей системы таблицу продуктов products (продукты, которые продавались с начала 2012 года, и по которым составлены данные по отгрузкам и остаткам) в формате:
- Штрих-код производителя
- Артикул производителя
- Название продукта
- Количество /вес в упаковке
- Единица измерения (в которой ведется отгрузка конкретной позиции на торговую точку)
Пример файла:
Штрих-код производителя |
Артикул |
Название продукта |
шт/упаковке |
Единица измерения |
000000000000000 |
5555 |
Укрпродукт 1 |
5 |
Шт |
111111111111111 |
5558 |
Укрпродукт 2 |
10 |
Кг |
888888888888888 |
999600 |
Укрпродукт 3 |
20 |
ящ |
1.2. Таблица торговых точек (clients.csv)
— выгрузка должна происходить таким образом, чтобы в файле clients были ТОЛЬКО ТЕ клиенты, по которым были продажи по продукции Укрпродукт за период, указанный в delivery (стр 5)
Для того, чтобы проимпортировать данные на сайт следует подготовить файл в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков. В список должны попасть все клиенты, покупавшие продукцию Укрпродукт за последние 45 дней
Код дистрибьютора уникален в системе и выдается каждому дистрибьютору лично (стр.1)
В таблицу клиентов выгружаются поля : Код дистрибьютора, Код Торговой Точки, название клиента с название ТТ в одной строке (через дефис), адрес ТТ
Пример файла для импорта клиентов:
Distr_Code |
Client_Code |
Client_Name |
Client_Adress |
23 |
126785294 |
ООО Сириус- маг№1 |
Киев, Коминтерна 2 |
23 |
357648593 |
ООО Сириус- маг№2 |
Киев, Победы пр 3 |
23 |
458576945 |
ООО Сириус- маг№3 |
Киев, Саксаганского 20 |
Поля таблицы:
Поле |
Формат |
Комментарий |
Distr_Code |
String |
код дистрибьютора в системе SPOT 2D |
Client_Code |
String |
уникальный код ТТ в системе дистрибьютора |
Client_Name |
String |
название клиента в системе дистрибьютора – назв. ТТ |
Client_Address |
String |
адрес ТТ в системе дистрибьютора |
Если у клиента НЕТ торговых точек, тогда их выгружать в файл по следующей схеме:
Поле |
Формат |
Комментарий |
Distr_Code |
String |
Код дистрибьютора в системе SPOT 2D |
Client_Code |
String |
Код клиента в системе дистрибьютора |
Client_Name |
String |
Название клиента в системе дистрибьютора |
Client_Address |
String |
Адрес клиента в системе дистрибьютора |
1.3 Таблица торговых агентов (ta.csv)
Для того, чтобы проимпортировать список торговых агентов на сайт, следует подготовить файл с данными в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков.
Пример:
Distr_Code |
TA_Code |
ТА_Name |
TA_Type |
TA_City |
36 |
126785294 |
Хтосько Егор |
|
|
36 |
126785294 |
Батькович Петро |
|
|
Поля таблицы:
* обязательные поля
Поле |
Формат |
Комментарий |
*Distr_Code |
String |
код дистрибьютора в системе SPOT 2D |
*TA_Code |
String |
уникальный код ТА в системе дистрибьютора |
*ТА_Name |
String |
ФИО ТА |
TA_Type |
String |
тип торгового агента |
TA_City |
String |
город |
1.4 Таблица отгрузок (delivery.csv)
— данный файл должен формироваться на основе тех же таблиц с данными, по которым готовится отчетность для представителей производителя «Укрпродукт» на текущее время.
Данные об отгрузках импортируются ежедневно за период со вчера и минус 45 дней
На каждую отгрузку товара необходимо указать, какому агенту зачесть эту продажу.
Для того, чтобы проимпортировать данные об отгрузках на сайт, следует подготовить файл с данными в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков.
В качестве даты отгрузки клиенту проставляется фактическая дата отгрузки
Пример файла для импорта отгрузок:
Distr_Code |
Client_Code |
Del_Date |
SKU_Code |
Del_Volume |
Del_Amount |
Ta_code |
36 |
126785294 |
10.06.2005 |
123 |
2 |
2,5 |
Xz888 |
36 |
126785294 |
11.06.2005 |
234 |
3 |
2,4 |
Xz885 |
36 |
126785294 |
12.06.2005 |
345 |
10 |
1,7 |
Xz88 |
Поля таблицы:
Поле |
Формат |
Комментарий |
Distr_Code |
String |
Код дистрибьютора в системе SPOT 2D |
Client_Code |
String |
Код ТТ в системе дистрибьютора* |
Del_Date |
Date |
Дата отгрузки клиенту |
SKU_Code |
String |
Артикул производителя ** |
Del_Volume |
Integer |
Размер отгрузки в штуках*** |
Del_Amount |
Float |
Стоимость единицы в национальной валюте (С учетом НДС) |
Ta_code |
String |
Код ТА в системе дистрибьютора |
Если к продаже не привязан ТА – оставить пустое поле
* Если у клиента НЕТ торговых точек, тогда в поле «Client_Code» нужно выгружать «Код клиента в системе дистрибьютора»
** Если у дистрибьютора учет не ведется по акртикулам производителя, в данном поле должны указываться внутренние коды продуктов.
*** Возвраты отображаются в поле «Del_Volume» количеством с минусовым значением
1.5 Таблица остатков (stocks.csv)
*Данный файл должен формироваться на основе тех же таблиц с данными, по которым готовится отчетность для представителей производителя «Укрпродукт» на текущее время.
Остатки импортируются на сайт ежедневно, и показывают наличие товара на конец вчерашнего дня.
Дата в файле – вчерашний день от даты выгрузки
Для того, чтобы проимпортировать данные об остатках на сайт, следует подготовить файл с данными в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков
Пример файла для импорта остатков:
Distr_Code |
Stock_Date |
SKU_Code |
Stock_Volume |
36 |
10.06.2005 |
123 |
2 |
36 |
10.06.2005 |
234 |
3 |
36 |
10.06.2005 |
345 |
10 |
36 |
10.06.2005 |
456 |
1 |
Поля таблицы:
Поле |
Формат |
Комментарий |
Distr_Code |
String |
Код дистрибьютора в системе SPOT 2D |
Stock_Date |
Date |
Дата подсчета остатков (конец вчерашнего дня) |
SKU_Code |
String |
Артикул производителя* |
Stock_Volume |
Integer |
Размер остатков в штуках |
* Если у дистрибьютора учет не ведется по артикулам производителя, в данном поле должны указываться внутренние коды продуктов.