Přejít na obsah
Spartoo
Móda a bydlení

Spartoo feed pro Shopify

Spartoo je francouzský marketplace módy a obuvi, který stojí za zhruba 26 lokalizovanými weby (spartoo.fr, .de, .co.uk, .cz a dalšími), kde schválení prodejci nabízejí vedle retailového katalogu. Jeho integrační model je hostovaný soubor, který si stahuje každou hodinu, tedy přesně tvar, jaký Feedflock vyrábí. Feedflock vykreslí váš katalog Shopify v provisionningovém XML Spartoo: produkt za každou kombinaci střihu a barvy, velikosti vnořené s vlastním skladem a EAN, ceny v eurech s desetinnou tečkou, a generuje ho podle vašeho plánu, takže každé hodinové stažení čte aktuální data.

01 · ShopifyProdukt v katalogu
Lněná košile SandNordlin · Pánské košileSKU-2048 · S–XL
Cena
49 €
Skladem
0 ks
Když není skladem
02 · spartoo.xmlAktualizováno právě teď
<product>
<reference_partenaire>SKU-2048</reference_partenaire>
<product_name><![CDATA[Lněná košile Sand]]></product_name>
<manufacturers_name><![CDATA[Nordlin]]></manufacturers_name>
<product_sex>H</product_sex>
<product_price>49.00</product_price>
<product_quantity>17</product_quantity>
<color_id>6887</color_id>
<product_style>10771</product_style>
<product_description><![CDATA[A breathable linen shirt in a regular cut.]]></product_description>
<product_color><![CDATA[Sand]]></product_color>
<size_list>
<size>
<size_name>M</size_name>
<size_quantity>0</size_quantity>
<size_reference>SKU-2048_M</size_reference>
<ean>8594000123453</ean>
</size>
<size>
<size_name>L</size_name>
<size_quantity>0</size_quantity>
<size_reference>SKU-2048_L</size_reference>
<ean>8594000123460</ean>
</size>
</size_list>
<photos>
<url1>https://cdn.shop.example/files/linen-shirt-sand.jpg?v=1718000000</url1>
<url2>https://cdn.shop.example/files/linen-shirt-sand-back.jpg?v=1718000000</url2>
</photos>
</product>
10 fotek na produkt
1
Ve feedu
2
Ve feedu
3
Ve feedu
4
Ve feedu
5
Ve feedu
6
Ve feedu
7
Ve feedu
8
Ve feedu
9
Bez slotu
10
Bez slotu
8obrázků ve feedu
2nad stropem 8 fotek Spartoo
Galerie obrázků

Osm slotů na fotky. Devátá ze Shopify neodejde.

Spartoo vyžaduje aspoň jednu fotku a povoluje nejvýš osm na produkt, uvnitř obálky <photos> jako osm pojmenovaných elementů url1 až url8: jpg, čtverec, minimálně 500 × 500 px, zoom od 800 × 800. Feedflock sloty plní z obrázku varianty a vaší galerie; cokoli za osmou zůstane ve Shopify.

Kontrola feedu

Chyby najdete dřív než Spartoo.

Feedflock před každým vygenerováním zkontroluje, že jsou vyplněná všechna pole, která kanál vyžaduje, a u šablon ověřených proti specifikaci kanálu i to, že hodnoty odpovídají jeho pravidlům. Většinu problémů opravíte jedním kliknutím, bez úprav produktů v Shopify.

Kvalita feedu · spartoo.xml
74 / 100
Ke kontrole: 4
Kód pohlaví mimo H, F, M, K, G, B u 6 produktůproduct_sex bere jen šest kódů Spartoo; cokoli jiného produkt rovnou zamítne (fatální chyba 5). „Male“ nebo „women“ anglicky neprojde.
Nepovolené znaky v referenci u 3 produktůreference_partenaire smí obsahovat jen písmena, číslice, pomlčku, podtržítko a tečku. SKU s lomítkem nebo mezerou je zamítnuto (fatální chyba 2).
Chybí první fotka u 2 produktůAspoň jedna fotka je povinná (fatální chyba 18) a Spartoo k ní musí mít přístup (fatální chyba 27): jpg, čtverec, minimálně 500 × 500 px.
Chybí značka u 5 produktůmanufacturers_name je povinné (fatální chyba 4) a značka musí být pro váš prodejní účet schválená. Prázdný výrobce ve Shopify produkt zastaví.

Nastavení

V provozu v pěti krocích

