3. Спецификация файлов и командной строки для

Система «SPOT2D» для производителя «ESTA»
Описание формата отчетов и способа отправки в систему SPOT2D
Шаги по внедрению проекта для дистрибьютора следующие:
№
1
Задача
Назначить ответственных за проект SPOT 2D и выслать информацию о них
в следующем формате:
- технический специалист – ФИО, телефон, мейл;
- оператор сайта
2
Изучить документацию по проекту SPOT 2D
3
Предоставить таблицу продуктов «ESTA» (продукты, которые продавались
с начала 2012 года) из Вашей системы
4
Создать возможность экспорта данных о клиентах, отгрузках и остатках по
структуре SPOT 2D описано ниже) и выслать нам 5 файлов с тестовым
примером данных:
- таблица продуктов (sku.csv)
- таблица клиентов (clients.csv)
- таблица торговых агентов (ta.csv)
- таблица отгрузок (delivery.csv)
- таблица остатков (stocks.csv)
- отчет по продажам и остаткам (otchet.xls)
5
После утверждения присланных файлов - настроить автоматическую
выгрузку созданных отчетов
После выполнения этих задач Вам будут предоставлены:
адрес, логин и пароль входа в систему;
инструкция пользователя системы.
ВАШ КОД В СИСТЕМЕ SPOT 2D (Distr_Code) – 103
Контактные лица со стороны PRADATA:
Алёна Шульга
Инна Никитина
Катерина Подлеснюк
Екатерина Котельникова
Моб.тел:
+3 (067)658-77-46
+3 (099)244-20-76
Skype:alena_shulga1
Моб.тел:
+3 (067) 236-20-50
+3 (099) 244-20-65
Skype : nikitina.inna1
Моб.тел:
+38 (067) 658-76-65
+38 (050) 161-18-58
Skype : kate_podlesniuk
Моб.тел:
+38 (067)40-35-125
+38 (050)161-13-15
Skype: kateeeee31
E-mail :
alena@pradata.com
E-mail :
inna@pradata.com
E-mail :
katya@pradata.com
E-mail:
katerina@pradata.com
Оглавление:
1.Форматы файлов для системы SPOT 2D
1.1 Таблица продуктов SKU (sku.csv)
1.2 Таблица клиентов (clients.csv)
1.3 Таблица торговых агентов (ta.csv)
1.4 Таблица отгрузок (delivery.csv)
1.5 Таблица остатков (stocks.csv)
1.6. Отчет по продажам в разрезе клиентов и продуктов, отчет по остаткам (проверка
корректности присланных данных)
2. Инструкция по автоматической закачке данных в SPOT 2D
3. Спецификация файлов и командной строки для дистрибьюторов SPOT 2D
2
1. Форматы файлов для системы SPOT 2D
- все файлы необходимо готовить в кодировке Windows-1251
- при написании выгрузок из учетной системы, нужно создать возможность задавать период
выгружаемых данных, так возможны ситуации, когда нужно выгрузить данные более чем за 45 дней
(стандартная выгрузка)
1.1. Tаблица продуктов SKU (sku.csv)
Предоставить из Вашей системы таблицу продуктов SKU (продукты, которые продавались с
начала 2012 года, и по которым составлены данные по отгрузкам и остаткам) в формате:
Текстовый файл .CSV с разделителями – «;» без заголовков.
Пример файла для импорта продуктов:
SCU_Name
ESTA 1
Pack_unit Meas_unit
5
Шт
23 111111111111111 5558
ESTA 2
10
Кг
23 888888888888888 999600
ESTA 3
20
ящ
Distr_Code Barcode
SKU_Code
23 000000000000000 5555
Поля таблицы:
Поле
Distr_Code
Barcode
SKU_Code
SCU_Name
Pack_unit
Meas_unit
Формат
String
String
String
String
String
String
Комментарий
код дистрибьютора в системе SPOT 2D
Штрих-код
Артикул производителя*
Название продукта
Количество штук в упаковке
Единица измерения
* Если у дистрибьютора учет НЕ ведется по артикулам производителя, в данном поле должны
указываться внутренние коды продуктов.
3
1.2. Таблица торговых точек (clients.csv)
- выгрузка должна происходить таким образом, чтобы в файле clients были ТОЛЬКО ТЕ
клиенты, по которым были продажи по продукции ESTA за период, указанный в delivery (стр 5)
Для того, чтобы проимпортировать данные на сайт следует подготовить файл в следующем
формате:
Текстовый файл .CSV с разделителями – «;» без заголовков. В список должны попасть все
клиенты, покупавшие продукцию ESTA за последние 45 дней
Код дистрибьютора уникален в системе и выдается каждому дистрибьютору лично (стр.1)
В таблицу клиентов выгружаются поля : Код дистрибьютора, Код Торговой Точки, название
клиента с название ТТ в одной строке (через дефис), адрес ТТ
Пример файла для импорта клиентов:
Distr_Code
23
23
23
Client_Code
126785294
357648593
458576945
Client_Name
ООО Сириус- маг№1
ООО Сириус- маг№2
ООО Сириус- маг№3
Client_Adress
Киев, Коминтерна 2
Киев, Победы пр 3
Киев, Саксаганского 20
Поля таблицы:
Поле
*Distr_Code
*Client_Code
*Client_Name
*Client_Address
Client_obl
Client_city
Формат
String
String
String
String
String
String
Комментарий
код дистрибьютора в системе SPOT 2D
уникальный код ТТ в системе дистрибьютора
название клиента в системе дистрибьютора – назв. ТТ
адрес ТТ в системе дистрибьютора
область клиента;
город клиента;
* Обязательные поля
Если у клиента НЕТ торговых точек, тогда их выгружать в файл по следующей схеме:
Поле
Distr_Code
Client_Code
Client_Name
Client_Address
Формат
String
String
String
String
Комментарий
Код дистрибьютора в системе SPOT 2D
Код клиента в системе дистрибьютора
Название клиента в системе дистрибьютора
Адрес клиента в системе дистрибьютора
4
1.3 Таблица торговых агентов (ta.csv)
Для того, чтобы проимпортировать список торговых агентов на сайт, следует подготовить файл с
данными в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков.
Пример:
Distr_Code
36
36
TA_Code
126785294
126785294
ТА_Name
Хтосько Егор
Батькович Петро
TA_Type
TA_City
Поля таблицы:
* обязательные поля
Поле
*Distr_Code
*TA_Code
*ТА_Name
TA_Type
TA_City
Формат
String
String
String
String
String
Комментарий
код дистрибьютора в системе SPOT 2D
уникальный код ТА в системе дистрибьютора
уникальное название торгового агента
тип торгового агента
город
5
1.4 Таблица отгрузок (delivery.csv)
- данный файл должен формироваться на основе тех же таблиц с данными, по которым
готовится отчетность для представителей производителя «ESTA» на текущее время.
Данные об отгрузках импортируются ежедневно за период со вчера и минус 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
Client_Code
Del_Date
SKU_Code
Del_Volume
Del_Amount
Ta_code
Формат
String
String
Date
String
Integer
Float
String
Комментарий
Код дистрибьютора в системе SPOT 2D
Код ТТ в системе дистрибьютора*
Дата отгрузки клиенту
Артикул производителя **
Размер отгрузки в штуках***
Стоимость единицы в национальной валюте (С учетом НДС)
Код ТА в системе дистрибьютора
Если к продаже не привязан ТА – оставить пустое поле
* Если у клиента НЕТ торговых точек, тогда в поле «Client_Code» нужно выгружать «Код клиента
в системе дистрибьютора»
** Если у дистрибьютора учет не ведется по акртикулам производителя, в данном поле должны
указываться внутренние коды продуктов.
*** Возвраты отображаются в поле «Del_Volume» количеством с минусовым значением
6
1.5 Таблица остатков (stocks.csv)
*Данный файл должен формироваться на основе тех же таблиц с данными, по которым
готовится отчетность для представителей производителя «ESTA» на текущее время.
Остатки импортируются на сайт ежедневно, и показывают наличие товара на конец вчерашнего
дня.
Дата в файле – вчерашний день от даты выгрузки
Для того, чтобы проимпортировать данные об остатках на сайт, следует подготовить файл с
данными в следующем формате:
Текстовый файл .CSV с разделителями – «;» без заголовков
Пример файла для импорта остатков:
Distr_Code
36
36
36
36
Stock_Date
10.06.2005
10.06.2005
10.06.2005
10.06.2005
SKU_Code
123
234
345
456
Stock_Volume
2
3
10
1
Поля таблицы:
Поле
Distr_Code
Stock_Date
SKU_Code
Stock_Volume
Формат
String
Date
String
Integer
Комментарий
Код дистрибьютора в системе SPOT 2D
Дата подсчета остатков (конец вчерашнего дня)
Артикул производителя*
Размер остатков в штуках
* Если у дистрибьютора учет не ведется по артикулам производителя, в данном поле должны
указываться внутренние коды продуктов.
7
1.6. Отчет по продажам в разрезе клиентов и продуктов, отчет по остаткам (otchet.xls)
Для проверки корректности подготовленных выгрузок по продажам, клиентам, остаткам
производителя «ESTA», необходимо предоставить отчет по продажам в разрезе клиентов и
продуктов, сформированный за тот же период, что и файл delivery.csv и отчет по остаткам,
сформированный за тот же период, что и файл stocks.csv .
Файл (otchet.xls) должен быть максимально приближен к таблицам, приведенным ниже:
Отчет по продажам в разрезе клиентов и продуктов, сформированный за тот же период, что и
файл delivery.csv:
№ п/п
Название
клиента
Код
клиента
Название
продукта
Код
продукта
Количество
проданных
единиц
Сумма
продажи
Отчет по остаткам, сформированный за тот же период, что и файл stocks.csv:
№ п/п
Название
продукта
Код
продукта
Остаток, шт
Эти отчеты могут быть размещены в любом удобном для Вас порядке, например: отдельный
файл для каждого отчета, 2 отчета в одном файле на разных листах, 2 отчета в одном файле на
одном листе.
8
2. Инструкция по автоматической закачке данных в SPOT 2D (настраивается после
утверждения присланных тестовых данных)
Общие положения.
В системе SPOT 2D возможен способ автоматической закачки данных от дистрибьютора на сайт.
Для обмена используются те же файлы клиентов, остатков и отгрузок, что и при ручной загрузке,
но формируются и передаются на сайт автоматически, без участия пользователя.
Дистрибьютор выгружает напрямую в систему SPOT 2D из своей системы следующие файлы в
стандартном формате и в следующем порядке:
- в случае появления новых продуктов дистрибьютор самостоятельно обновляет таблицу
соответствия на сайте SPOT 2D до выгрузки прочих данных;
- список клиентов ежедневно – клиенты, покупавшие товар за последние 45 дней;
- остатки (текущие) ежедневно;
- отгрузки ежедневно за период со вчера и минус 45 дней.
Формирование данных и выгрузка на сайт SPOT 2D с 3 ночи до 5 утра каждый день.
Способ обмена данными.
Обмен данных осуществляется при помощи программы CURL и HTTP POST-запросов по адресу
https://esta.spot2d.com/dinfo/auto-upload.phtml
Пример командной строки:
curl -v -F "ufile=@FILEPATH;type=text/plain;filename=FILETYPE" -F "__login=LOGIN" -F
"__password=PASSWORD" -F "__did=DISTRID" http://ESTA.spot2d.com/dinfo/auto-upload.phtml
Описание переменных:
FILEPATH – путь к файлу с данными (может быть любой)
FILETYPE – тип данных в файле (обязательно один из трех установленных типов):
clients – таблица клиентов
stocks – таблица остатков
delivery – таблица отгрузок
products – таблица продуктов
LOGIN – логин пользователя в SPOT 2D
PASSWORD – пароль пользователя в SPOT 2D
DISTRID – код дистрибьютора в SPOT 2D
В случае ошибок система сразу же синхронно сообщает об этом на электронный адрес
пользователя, который размещает информацию (адрес указывается в установках пользователя,
под которым проводится закачка в SPOT 2D).
Для отправки POST запроса мы рекомендуем библиотеку http://curl.haxx.se/ которая
портирована во все языки программирования или которую можно вызывать из командной
строки.
Скачать программу: http://esta.spot2d.com/other/curl.php
Настроить выгрузку данных по расписанию можно таким образом:
- после выполнения автоматической задачи выгрузки файлов из 1С или другой программы
оттуда же запустить .BAT-файл с командами по выгрузке данных;
- настроить в Планировщике заданий (Windows) время запуска .BAT-файла с командами по
выгрузке данных.
9
3. Спецификация файлов и командной строки для дистрибьюторов SPOT 2D
Для корректной выгрузки файлов на SPOT 2D необходимо соблюдать описанную ниже
последовательность выгрузки файлов на сайт, придерживаться установленного формата файлов
и поддерживать на сайте SPOT 2D актуальную таблицу соответствия кодов продуктов
дистрибьютора и производителя (оператор сайта).
Формат файлов соответствует описанию в данной инструкции.
1.Файл клиентов
2.Файл остатков
! Ошибка может быть получена в случае:
- неверного формата файла;
- отсутствия кода (-ов) продукта (-ов) (SKU) в таблице соответствия на сайте SPOT 2D, в таком
случае их нужно проставить.
3. Файл торговых агентов
4. Файл отгрузок
Отгрузки нужно выгружать за последние 45 дней, минус один день от текущего.
! Ошибка может быть получена в случае:
- неверного формата файла;
- отсутствия кода (-ов) продукта (-ов) (SKU) в таблице соответствия на сайте SPOT 2D, в таком
случае их нужно проставить;
- отсутствия кода клиента или кода ТА в базе данных SPOT 2D (возможно новые клиенты не
попали в файл клиентов);
- проблем со статусами клиентов:
* отгрузка на закрытого клиента;
* отгрузка на клиента, сумма долей активных торговых точек которого не равна 100%.
Информацию по торговым точкам таких клиентов следует исправить вручную на сайте SPOT 2D
(см. инструкцию пользователя SPOT 2D).
Таким образом, .BAT-файл для выгрузки данных может выглядеть таким образом:
curl.exe -v –F "ufile=@c:\ПУТЬ\clients.csv;type=text/plain;filename=clients" -F "__login=ЛОГИН" -F
"__password=ПАРОЛЬ" -F "__did=?" http://esta.spot2d.com/dinfo/auto-upload.phtml
curl.exe -v -F «ufile=@c:\ПУТЬ\stocks.csv;type=text/plain;filename=stocks" -F "__ login=ЛОГИН" -F
"__password=ПАРОЛЬ" -F "__did=?" http://esta.spot2d.com/dinfo/auto-upload.phtml
curl.exe -v -F "ufile=@c:\ПУТЬ\ta.csv;type=text/plain;filename=ta" -F __ login=ЛОГИН" -F
"__password=ПАРОЛЬ" -F "__did=?" http://esta.spot2d.com/dinfo/auto-upload.phtml
curl.exe -v -F "ufile=@c:\ПУТЬ\delivery.csv;type=text/plain;filename=delivery" -F __ login=ЛОГИН" -F
"__password=ПАРОЛЬ" -F "__did=?" http://esta.spot2d.com/dinfo/auto-upload.phtml
curl.exe -v -F "ufile=@c:\ПУТЬ\delivery.csv;type=text/plain;filename=delivery" -F __ login=ЛОГИН" -F
"__password=ПАРОЛЬ" -F "__did=?" http://esta.spot2d.com/dinfo/auto-upload.phtml
Описание переменных:
ufile – путь к файлу с данными, например:
Файл с клиентами – C:\clients.csv
Файл с остатками – C:\stocks.csv
Файл с агентами – C:\ta.csv
Файл с отгрузками – C:\delivery.csv
Файл с продуктами– C:\products.csv
filename – тип данных в файле (обязательно один из трех установленных типов):
clients – таблица клиентов
stocks – таблица остатков
ta – таблица торговых агентов
delivery – таблица отгрузок
10
products – таблица продуктов
__login – логин пользователя в SPOT 2D (например user1).
__password – пароль пользователя в SPOT 2D (например pass1).
__did – код дистрибьютора в SPOT 2D (например 2)
11