Export dat na Trhknih.cz

TrhKnih.cz je internetový antikvariát, kde lze nabízet a prodávat knihy. Z realizovaného prodeje se pak platí zprostředkovatelská provize. Zde najdete veškeré potřebné informace o tom, jak svůj e-shop propojit s Trhknih.cz a jak správně nastavit XML feed.

Registrace

Nejprve je potřeba se zaregistrovat a uvést své IČO, pokud prodáváte knihy v rámci podnikatelské činnosti. Je nutné kontaktovat infolinku se žádostí o napojení e-shopu. Je dobré mít již předem nadefinovaný feed, jehož adresu předáte TrhuKnih, který z ní bude poté pravidelně stahovat vaši nabídku knih. 

Kontakty na Trhknih.cz naleznete na tomto odkazu:

https://www.trhknih.cz/napoveda-antikvariat

https://www.trhknih.cz/kontakt

Datový feed nastavte dle návodu níže.

Nastavení datového feedu v ContOSu

Datový feed se definuje v nastavení e-shopu na kartě Adresy. Přepneme se na typ adresy zboží a můžeme začít definovat XML feed. Definice obsahuje i rozsah dat, které si bude Trhknih z vašeho e-shopu načítat.

Pro nastavení datového feedu pro TrhKnih.cz v administraci e-shopu postupujte následovně:

V nastavení e-shopu klikněte na záložku "Adresy"

Vyberte správný typ adresy

    • V levém panelu zvolte  "Zboží".

Přidejte nebo upravte feed pro TrhKnih

    • Pokud již feed existuje, klikněte na položku "Feed pro TrhKnih" (označeno jako 3).
    • Pokud feed neexistuje, klikněte na "Nová adresa" a vytvořte nový záznam.

Zadejte potřebné parametry feedu

    • Název adresy: Zadejte například "Feed pro TrhKnih".
    • URL adresy: Nastavte odpovídající identifikátor, např. trhknih. Celou adresu feedu pak tvoří URL e-shopu plus tento identifikátor. Pro uváděný eshop pak bude celá URL, která se předává na Trhknih https://eshop.contos.cloud/trhknih
    • Parametr adresy: Zadejte potřebné parametry pro generování feedu, například:


feedtype=trhknih&kat=267  


Povinný parametr je feedtype=trhknih ten určuje správnou strukturu dat. Pokud však potřebujete, aby feed obsahoval pouze určitou podmnožinu, můžete přidat další filtrační parametry. Jejich bližší popis naleznete v článku Datové feedy. 

Parametr &kat=267 říká, že do feedu budou posílány pouze položky z kategorie ID 267 (zde je to kategorie, ve které jsou knihy). Zamezíte tím odesílání položek, které se na Trhuknih neprodávají. Toto je nutné vždy respektovat a nezasílat tam jiné než knižní položky!

Jak zjistit ID kategorie je popsáno níže.

    • Ostatní pole ponechte prázdná.

Uložte nastavení

    • Klikněte na tlačítko "Uložit", aby se změny aplikovaly.

Poveďte synchronizaci

    • Po provedení synchronizace se definice přenese na e-shop a URL feedu bude aktivní.


Tip: Feed ověříte tak, že do internetového prohlížeče zadáte celou URL feedu. Prohlížeč pak zobrazí datový obsah v XML formátu.

Jak zjistit ID kategorie?

Otevřete okno "Kategorie produktů"

  • V hlavním menu přejděte do sekce Kategorie produktů, kde jsou uspořádány všechny dostupné kategorie e-shopu.

Vyberte požadovanou kategorii

  • V levém stromovém menu klikněte na název kategorie, jejíž ID chcete zjistit (například Knihy – viz označení na obrázku).

Otevřete detail kategorie

  • Klikněte na tlačítko "Detail", čímž otevřete nastavení vybrané kategorie.

Najděte ID kategorie

  • ID kategorie je zobrazeno v záhlaví okna s detaily kategorie vedle textu "(ID: číslo)" (v tomto případě 267 – viz označení na obrázku).


Další parametry feedu

Kategorie zboží

Nejprve zjistíme ID  kategorie, kterou chceme do feedu zahrnout a to tak, že v číselníku kategorií si zobrazíme detail kategorie a v záhlaví přečteme její ID.

kat=<id>

Kategorií může být více, pak je oddělíme čárkou. Např.  kat=259,262,270

Štítek zboží

Nejprve zjistíme ID  štítku, které mají produkty, jež chceme do feedu zahrnout a to tak, že v číselníku štítků si ID přečteme.

tag=<id>

Kategorií může být více, pak je oddělíme čárkou. Např.  tag=1,2

Rozpětí cen

Parametr p-min představuje minimální cenu a parametr p-max cenu maximální. Rozpětí cen od 100 do 40000 včetně pak bude vypadat takto:

p-min=100&p-max=40000

Vlastnost produktu

Do feedu můžeme filtrovat i produkty s nějakou konkrétní vlastností a její hodnotou. Opět si nejprve z číselníku vlastností zjistíme ID dané vlastnosti.

Parametr pro filtr pak zapíšeme ve tvaru id-vlastnosti=hodnota|id-hodnoty

Hledání

Produkty můžeme také specifikovat řetězcem, dle kterého se mají vyhledat. Zápis, kde vybereme pouze produkty s názvem "Acer", bude vypadat takto:

search=Acer


Tip: Všechny tyto parametry lze kombinovat. Jednotlivé skupiny parametrů oddělujeme znakem &.