Varle.lt feed pro Shopify

Varle čte jeden XML soubor z veřejné URL; jeho vlastní závěrečný checklist začíná větou „ověřte, že poskytnutá XML URL funguje“. Žádné nahrávání, SFTP ani produktové API neexistuje; hostovaná URL je celý transport.

Importní rytmus je zveřejněný, což není samozřejmost: systém VARLE aktualizuje kompletní produktová data týdně a stavy skladu s cenami denně. Importy neběží v reálném čase, když soubor změníte, a o zásadních změnách chce Varle vědět předem. Feedflock soubor hostuje na stabilní URL a generuje ho každou hodinu, takže každý naplánovaný import čte aktuální verzi.

Varle nabízí dvě XML struktury a doporučuje tu bez stromu kategorií, přesně tu, kterou šablona používá. Obálka je <root> obalující <products> obalující <product> a každý produkt uvádí kategorii přímo: koncový NÁZEV ze stromu Varle, protože ten zveřejňuje názvy a celé cesty, ale žádná ID. Varle doporučuje uvádět jen koncovou kategorii produktu.

Povinných je deset značek: id, categories, title, description, price, delivery_text, images, quantity, barcode_format a barcode. Volné produktové atributy jdou do stejného bloku <attributes> jako příznaky dopravy a plní dvě role: jako tabulka v popisu produktu zároveň vytvářejí a plní filtry kategorií, takže produkt bez atributů je pro filtrujícího zákazníka neviditelný.

Variantní mechanismus Varle je nejdražší past celé specifikace: cena ve značce <variant> je ROZDÍL oproti základní ceně produktu. V ukázce samotného Varle vychází skříň za 150/200/250 € jako 0, 50 a 100. Žádný běžný katalog Shopify tyto rozdíly nedrží, a proto šablona vykreslí jeden <product> za každou variantu, vždy s její skutečnou cenou.

Řada se prováže přes <group>, což je zdokumentovaná alternativa samotného Varle: „importujete-li několik stejných produktů (košile) v různých barvách, uveďte u všech stejnou skupinu.“ Rozlišující parametr patří do názvu, což za vás dělá výchozí tvar názvu šablony, tedy název produktu doplněný o variantu.

Cena je finální cena pro zákazníka včetně DPH, bez symbolu měny, a dokumentace Varle jmenuje i oddělovač: tečku, ne čárku. Množství je celé číslo a 0 je způsob, jak produkt skrýt: „po nastavení množství na 0 se produkt stane neviditelným a nebude se na webu prodávat.“ Vyprodaná varianta proto zůstává ve feedu s 0, místo aby vypadla.

Přeškrtnutá cena, <price_old>, je vázaná na Omnibus směrnici: litevské zákony a pravidla varle.lt dovolují akční cenu, pokud se cena produktu alespoň 30 dnů nezměnila (nové produkty a noví prodejci mají 30denní lhůtu). Compare-at cena ze Shopify je na většině obchodů spíš doporučená cena, a proto šablona ve výchozím stavu nenamapuje nic. Odeslat ji sem je právní tvrzení, ne přenos pole.

Varle zboží prodává a přepravu zajišťuje, takže feed žádnou cenu dopravy neobsahuje. Jediné, co můžete ve feedu o dopravě říct, je doba dodání (delivery_text, povinný element ve formátu Varle, například „1-2 d.d.“, v pracovních dnech) a možnost zakázat balíkomaty u zboží, které se do nich nevejde.

Slovník zákazů tvoří šest příznaků (jeden plošný a pět za jednotlivé dopravce: Venipak, Itella, Omniva, LPexpress, DPD) a jsou to atributy, ne elementy. Mají tři stavy: prázdné i „true“ znamenají dostupné, zakáže pouze „false“. „Atributy přijímají jen určité hodnoty, jinak import selže,“ a proto šablona nenamapovaný příznak raději vynechá. Zbytek obstará hmotnost: globální pravidla Varle zakazují balíkomaty u zboží nad jejich hmotnostním limitem automaticky, ale jen když je značka weight vyplněná.