FAVI help page

Изисквания за XML фийд

Значение и изисквания за индивидуалните елементи

Значения и изисквания към отделните елементи

Задължителни елементи:

Препоръчителни елементи:

Идентификационен номер (ID)*

ID е уникално означение за всеки продукт в системата на електронния магазин. Означението не може да се променя по време на периода на сътрудничество, в противен случай историята и позицията на продукта могат да бъдат загубени.

В случай, че няколко продукта имат един и същ ITEM_ID, XML фийдът ще се счита за неправилен и актуализацията няма да работи.

Елементът може да съдържа цифри, малки и главни букви, но без диакритични знаци и специални знаци като тирета и долни черти.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI:

XML фийд спецификация	Елемент
Heureka/Zboží	<ITEM_ID>abc987</ITEM_ID>
Google	<g:id>abc987</g:id>
Compari/Árukereső/Pazaruvaj	<Identifier>abc987</Identifier>
Ceneo	id=“abc987

Означение на вариантите

Означаване на групови продуктови варианти. Продукти, които представляват различен вариант на един и същи продукт, имат уникален ITEM_ID, но един и същ ITEMGROUP_ID.

Препоръчително за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI:

XML фийд спецификация	Елемент
Heureka/Zboží	<ITEMGROUP_ID>ZD563</ITEMGROUP_ID>
Google	<g:item_group_id>ZD563</g:item_group_id>
Compari/Árukereső/Pazaruvaj	<GroupId>ZD563</GroupId>
Ceneo	не е посочено в спецификацията на Ceneo

Име на продукта*

Точно име на продукта. За коректно включване в каталога името на продукта трябва да е достатъчно описателно. Не е подходящо да се използва за име на продукт само една дума, напр. името на колекция или издание.

Продуктите са категоризирани в нашия каталог главно въз основа на името на продукта, т.е. в идеалния случай името на продукта трябва да съдържа основната характеристика на продукта, особено предназначението, като например: детско спално бельо (така че не е подходящо да се използва само спално бельо, ако е детско спално бельо.), градински столове, трапезни столове и др.
Името на продукта може да съдържа името на производителя или марката, но не и името на магазина или URL адреса на магазина. Заглавието също не трябва да съдържа информация като наличност, разпродажба, промоции, безплатна доставка и др.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<PRODUCTNAME>MERIDA double bed, 160×200 cm</PRODUCTNAME>
Google	<title>MERIDA double bed, 160×200 cm</title>
Compari/Árukereső/Pazaruvaj	<Name>MERIDA double bed, 160×200 cm</Name>
Ceneo	<name>MERIDA double bed, 160×200 cm</name>

Описание на продукта*

Описание на продукта. Описанието трябва да включва информация за конкретния вариант на продукта. Приветстваме използването на подходящи ключови думи, които ще спомагнат за групирането на вашите продукти чрез филтри. Описанието на продукта трябва да е изчерпателно и да включва информация, която мотивира клиентите да направят покупка.

По-добре е да създадете неформатирано описание на продукта, тъй като вашият код ще бъде запазен в каталога на FAVI. Не е позволено да включвате URL адреси към друга страница от вашия магазин, имейл адреси и обща информация за контакт.

На страницата с подробности за продукта в каталога на FAVI можете да проверите как трябва да изглежда описанието на даден продукт. В общия случай системата на FAVI позволява само следните html кодове:

,
,
,
,
,
,
<ul> </ul>,
<li> </li>,
<ol> </ol>.

Други кодове и формати не се поддържат. Използването им може да компрометира текста и да влоши качеството му. Внимавайте и когато влагате специален знак, ако е необходимо. Например символът амперсанд (&) трябва да бъде кодиран с ASCII низ <li&gt ако не използвате CDATA за изпращане на информация.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<DESCRIPTION>Modern bed is made from …</DESCRIPTION>
Google	<g:description>Modern bed is made from …</g:description>
Compari/Árukereső/Pazaruvaj	<Description>Modern bed is made from…</Description>
Ceneo	<desc><![CDATA[Modern bed is made from …]]></desc>

Продуктова категория*

Продуктова категория. Категорията определя класификацията на продукта в каталога и трябва да бъде означена възможно най-точно. Разрешено е да изпращате категории съгласно структурата на категориите на FAVI, a можете също да посочите свои собствени категории, ако са достатъчно детайлни. Най-добре е винаги да категоризирате целия продуктов път – например Спалня>Легла.

Изчерпателната структура за всички страни е достъпна тук:

FAVI.bg – https://favi.bg/partner-dashboard/category-list
FAVI.cz – https://favi.cz/strom-kategorii
FAVI.sk – https://favi.sk/strom-kategorii
FAVI.pl – https://favi.pl/drzewko-kategorii
FAVI.ro – https://favi.ro/ramificaie-de-categorii
FAVI.hu –https://favi.hu/kategoriak-strukturaja
FAVI.hr – https://favi.hr/kategorizacija
FAVI.it – https://favi.it/elenco-categorie
FAVI.se – https://favi.se/kategori-lista
FAVI.co.uk – https://favi.co.uk/category-list

Каталогът на FAVI автоматично ще зареди всички продукти, които са изброени в XML фийда, само при условие че е включена подходяща категория, валидна връзка и изображение с подходящ размер.

За всеки продукт елементът на категорията трябва да се споменава само веднъж в XML фийда. Ако продуктът няма категория, той няма да се зареди в каталога.

Следните категории също ще бъдат отхвърлени за импортиране:

категории, неприложими към каталога
много общи категории (като отстъпки, разпродажби, промоции, имена на стаи и т.н.)
категории, които не са на съответния език.

Категориите не трябва да се променят често. Промяната на категориите ще премахне продуктите от каталога, докато новоизпратените категории не бъдат повторно одобрени.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<CATEGORYTEXT>Bedrooms > Beds</CATEGORYTEXT>
Google	<g:google_product_category>Bedrooms> Beds</g:google_product_category> <g:product_type>Bedrooms > Beds > single</g:product_type>
Compari/Árukereső/Pazaruvaj	<Category>Bedrooms > Beds</Category>
Ceneo	<cat> <![CDATA[Bedrooms > Beds]]> </cat>

Цена на продукта (с ДДС)*

Обща цена на продукта с ДДС (данък добавена стойност). Системата на FAVI приема цени само в следните формати:

8 000
8000
8000,70
8000,70

Моля, не използвайте точка за разделяне на хиляди и милиони. Точката може да се използва само като десетичен разделител. Системата на FAVI автоматично закръгля числото до втория знак след десетичната запетая.

Отстъпките за продуктите в каталога на FAVI се генерират автоматично от системата въз основа на съхранената история на основните цени. Ако цената в XML фийда е намалена, цената на продукта във FAVI също ще бъде намалена и сумата на отстъпката ще бъде изчислена. Поради това не получаваме информация за отстъпки от специален запис в XML фийда.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<PRICE_VAT>4500</PRICE_VAT>
Google	<g:price>5500</g:price> for product in sale: <g:sale_price>4500</g:sale_price>
Compari/Árukereső/Pazaruvaj	<Price>4500</Price>
Ceneo	price=“4500″

URL*

URL адресът посочва връзка към продуктовия уебсайт на вашия електронен магазин. Целевата (лендинг) страница на продукта трябва да включва цената на продукта, конкретна информация за продукта и бутон за покупка или поръчка на продукта. URL адресът трябва да е уникален в XML фийда, в противен случай продуктите с един и същи линк ще бъдат обединени.

URL адресът трябва да е валиден, не са позволени интервали или диакритични знаци и трябва да се използват специални символи в специфичен HTML формат, в противен случай продуктите няма да бъдат качени в каталога.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<URL>https://www.url.com/bed-merida.html#/90x200_cm</URL>
Google	<link>https://www.url.com/bed-merida.html#/90x200_cm</link>
Compari/Árukereső/Pazaruvaj	<Product_url>https://www.url.com/bed-merida.html#/90x200_cm</Product_url>
Ceneo	url=“https://www.url.cz/merida.html#/90x200_cm″

Заглавна снимка *

Основното изображение на продукта, като един от най-важните аспекти на XML фийда, трябва да отговаря на следните критерии:

1) Продуктът в основната снимка не трябва да противоречи на спецификацията си – т.е. на името или описанието си. Това се отнася по-специално за случаите, когато изображението на продукта по отношение на неговата спецификация е:

в различен декор или цвят (стол в цвят бук не трябва да е представен на снимката от стол в цвят орех ),
в различен размер (стикер с размери 25 х 25 см не трябва да се показва на снимката върху цялата стена и т.н.)
показват се с повече продукти, отколкото са налични за цената на конкретния продукт (напр. изобразена е цяла конфигурация от мебели за спалня, когато дадената цена включва само гардероб; или показване на цял сет, включващ маса със столове, когато дадената цена включва само маса; или показване на продукт в различен цвят). Изображението трябва да показва само точния брой артикули в сета (напр. сет от два стола не трябва да включва повече от два стола в изображението). Възможно е използването на число за обозначаване на броя идентични продукти в един сет (напр. разрешено е да се показва изображение с един стол с числото „2“ в ъгъла, за да се покаже, че комплектът съдържа два стола). Въпреки това, цифрите не трябва да покриват продукта или да отвличат вниманието по друг начин: поради тази причина е най-добре да поставите номера в ъгъла на снимката).

