Система «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