Vivino feed pro Shopify

Vivino si data stahuje; obchodník je hostuje. Vytvoříte XML feed hostovaný online jako veřejně přístupný soubor, jeho URL zaregistrujete v účtu obchodníka a Vivino si ho stahuje automaticky, každých jednu až šest hodin. Jejich požadavek je, aby data byla vždy aktuální: ideálně každou hodinu, minimálně jednou denně.

Přesně tenhle model Feedflock poskytuje: hostovaný soubor na stabilní URL, přegenerovaný každou hodinu z vašeho katalogu Shopify. Měna feedem necestuje: nastavuje se v účtu na Vivinu a element ceny je prosté číslo. URL vložíte jednou a nic dalšího už nenahráváte.

Vína se na Vivinu identifikují podle názvu produktu a název musí jít přiřadit právě jednomu vínu. Předepsaný tvar je producent, název vína a apelace, ročník a barva vína, anglicky nebo francouzsky, a jen u vín, která nejsou červená. Všechno ostatní je výslovně zakázané: interpunkce a propagační texty, poznámky o dostupnosti, hodnocení recenzentů, balení, objem a počet lahví (ty mají vlastní pole), ocenění, cenové nabídky a zkratky. Víno, kterému některá část chybí, se nemusí objevit vůbec, a jedinou výjimkou z ročníku je NV pro neročníkové šumivé víno.

Stabilita je stejně důležitá jako přesnost: Vivino žádá, abyste názvy po zalistování neměnili, protože změněný název (třeba jen nový ročník) se zalistuje a odkryje jako nový produkt. A když databáze Vivina spáruje vaše víno se špatnou stránkou, opravuje se to zprávou podpoře s URL obou stránek vína na Vivinu, ne polem ve feedu. Feedflock název sestaví jednorázově z výrobce, titulku a metafieldů, takže vzorec drží při každém generování.

Cena ve feedu je celková částka účtovaná za příslušné množství: karton šesti lahví nese cenu kartonu, nikdy cenu za láhev. Mimo USA a Kanadu musí cena obsahovat daň a Vivino vyžaduje cenovou paritu s vaším vlastním webem. Množstevní slevy mají dvě podoby, mezi kterými vybírá quantity-is-minimum: pevný karton, kde bottle_quantity je velikost kartonu a cena jeho součet, nebo práh, kde bottle_quantity je minimum, od kterého Vivino cenu dopočítává.

Stav skladu se řídí stejnou logikou: inventory-count je počet jednotek této nabídky (lahví při množství 1, kartonů při množství 6), kromě prahové slevy, kde počítá jednotlivé lahve. Maximální hodnota je 9999. A žádná značka vyprodanosti neexistuje: nabídka, jejíž stav klesne pod 1, se musí z feedu odstranit, a proto Feedflock vyprodané varianty ve výchozím stavu vyřazuje.

Alkohol v tabulce Vivina sedí mezi nepovinnými doplňky, přesto má vlastní větu: je povinný na všech trzích, formátovaný jako procento se znakem % a desetinnou tečkou. Shopify pole pro ABV nemá, takže ho šablona mapuje z metafieldu, který vyplníte jednou.

U vín lahvovaných po 8. prosinci 2023 a prodávaných v EU jsou etiketové údaje povinné; jinde jsou nepovinné, ale doporučené. Splnit se dají dvěma způsoby: elementem elabel s URL stránky e-labelu vína, nebo samotnými hodnotami: energie v kJ na 100 ml, tuky, bílkoviny a sůl v gramech na 100 ml, zbytkový cukr v gramech na litr, seznam ingrediencí sestupně podle objemu, plus třináct příznaků alergenů od mléka po měkkýše. Příznaky berou hodnoty Yes/No, zatímco true/false používá jen quantity-is-minimum; šablona oba slovníky drží oddělené.