Od holého Shopify obchodu k zařazené nabídce: celé nastavení stihnete na jedno kafe.

  1. Přihlaste se do marketplace Spartoo

    Prodej není samoobslužný: Spartoo každou přihlášku posuzuje podle kvality, cen, dopravy a servisních kritérií a vaše značky musí být pro prodejní účet schválené dřív, než se mohou zařadit.

  2. Nainstalujte Feedflock

    Přidejte Feedflock z Shopify App Store. Produkty, varianty, sklad i obrázky načte přímo přes Shopify API.

  3. Vyberte šablonu Spartoo

    Založte nový feed a zvolte Spartoo. Reference, název, značka, cena, fotky i vnořený seznam velikostí jsou namapované hned od začátku: produkt za každou barvu, každá velikost jako potomek s vlastním skladem, referencí a EAN.

  4. Doplňte kódovaná pole Spartoo

    Pohlaví je jedno z H, F, M, K, G, B; kategorie je číselný kód Spartoo a barva jedno z jeho 19 ID. Šablona špatný kód pohlaví nebo nepovolené znaky v referenci označí ještě před odesláním feedu.

  5. Vložte URL feedu

    Zkopírujte hostovanou URL do svého prodejního účtu Spartoo. Jeho procesor soubor stahuje každou hodinu a importuje, co v něm najde. Nic znovu nenahráváte.

    https://feedflock.appfleece.com/f/demo-spartoo/spartoo.xml

Feed

Co kanál dostává

spartoo.xml
<product>
  <reference_partenaire>SKU-2048</reference_partenaire>
  <product_name><![CDATA[Linen shirt Sand]]></product_name>
  <manufacturers_name><![CDATA[Nordlin]]></manufacturers_name>
  <product_sex>H</product_sex>
  <product_price>49.00</product_price>
  <product_quantity>17</product_quantity>
  <color_id>6887</color_id>
  <product_style>10771</product_style>
  <product_description><![CDATA[A breathable linen shirt in a regular cut.]]></product_description>
  <product_color><![CDATA[Sand]]></product_color>
  <size_list>
    <size>
      <size_name>M</size_name>
      <size_quantity>12</size_quantity>
      <size_reference>SKU-2048_M</size_reference>
      <ean>8594000123453</ean>
    </size>
    <size>
      <size_name>L</size_name>
      <size_quantity>5</size_quantity>
      <size_reference>SKU-2048_L</size_reference>
      <ean>8594000123460</ean>
    </size>
  </size_list>
  <photos>
    <url1>https://cdn.shop.example/files/linen-shirt-sand.jpg?v=1718000000</url1>
    <url2>https://cdn.shop.example/files/linen-shirt-sand-back.jpg?v=1718000000</url2>
  </photos>
</product>
Živý náhled
Lněná košile Sand

Nordlin

Lněná košile Sand

49 €

Pole feedu

reference_partenaire

SKU-2048

product_name

Linen shirt Sand

manufacturers_name

Nordlin

product_sex

H

product_price

49.00

product_quantity

17

color_id

6887

product_style

10771

product_description

A breathable linen shirt in a regular cut.

product_color

Sand

size_name

M

size_quantity

12

size_reference

SKU-2048_M

ean

8594000123453

size_name

L

size_quantity

5

size_reference

SKU-2048_L

ean

8594000123460

url1

https://cdn.shop.example/files/linen-shirt-sand.jpg?v=1718000000

url2

https://cdn.shop.example/files/linen-shirt-sand-back.jpg?v=1718000000

Kanál

Jeden feed, ~26 státních webů

Spartoo provozuje lokalizované obchody od Francie po Česko: .fr, .de, .es, .it, .co.uk, .cz a další, všechny živé. Váš katalog se do sítě dostane jednou integrací místo šestadvaceti.

Katalog stavěný na módu

Formát je od základu módní: produkt je střih v jedné barvě, velikosti jsou vnořené v něm a pohlaví, barva i materiál jsou strukturované kódy, které řídí filtry, jimiž zákazníci nakupují.

Každou hodinu, od návrhu

Procesor Spartoo stahuje vaši URL feedu každou hodinu a importuje, co najde. Změna ceny nebo doskladnění ve Shopify je na marketplaci živá do hodiny, bez jakékoli práce se soubory na vaší straně.

Feed

  • Šablona psaná podle specifikační stránky Spartoo a ověřená proti jeho kostře, vzorovému feedu i XSD: kořen je <root><products>, obálky jsou skutečné a každý název tagu je doslovný
  • Produkt za každou barvu se všemi velikostmi vnořenými v <size_list>, každá s vlastním skladem, referencí a EAN, přesně tvar vzorového feedu samotného Spartoo
  • product_name odchází jako čistý název produktu, nikdy název s variantou. Název nabitý barvou nebo značkou Spartoo zamítá (fatální chyba 35), takže ho šablona nikdy nenaplňuje
  • Pravidla ze specifikace vynucená už při generování: povolené znaky reference, šest kódů pohlaví, celý nezáporný sklad a popis do 65 000 znaků se kontrolují při každém sestavení a hlásí se, nic se potichu nepřepisuje
  • Sklad po velikostech ořezaný na nulu: Shopify hlásí přeprodané varianty záporným číslem, které Spartoo zamítá (fatální chyba 10); velikost s nulou se prostě deaktivuje do doskladnění
  • Fotky v obálce <photos> jako url1 až url8, obrázek varianty první, takže název v CDATA odolný vůči ampersandu a dostupná hlavní fotka odcházejí u každého produktu
  • Sledování stahování ukáže, kdy si Spartoo feed naposledy stáhlo, a upozorní, když hodinové stahování přestane