2) Продуктът в основното изображение трябва да бъде представен от истинска снимка: не е разрешено използването на скица или илюстрация.

3) Моля, изпращайте изображения във файлов формат PNG или JPEG.

4) Основното изображение трябва да е поне 600 x 600 px. Въпреки това се препоръчва да изпратите възможно най-големия размер, в идеалния случай над 1000 x 1000 px.

5) Продуктът на основното изображение трябва да бъде показан в неговата цялост, а не само определена част или детайл.

6) Разрешено е излагането на продукта на бял фон. Ако продуктът е изобразен като част от интериора, продуктът трябва да е достатъчно акцентиран на снимката, така че клиентът да разбере от пръв поглед за кой продукт става въпрос.

7) Основното изображение не трябва да съдържа допълнителен текст или други графични модификации (икони, водни знаци, лога, маркировки 1 + 1, отстъпки и др.).

8) Когато показвате цветови варианти, основното изображение не трябва да бъде просто цветен квадрат. Всяко изображение на цветови вариант трябва да показва действителния продукт.

9) Не е разрешено вграждането на изображението в рамка.

Ако дадено изображение не отговаря на горните критерии, то може да бъде блокирано за показване. Всички налични допълнителни снимки (чертежи, детайли, интериорни и композиционни снимки) трябва да бъдат изпратени като алтернативни снимки, които ще бъдат показани директно на страницата с подробности за продукта в каталога на FAVI.

Ако продуктът е блокиран и не се показва в резултат на несъответствие с някой от горните критерии и на по-късен етап системата открие промяна на изображението, изображението ще бъде прегледано отново и продуктът може да бъде върнат в каталога. Въпреки това, за да промените изображението, трябва също да промените URL адреса в XML фийда. Ново изображение ще бъде заредено само, ако системата открие промяна на URL адреса. Ако не се направи промяна, оригиналното изображение се запазва.

URL адресът за основното (и алтернативните) изображение на продукта трябва да отговаря на следните условия:

URL адресът на изображението не трябва да съдържа интервали. Интервалът трябва да бъде заменен ръчно със знака „%20“: нашата система не го замества автоматично.
URL адресът на изображението не трябва да съдържа ударения или диакритични знаци.
URL адресът на изображение не трябва да бъде блокиран. Ако системата на FAVI не може да изтегли изображението поради блокиране на URL от сървъра, продуктът няма да бъде зареден в каталога.
URL адресът на изображението трябва да бъде защитен с https сертификат.

Трябва да се има предвид, че ако изображението е актуализирано за заредения продукт и новият му URL е недостъпен (блокиран, с интервали или ударения), продуктът ще бъде деактивиран в каталога.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<IMGURL>https://www.url.com/bed-merida.jpg</IMGURL>
Google	<g:image_link>https://www.url.com/bed-merida.jpg</g:image_link>
Compari/Árukereső/Pazaruvaj	<Image_url>https://www.url.com/bed-merida.jpg</Image_url>
Ceneo	<imgs><main url=“https://www.url.com/bed-merida.jpg“/></imgs>

Алтернативни снимки

URL адресът за изображения на алтернативни продукти. Алтернативните изображения се показват на страницата с подробности за продукта. Максималният брой на изображенията е 20.

Всички алтернативни URL адреси на изображения трябва да бъдат защитени с https сертификати.

При допълнителните изображения е подходящо да се предостави:

снимки на продукта в стая
снимки на продукта заедно с други продукти (напр. от същата колекция),
продукта от различни ъгли,
по-подробни изображения на отделни части от продукта,
скици, показващи размерите и др.

Препоръчително за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<IMGURL_ALTERNATIVE>https://www.url.com/bed-merida2.jpg</IMGURL_ALTERNATIVE>
Google	<g:additional_image_link>https://www.url.com/bed-merida2.jpg</g:additional_image_link>
Compari/Árukereső/Pazaruvaj	<Image_url_2>https://www.url.com/bed-merida2.jpg</Image_url_2>
Ceneo	<imgs><i url=“https://www.url.com/bed-merida2.jpg“/></imgs>

Параметри

Продуктови параметри. Информацията, предоставена под формата на параметри, е показана в таблицата на страницата с детайли за продукта. Ако изпратите повече детайли за вашите продукти, кампанията Ви вероятно ще бъде по-успешна. По-специално, моля, представете характеристиките на продукта, които не се виждат очевидно от снимката.

Силно препоръчителните параметри са:

материал,
форма,
модел,
текстура,
цвят,
декор,
стил,

размери,
други специфични за продукта характеристики, които може да са важни.

Можете да намерите повече за параметрите и тяхната спецификация тук. Препоръчителните размери за всяка категория могат да бъдат намерени в списъка с категории тук.

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

