Jeftinije.hr feed pro Shopify

Jeftinije č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 sdílená všemi čtyřmi portály skupiny. 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á: jeden chorvatský obchod s kosmetikou publikuje jeftinije.xml o 49 MB a vedle něj ceneje.xml o 46 MB, oba denně regenerované. 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 Jeftinije č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 Jeftinije 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 hladnjak RB37J5018SA“. Žádné propagační fráze typu besplatna dostava nebo poklon, žá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 Jeftinije staví filtry, podle kterých kupující výsledky zužují.

Jeftinije 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ů specifikace. 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 skupiny uvedený na každé stránce produktu Jeftinije.hr pod „Podaci“, spáruje vaši položku s existujícím katalogem do 48 hodin, a cenCategoryId (číselné id z archivu kategorií skupiny) 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. Jeftinije 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. 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.