Do hloubky

01

Jak Spartoo váš feed čte

  • Vy poskytnete URL; procesor Spartoo soubor stahuje každou hodinu
  • XML nebo CSV, UTF-8: sloupce CSV se mapují na straně Spartoo, názvy XML tagů jsou pevné
  • Žádná cesta pro nahrání ani SFTP; kdo nemá server, Spartoo odkazuje na Dropbox
  • Feedflock soubor hostuje na stabilní URL a každou hodinu ho přegeneruje
Technické detaily

Integrační přehled Spartoo říká model otevřeně: poskytnete URL vedoucí na soubor se všemi informacemi o produktech a každou hodinu jejich procesor soubor stáhne a obsah integruje. Žádné nahrávání, žádné SFTP, a kde obchodník nemá server, vlastní rada Spartoo zní Dropbox. Hostovaná, vždy čerstvá URL je přesně to, co Feedflock poskytuje, takže kadence je jejich a čerstvost vaše.

Změny se projeví při nejbližším hodinovém průchodu. Dokumentace sama feedovou cestu kontrastuje s webservisami tím, že feed není v reálném čase. Protože Feedflock soubor sestavuje každou hodinu, každé stažení čte aktuální ceny a sklad, což je přesně to, co pravidlo čerstvosti Spartoo žádá: soubor musí být aktuální, aby se nedostupné položky nejevily jako skladem.

02

Produkt za každou barvu, velikosti uvnitř

  • Pro Spartoo je produkt střih v jedné barvě; každá velikost je v něm podřízený produkt
  • reference_partenaire identifikuje barevnou variantu střihu; velikosti žijí v <size_list>
  • Každý <size> nese vlastní size_name, size_quantity, size_reference a ean
  • Opakovaná reference je varování a duplicity se ignorují; stejná velikost dvakrát je fatální
Technické detaily

Toto je ta věc, kterou je na Spartoo potřeba pochopit: střih ve dvou barvách jsou dva produkty se dvěma různými identifikačními kódy, zatímco produkt může mít víc velikostí vnořených v sobě. Šablona Feedflocku vykresluje přesně tohle: jeden <product> za barvu, každá velikost jako potomek <size> s vlastním počtem skladem, objednávkovou referencí a EAN, stejný tvar, jaký má vzorový feed samotného Spartoo.

Sklad je po velikostech a nula je vypínač: když je sklad velikosti 0, produkt se deaktivuje a na Spartoo se přestane zobrazovat; vyprodaná položka tak ve feedu zůstává s nulou místo aby zmizela. size_reference se řídí vlastním doporučením Spartoo: reference produktu a název velikosti spojené podtržítkem, což je tvar, který používají jejich exporty objednávek a vratek.

03

Kódy, ne názvy

  • Pohlaví je uzavřený výčet: H, F, M, K, G, B; cokoli jiného je fatální
  • Kategorie je číselný kód Spartoo; kód, který neexistuje, produkt zamítne
  • Barva je jedno z 19 číselných ID; neznámá vás stojí jen filtr barev
  • Materiály obuvi jsou číselné kódy složení; nástroj na párování materiálů Spartoo nemá
Technické detaily

Spartoo třídí kódy. product_sex bere přesně šest hodnot (H, F, M, K, G, B) a chybová hláška je jmenuje. product_style chce číselný kód kategorie ze zveřejněné tabulky 398 kategorií (název se toleruje, jen když ho pak spárujete v nástroji v back office) a color_id je jedno z 19 ID barev. Pošlete kód, který neexistuje, a produkt je zamítnut; pošlete neznámou barvu a importuje se, ale vypadne z filtrů barev.

Stejná disciplína platí pro materiály obuvi: čtyři pole složení (svršek, podšívka, stélka, podrážka) berou kódy z 52řádkové tabulky, každý platný jen ve svém poli, a Spartoo uvádí, že nástroj na párování materiálů nemá. Feedflock je mapuje z metafieldů nebo konstant, takže kódy zvolíte jednou pro celou produktovou skupinu místo přepisování po velikostech.

04