Посочването на параметри е силно препоръчително.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<PARAM> <PARAM_NAME>Height</PARAM_NAME> <VAL>95 cm</VAL> </PARAM>
Google	<g:color>brown</g:color> <g:material>solid wood, beech</g:material> <g:pattern>striped</g:pattern> <g:product_detail> <g:section_name>Size</g:section_name> <g:attribute_name>Height</g:attribute_name> <g:attribute_value>95 cm</g:attribute_value> </g:product_detail>
Compari/Árukereső/Pazaruvaj	<Attributes> <Attribute> <Attribute_name>Height</Attribute_name> <Attribute_value>95 cm</Attribute_value> </Attribute> </Attributes>
Ceneo	<attrs> <a name=“Height“> <95 cm> </a> </attrs>

Наличност*

Време за изпращане на продукта (измерено в дни) от получаване на плащането (в случай на авансово плащане) или от получаване на поръчката (в случай на плащане при доставка).

Продукти на склад в каталога са маркирани продукти, които съдържат следните елементи:

DELIVERY_DATE елемент 0, 1, 2 или 3 (Heureka/Zboží)
Delivery_Time елемент 0, 1, 2 или 3 (Compari/Árukereső)
елемент „в наличност“ или "в_наличност" (Google)
елемент на наличност 0, 1, 2 или 3 (Ceneo)

Стойности, различни от тези, ще се отразят на подреждането на продукта, така че е препоръчително да посочите дата на доставка. Необходимо е също така посочената стойност за срок на доставка да съответства на срока за доставка, който е посочен във вашия онлайн магазин, както се вижда след кликване на линка от FAVI.

Изисква се за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<DELIVERY_DATE>0</DELIVERY_DATE> **
Google	<g:availability>in stock</g:availability> or <g:availability>in_ stock</g:availability>
Compari/Árukereső/Pazaruvaj	<Delivery_Time>0</Delivery_Time> **
Ceneo	avail=“1″ **

В елементите DELIVERY_DATE, Delivery_Time наличността попълва едно число, а не диапазон от стойности.

Опции за доставка

Уточняване на опциите за доставка на продуктите към клиента.

Може да има повече от един метод за доставка за един продукт и е препоръчително да включите цената за доставка. Това ще увеличи общата оценка на продукта.

В оценката за качество на продукта вземаме предвид само доставката до дома, а не доставката до офис на куриер.

Етикетът за безплатна доставка ще се появи на продукта, ако една от валидните опции за доставка е посочена с цена 0.

Препоръчително за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<DELIVERY> <DELIVERY_ID>PPL</DELIVERY_ID> <DELIVERY_PRICE>0</DELIVERY_PRICE> <DELIVERY_PRICE_COD>20</DELIVERY_PRICE_COD> </DELIVERY>
Google	<g:shipping> <g:price>0 CZK</g:price> </g:shipping>
Compari/Árukereső/Pazaruvaj	<Delivery_Cost>FREE</Delivery_Cost> или следното обозначение: gratuit, gratis, fara cost; ingyenes, ingyen, ingyenesen; безплатно, безплатен, безплатна.
Ceneo	not specified

GTIN (EAN)

Глобалният номер на търговски артикул (GTIN) е уникален номер, придаден на всеки конкретен продукт. Ако Вашите продукти нямат GTIN номер, той може да бъде получен на уебсайтовете на системата GS1.

Никога не включвайте вътрешни цифрови продуктови идентификатори в GTIN, разрешени са само официалните продуктови кодове.

GTIN се признава за валиден в нашата система, ако отговаря на следните критерии:

1. Състои се само от 8, 12, 13 или 14 цифри.
2. Трябва да премине официалното изчисление на контролната сума (напр. https://www.gs1.org/services/how-calculate-check-digit-manually)
3. Не може да съдържа префикси за стойности на купон (за повече информация: Процедура за решение: Неподдържана стойност на купон: GTIN [gtin])

Включването на този елемент е силно препоръчително.

XML feed specification	Element
Heureka/Zboží	<EAN>6417182041488</EAN>
Google	<g:gtin>6417182041488</g:gtin>
Compari/Árukereső/Pazaruvaj	<EAN_code>6417182041488</EAN_code>

Производител

Посочва производителя на продукта

Препоръчително за всеки продукт.

Примерите зависят от това кой XML фийд използвате във FAVI

XML фийд спецификация	Елемент
Heureka/Zboží	<MANUFACTURER>Joinery XYZ</MANUFACTURER>
Google	<g:brand>Joinery XYZ</g:brand>
Compari/Árukereső/Pazaruvaj	<Manufacturer>Joinery XYZ</Manufacturer>
Ceneo	<attrs> <a name=“Manufacturer“> <![CDATA[Joinery XYZ]]> </a> </attrs>

* показва задължителен елемент