Ceneje.si feed pro Shopify

Ceneje čte jeden XML soubor z URL, kterou hostujete a pošlete jim e-mailem; rozhraní pro nahrání ani API neexistuje. Nic se nenaimportuje, dokud feed editor nepotvrdí; adresa u patičky specifikace, urednik@ceneje.si, je místo pro dotazy. Pak se rytmus dělí na dva: nové a vyřazené produkty se přenášejí jednou za noc mezi půlnocí a čtvrtou ranní, zatímco cenu a sklad čte několikrát denně, zhruba každé dvě hodiny.

Strop položek, limit velikosti souboru ani pravidlo pro kompresi se nikde neuvádí a nic se nevymáhá, živé feedy obchodů přesahují 70 MB. Deklarované kódování musí odpovídat skutečnému; Feedflock posílá a deklaruje UTF-8, soubor hostuje na stabilní URL a regeneruje ho každou hodinu, takže oba rytmy Ceneje čtou vždy aktuální data.

Nejdůležitější věta specifikace se snadno přehlédne: většina hodnot se do databáze Ceneje přenese jen jednou a jejich pozdější změny přinášejí dodatečné náklady. Seznam znovu čtených hodnot pokrývá price, regularPrice, clubPrice, stock, stockText, link, elementy dopravy, condition, warranty, coupon a gift. Název, popis, hlavní obrázek, cesta kategorie, značka ani EAN na něm nejsou. Špatný název produktu je tiket u podpory, ne přegenerování feedu.

Název si proto zaslouží péči, kterou specifikace žádá: značka + typ produktu + model, jako v jejich příkladu „SAMSUNG hladilnik z zamrzovalnikom RB37J5018SA“. Žádné propagační fráze typu doprava zdarma nebo dárek, žádné verzálky, u bazaru jasně uvedený stav, a u oblečení a obuvi velikost v názvu být nesmí. Popisy jsou HTML bez formátování v CDATA a element specifications je to, z čeho Ceneje staví filtry, podle kterých kupující výsledky zužují.

Ceneje přiřazuje vaši nabídku ke kartě produktu podle EAN, productCode a productModel, jak doslova píše závěrečný seznam častých problémů ve specifikaci. EAN má přesně 13 číslic, platných podle GS1, s vyloučenými prefixy pro omezené kódy a kupóny; čtrnáctimístný GTIN nebo hodnota s úvodní nulou neprojde, úplně stejně jako na Heurece. Šablona plní EAN z čárového kódu Shopify a productCode ze SKU.

Existují dvě zkratky. CUIN, vlastní kód Ceneje uvedený na každé stránce produktu, spáruje vaši položku s existujícím katalogem do 48 hodin, a cenCategoryId (číselné id z archivu kategorií Ceneje) ji stejně rychle zařadí do správné kategorie. Samotné ID je trvalé: nikdy se nemění, nikdy se nepoužije znovu a přežije i migraci na jinou platformu, protože zdvojené ID shodí všechny nabídky, které ho sdílejí.

Varianty jsou ploché: jeden Item za variantu, svázané přes groupId, a groupId je vyhrazený produktům, které se liší čtyřmi předdefinovanými atributy color, size, gender a ageGroup, posílanými uvnitř bloku attributes. U oblečení a obuvi jsou všechny čtyři povinné; každý další atribut odchází jako opakovatelný blok attribute se jménem a hodnotami.

fileUnder nese vlastní cestu kategorie vašeho e-shopu, přesně jednu na položku. Ceneje z ní zařazuje, takže na mapování záleží. Dostupnost je výčet tří hodnot s významem doby expedice: in stock odesílá do jednoho dne, preorder za 2–10 pracovních dnů, out of stock nemá známé datum, a na rozdíl od Heureky smí vyprodaná položka ve feedu zůstat. Doprava je jedna částka na položku, 0 pro dopravu zdarma, a deliveryTimeMin/Max v pracovních dnech je povinný, kdykoli je položka skladem nebo na preorder.