Fotky, EAN a hranice feedu

  • Jedna fotka je povinná, tři doporučené, osm maximum: jpg, čtverec, minimálně 500 × 500 px
  • Názvy souborů smí obsahovat jen písmena, číslice, pomlčku, podtržítko a tečku; žádné mezery ani háčky
  • EAN je na velikosti a podmíněně povinný: povinný jen s fulfillment službou Spartoo
  • Doprava, objednávky a vratky ve feedu nejsou, běží přes webservisy Spartoo
Technické detaily

Fotky žijí v obálce <photos> jako osm pojmenovaných elementů url1 až url8. První je povinná, pod 350 × 350 se fotka nezobrazí a od 800 × 800 výš se na webu zapne zoom. Dvě pasti, které stojí za zřetel: každou fotku si Spartoo stáhne jednou a uloží na svých serverech, takže změnit obrázek beze změny URL neudělá nic a název souboru nesmí obsahovat mezery ani písmena s diakritikou.

Otázka EAN vypadá v dokumentaci rozporně, dokud si nepřečtete francouzský originál: anglická stránka říká nepovinný, zatímco francouzská a německá tabulka ho označují jako povinný pro logistickou službu. V praxi prodejce, který si objednávky expedi sám, ho může nechat prázdný, a prodejce na fulfillmentu Spartoo ne. A feed končí u katalogu: doprava, zpracování objednávek a synchronizace skladu v reálném čase běží přes samostatné prodejní webservisy, ne přes tento soubor.

Shrnutí

Jedna URL, hodinové stahování a šablona, která mluví vlastním slovníkem Spartoo: produkt za každou barvu, velikosti vnořené, kódy tam, kde je Spartoo chce. Jediným zdrojem pravdy zůstává váš katalog v Shopify; jediné, co Spartoo potřebuje od vás, je schválení prodejce.

Claude · ChatGPT

Nebo nastavte feed pro Spartoo v chatu

Propojte Feedflock s Claude nebo ChatGPT a zeptejte se. Feed založí jako koncept, namapuje kategorie podle stromu Spartoo a řekne, co ještě chybí. Každou změnu schvalujete vy.

feedflock · mcp

Vytvoř feed pro Spartoo a namapuj kategorie.

Založím ho jako koncept a každou změnu vám předem ukážu.

Časté dotazy

Přihláškou do marketplace programu Spartoo; samoobslužné to není. Spartoo kandidáty posuzuje podle kvality, cen, dopravy a servisních kritérií a vyhrazuje si právo přihlášku přijmout nebo zamítnout; vaše značky musí být pro prodejní účet schválené dřív, než se mohou zařadit. Samotný feed může být připravený dlouho předtím, než schválení dorazí.
Každou hodinu. Procesor Spartoo stahuje vaši URL feedu hodinově a integruje, co najde; změny nejsou v reálném čase, projeví se při nejbližším průchodu. Feedflock soubor generuje každou hodinu, takže každé stažení čte aktuální ceny a sklad.
Zůstane ve feedu se skladem 0 a Spartoo ji deaktivuje: nula produkt vypne, aniž by ho odstranila. Jakmile Shopify znovu naskladní, nejbližší regenerace obnoví počet a další hodinové stažení velikost znovu aktivuje.
Podmíněně. Francouzská a německá tabulka polí označují EAN jako povinný pro logistickou (fulfillment) službu Spartoo a nepovinný pro prodejce, který si objednávky expedi sám. Vlastní vzorové CSV Spartoo posílá produkt se šesti velikostmi se sloupcem EAN prázdným. Kdykoli čárový kód máte, po velikosti ho posílejte: duplicitní EAN na jiné referenci je fatální chyba.
Fungují obojí a na názvech záleží jen u XML. Pro XML formát Spartoo zveřejňuje přesné názvy tagů, kostru i XSD, zatímco sloupce CSV popisuje rolí a mapují se na jeho straně, se středníkem jako oddělovačem a kódováním UTF-8 nastaveným na účtu. Šablona Feedflocku vykresluje XML podobu.
Dopravu ne: feed Spartoo nemá žádný element pro dopravce, cenu dopravy ani dobu doručení; objednávky a doprava běží přes back office a webservisy. Slevy existují jako blok <discount>, ale jeho počáteční a koncové datum jsou povinné a Shopify žádné období akce neukládá, takže Feedflock posílá slevu jako prostou cenu místo aby akci přepisoval každou hodinu.
Šablona vykresluje jednostátní formát: jeden jazyk, jedna měna, jeden cílový web. Spartoo zveřejňuje i vícestátní formát, který vnořuje názvy, popisy a ceny po jazycích; pro víc státních webů provozujete feed za každý trh, s cenami a překlady ze Shopify Markets.

Buďte na každém marketplace, na kterém záleží, ještě dnes odpoledne.

Nainstalujte zdarma, propojte první feed za pár minut a nechte Feedflock, ať ho udržuje čerstvý a zvalidovaný.

.myshopify.com