Пример реализации файла прайс-листа в формате XML

Пример XML

Ссылка: https://help.market.forte.kz/example.xml

Содержимое файла:

<?xml version="1.0" encoding="UTF-8"?>
<fm_catalog date="2017-02-05 17:22">
   <shop>
      <merchant-id>MerchantID</merchant-id>
      <offers>
         <offer sku="12341">
            <name>Мороженица Brand 3811</name>
            <vendor>Brand</vendor>
            <barcodes>
               <barcode>0123456789379</barcode>
            </barcodes>
            <pickup-options>
               <pickup-option id="PP-1" />
               <pickup-option id="PP-2" />
               <pickup-option id="PP-3" />
            </pickup-options>
            <delivery-options>
               <delivery-option city-id="000001" cost="1000" days="6" />
            </delivery-options>
            <price>8990</price>
         </offer>
      </offers>
   </shop>
</fm_catalog>

Внимание! Выгрузка должна быть размещена по ссылке доступной для прямого скачивания.

Требования к элементам

Элемент

Описание

Обязательность элемента

merchant-id

ID партнера, которое присваивается ему при регистрации на площадке ForteMarket

Да

offers

Список предложений партнера. Каждое предложение описывается в отдельном элементе offer.

Да

Описание входящих элементов предложений партнера

 

offer

Элемент описывающий предложение партнера и объединяющий элементы с детальной информацией.

Имеет дополнительный параметр:

Параметр

Обязательность параметра

Описание

sku

Да

Артикул/Код товара в учетной системе поставщика. Должен иметь уникальное значение. По данному параметру происходит связка Товара поставщика и Товара в Единой базе товаров ForteMarket.

Да

name

Полное название предложения, в которое входит: тип товара, производитель, название товара.

Составляйте по схеме: что (тип товара) + кто (производитель) + товар(модель, название).

Да

vendor

Название производителя.

Да

barcodes

Список штрихкодов товара от производителя.

Каждая штрихкод описывается в отдельном элементе barcode.

Нет

barcode

Штрихкод товара от производителя в одном из следующих форматов: EAN-13, EAN-8, UPC-A, UPC-E.

В элементе offer может содержаться несколько элементов barcode.

Да

pickup-options

Список точек самовывоза партнера в которых доступно данное предложение.

Каждая точка самовывоза описывается в отдельном элементе pickup-option.

Да

pickup-option

Элемент передающий доступность предложения в той или иной точке самовывоза партнера.

Имеет дополнительный параметр:

Параметр

Обязательность параметра

Описание

id

Да

ID Точки самовывоза, которая была указана в настройках в Кабинете продавца

Да

delivery-options

Список городов и условий доставки.

Условия доставки в каждый город описывается в отдельном элементе delivery-option.

Нет

delivery-option

Элемент передающий условия доставки до определенного города в котором есть точки самовывоза партнера.

Имеет дополнительный параметр:

Параметр

Обязательность параметра

Описание

city-id

Да

ID города в который будет доставляться товар

cost

Да

Стоимость доставки товара до города. Если доставка бесплатная, то значение должно быть равно “0”

days

Да

Срок доставки. Указывается количество календарных дней, которое необходимо партнеру для доставки товара в указанный город. Не должно быть меньше 1 и больше 21.

city-id доступных городов:

Да

price

Актуальная цена товара, которая используется для всех городов. Если необходимо установить для определенного города отличную от данной цену, но используйте элемент city-prices

  • Значение цены не должно сожержать пробелов (разделителей)
  • Значение цены не должно содержать десятичных знаков
  • Значение цены не должно содержать посторонних символов (например знак тнг.)

Да

 

 

Коды городов

ГородCity-id
ТаразKZ-ZHA-311010000
ТуркестанKZ-TUR-611010000
АтырауKZ-ATY-231010000
Усть-КаменогорскKZ-VOS-631010000
ПетропавловскKZ-SEV-591010000
СемейKZ-VOS-632810000
АктауKZ-MAN-471010000
КостанайKZ-KUS-391010000
КызылордаKZ-KZY-431010000
АлматыKZ-ALA
ШымкентKZ-SHY
АктобеKZ-AKT-151010000
УральскKZ-ZAP-271010000
КокшетауKZ-AKM-111010000
КарагандаKZ-KAR-351010000
АстанаKZ-AST
ТалдыкорганKZ-ALM-191010000
ПавлодарKZ-PAV-551010000
ЭкибастузKZ-PAV-552210000