[TEASER-GOODS-EXPORT-REQUIREMENTS_0]

Требования к файлу экспорта товаров

   

Формат и схема файла

   

       Выгрузка товаров осуществляется посредством файла формата XML.        
       Файл должен быть доступен по внешнему URL.    

   
       Пример XML файла доступного по внешнему URL:
      https://dashboard.marketgid.com/schemas/marketgid_teaser_goods_export_example.xml    
   

XML документ должен соответствовать схеме формата XSD указаной ниже:    

   
 <!ELEMENT marketgid_teaser_goods_export (categories, teasers)>
    <!ATTLIST marketgid_teaser_goods_export date CDATA #REQUIRED>

    <!ELEMENT categories (category+)>
        <!ELEMENT category (#PCDATA)>
            <!ATTLIST category id CDATA #REQUIRED parentId CDATA #IMPLIED>

    <!ELEMENT teasers (teaser+)>

        <!ELEMENT teaser (categoryId, url, picture, title, text, price?)>
            <!ATTLIST teaser id CDATA #REQUIRED active (true | false | 0 |1) "true">

            <!ELEMENT categoryId (#PCDATA)>
            <!ELEMENT url (#PCDATA)>
            <!ELEMENT picture (#PCDATA)>
            <!ELEMENT title (#PCDATA)>
            <!ELEMENT text (#PCDATA)>

            <!ELEMENT price (#PCDATA)>
                <!ATTLIST price currency (RUB | UAH | USD | KZT | EUR | ILS) "USD">
 
   

Заголовок документа (XML header)

   
    
    
   

Стандартный XML-заголовок с обязательным указанием кодировки UTF-8 и тегом standalone=”no” который указывает что схема хранится в отдельном файле.    
   Файл соответственно должен быть в кодировке UTF-8.

   

Элемент marketgid_teaser_goods_export

   
    
        
            ...
        
        
            ...
        
    
    
   

Документ в качестве корневого тега должен использовать элемент marketgid_teaser_goods_export с атрибутом date,
   который должен соответствовать дате и времени генерации XML-файла в формате YYYY-MM-DD HH:mm.

   

Элемент categories


    Одежда
    Товары для отдыха
    Брюки

В этом блоке должен присутствовать минимум один тег category (см. XSD схему)    Тег category должен иметь атрибут id с целым числом в качестве ключа.    Для указания вложенных категорий можно использовать атрибут parentId. Значением атрибута parentId обязательно    должна быть одна из перечисленных категорий.

   

Элемент teasers

   
    
        
            12
            http://shopsiteexample.com/product-AE-124563.html
            http://shopsiteexample.com/picture-AE-124563/main.jpg
            Джинсы мужские Levis
            Джинсы мужские Levis, по самой низкой цене! Только 5 дней!
            259
        
    
    
   

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

   

Описание элементов и атрибутов, входящих в teaser

   

Порядок элементов в теге teaser необходимо соблюдать так как приведено в таблице!!!

                                                                                                                                                                                                                                                                                                                                                                                                                       
Элемент или атрибутОписание
idАтрибут тега teaser - обязательный. Уникальный идентификатор товара, который размещен в коде датчика на странице товара. Допустимые значения [0-9, A-Z, a-z, -, _]            
activeАтрибут тега teaser - НЕ обязательный. Значение по умолчанию = false Статус товара. Допустимые значения [0, 1, true, false]. При значении false тизеры не создаются.            
categoryIdТег - обязательный. Уникальный идентификатор категории товара. Так же можно указать идентификатор категории, используемый в системе Маркетгид.            
urlТег- обязательный. Ссылка на страницу товара.
pictureТег- обязательный. Ссылка на изображение товара. Само изображение должно быть не меньше чем 492x328. В идеале оно должно соответствовать этому размеру. Допустымые расширения: *.jpg, *.jpeg            
titleТег- обязательный. Заголовок тизера. В идеале не должен превышать 65 символов, иначе будет обрезан до 65 средствами системы (до окончания последнего слова, не превышающего 65 символов). Допустимы те же символы, что и в создании тизера.            
textТег- обязательный. Рекламный текст (короткое описание). В идеале не должен превышать  75 символов, иначе будет обрезан до 75 средствами системы (до окончания последнего слова, не превышающего  75 символов). Допустимы те же символы, что и в создании тизера            
priceТег- НЕ обязательный. Цена товара в указанной валюте. Допустимые значения - [0-9]
currencyАтрибут тега price - Не обязательный(Если указан price- обязательный). Идентификатор валюты, в который указана цена товара. Значение по умолчанию = USD. Должен принимать значение из списка:                
                       
  • AED
  • BYN
  • EUR
  • GEL
  • ILS
  • INR
  • KZT
  • RUB
  • UAH
  • USD
  •                
           
   

Условия замены

   

Стандарт XML требует обязательной замены некоторых символов на эквивалентные им символьные примитивы. Список таких замен указан в таблице, приведенной ниже.

                                       
СимволЗамена(символьный примитив)
" &quot;
& &amp;
> &gt;
< &lt;
' &apos;
© &copy;
¢ &cent;
® &reg;