Árcédula feed pro Shopify

Árcédula stahuje vaše produkty z URL feedu, kterou nastavíte v partnerském portálu v sekci Termékek → Feedek, a jeden obchod může registrovat i několik feedů, takže rozdělený katalog není problém. Specifikace říká, že se feedy čtou „čas od času“; konkrétní číslo podmínky uvádějí u viditelné části: ceny na webu se obnovují každou noc, se zpožděním, které nevylučují.

Dvě podmínky stojí mimo samotný feed. Registrace se posuzuje (o jejím přijetí rozhoduje Árcédula) a bez kladného předplaceného zůstatku se nic nezobrazuje: když kredit dojde, produkty zmizí. A soubor musí pořád odpovídat: nedostupný datový soubor je jedním ze čtyř důvodů pozastavení v podmínkách, vedle nepravdivých či klamavých údajů, malwaru a prázdného zůstatku. Feedflock soubor hostuje na stabilní URL a přegeneruje ho každou hodinu, takže drží čerstvost i dostupnost.

Celý slovník tvoří třináct polí a tabulka polí jich pět označuje jako Kötelező: identifier, manufacturer, name, url a price. Identifikátor je vaše vlastní jedinečné označení nabídky a nemusí být číselný; jejich příklady ukazují holé číslo, kód ve stylu SKU i UUID. Na rozdíl od některých sousedů Árcédula nechce, abyste ze názvu vynechávali značku; jejich vlastní příklad posílá „Apple iPhone 13 mini“ vedle výrobce „Apple“.

URL je místo, kam proklik vede, a vlastní tip Árcéduly zní přidat na ni sledovací parametr (?from=arcedula), abyste její prokliky poznali v analytice. Feedflock ve výchozím stavu odkazuje na konkrétní variantu přes ?variant= a zdrojový parametr přidáte ve stejné šabloně.

Cena je „hrubá cena produktu ve forintech“: holé celé číslo bez měny a element pro DPH nebo čistou cenu ve formátu neexistuje. Výčet dostupnosti má přesně tři hodnoty camelCase: inStock, orderable, outOfStock. Specifikace si tu jednou protiřečí: sloupec s příkladem v přehledové tabulce píše in_stock, ale tabulka stavů i všechny tři tabulky formátů říkají inStock, a to Feedflock posílá, odvozené ze skladu v Shopify.

Doprava jsou dvě čísla za nabídku, obě hrubá ve forintech: deliveryPrice, kde 0 výslovně znamená dopravu zdarma, a deliveryTimeInDays, počet pracovních dnů, ne slovní formulace. Protože odhadnutá hodnota je slib každému zákazníkovi, šablona obojí nechává prázdné, dokud nenastavíte sazbu, kterou skutečně účtujete.

Árcédula přijímá JSON, XML i CSV se stejnými třinácti názvy vlastností, každý s hotovým příkladem na své jednostránkové specifikaci. CSV specifikace nést vůbec neumí, a proto šablona posílá XML: holý kořen <products> s jedním <product> za nabídku, hodnoty escapované entitami místo CDATA, přesně jako vzor ve specifikaci.

Dvě dokumentované alternativy umožní použít to, co už provozujete. Feed ve formátu Árukereső se přijme pole po poli, s jedním háčkem: nemá pole skladu, takže Árcédula dostupnost odvozuje z doby dodání. Namapovaný je i produktový feed Googlu, ale hodnoty preorder a backorder nejsou kompatibilní a čtou se jako prázdné. Nativní feed zůstává jediný, který nese specifikace, třístavovou dostupnost a obě čísla dopravy.