Инструкции по интеграции в интернет – гипермаркет Akson.ru для внешних поставщиков.
Обмен товарным каталогом.
Поставщик может загружать товары в интернет-гипермаркет akson.ru (далее ИГ) с помощью xml файлов выложенных либо на ftp поставщика, либо периодически выкладываемых на ftp ИГ, либо доступных по прямой ссылке с сайта поставщика.
Обмен полным товарным каталогом должен происходить 1 раз в сутки в ночное время. В течение дня, один раз в час должны присылаться только те товары по которым били изменения за последний час, например изменилось количество на складе, или цена, или изменилось описание товара.
Информация по товарам должна передаваться в формате xml и иметь следующую структуру:
Название товара
8744944
REPLICA
Китай
A25
Белый
1.2
2 length >
0.5
1.2
2
0.5
10
Описание
30000
5555
12
шт.
6
2
342534
Колесные диски
Ваш сервер/upload/photos/model/00793.jpg
Ваш сервер/upload/photos/model/00793.jpg
Описание xml:
*name - название товара адекватное для покупателя, должно содержать название товарной группы, например «Обои бумажные», бренд, например «Палитра», модель, например «Полевая Ромашка» и детали названия, например «симплекс 0,53*10,05м геометрия, голубой».
*code – код номенклатуры внешнего поставщика;
*brand – бренд;
*country - страна производитель;
model – модель;
color – цвет;
*width – ширина изделия в метрах;
*length – длина изделия в метрах;
*height - высота изделия в метрах;
*pack_width – ширина упаковки в метрах;
*pack_length – длина упаковки в метрах;
*pack_height - высота упаковки в метрах;
*description – описание товара, должно содержать:
• Описание внешнего вида, используемых материалов и подобное.
• Назначение товара (где используется, для чего применим)
• Характерные особенности
• Конкурентные преимущества
*weight – вес, в граммах;
*quantity – текущее количество на остатке;
*pack_area – площадь упаковки;
*count_in_pack – количество в упаковке;
*price – цена закупочная;
*base_unit – базовая единица измерения;
*group_id – ID товарной группы в базе поставщика;
*group_name – название товарной группы в базе поставщика;
*img - ссылка на основное фото товара. Требование к фотографиям: размер по меньшей стороне не менее 600px, разрешение не менее 72 ppi (пиксел/дюйм). Формат файла: jpg. Главное фото должно быть максимально резким. Товар должен полностью помещаться в кадр. Дополнительные фотографии 1 – 3 шт.(если это требуется) - заключить в теги img1, img2;
* - обязательные свойства.
Так же файл номенклатуры может содержать и другие свойства, необходимые для фильтрации товаров. Их названия и значения обговариваются отдельно для каждой товарной группы.
Для поставщиков с SKU больше 1000 товаров каждая товарная группа должна приходить в отдельном файле выгрузки.
Выгрузка по изменениям не должна содержать все свойства товара, а только те, которые были изменены за отчетный период (последний час). Код товара выгружается в любом случае.
Вся цепочка действий выглядит следующим образом:
-
Клиент оформляет заказ на сайте http://akson.ru с наименованиями поставщика
-
После оплаты заказа, со стороны ИГ Аксон генерируется XML-файл заказа с названием совпадающим с номером заказа. Пример файла:
122323
9116866
12 quantity>
250
9000894
12 quantity>
<price>100price>
В файле фиксируется цена, по которой ИГ Аксон отпускает данные наименования покупателю.
-
Поставщик мониторит директорию “new” исходящих файлов на предмет появления новых заказов постоянно. При появлении файла заказа, поставщик должен его обработать и переместить в директорию “arc” исходящих файлов, сгенерировав для ИГ Аксон при этом файл ответа на заказ в директории входящих файлов c именем исходного файла (номером заказа в ИГ Аксон). В файле ответа поставщик указывает номер заказа в своей системе в поле supporderid. В случае, если поставщик подтверждает наличие указанных в заказе наименований – он создает ответ на заказ со статусом “true”. Пример положительного ответа на заказ:
122323
123456
true
9116866
12 quantity>
250
9000894
12 quantity>
250
|
Также допустимо не перечислять наименования в заказе при положительном статусе. Пример:
122323
123456
true
|
|
|
В случае, если у поставщика изменилось наличие наименований и он не может выдать указанное кол-во – генерируется файл ответа на заказ со статусом “false” и указанием новых данных по наличию. Пример ответа на заказ с отрицательным статусом:
xml version="1.0" encoding="UTF-8"?>
122323
123456
false
9116866
9 quantity>
9000894
7 quantity>
После обработки входящего файла, он перемещается в директорию “arc”.
-
В качестве альтернативы ответу поставщика файлом по статусу наименований можно использовать веб-сервис (http://akson.ru/service_scripts/ext_order_response.php), которому поставщик POST-ом передает XML-строку с аналогичным содержимым. Строка помещается в параметр “order_data”. Также веб-сервису передается параметр “supplier” с согласованным идентификатором поставщика.
-
В случае отмены заказа со стороны ИГ Аксон, генерируется следующий файл статуса заказа:
373138
CANCEL
В этом случае поставщик после обработки отказа также перемещает файл в директорию “arc”.
Dostları ilə paylaş: |