Přejít na obsah
Fruugo
Tržiště

Fruugo feed pro Shopify

Fruugo je globální cross-border marketplace: jeden účet prodejce, jeden feed ve vaší vlastní měně a jazyce a Fruugo ho zlokalizuje do 41 zemí, 28 jazyků a 31 měn. Není to srovnávač: objednávku přijímá Fruugo, řeší platbu i podvody a vám peníze vyplatí. Feedflock sestaví XML feed z vašeho katalogu Shopify podle zveřejněné specifikace Fruugo (Product pro každou variantu, povinný EAN, cenu s vlastní sazbou DPH) a hostuje ho na stabilní URL, kterou si Fruugo průběžně stahuje, protože ruční nahrávání je to jediné, co Fruugo nepřijímá.

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 · fruugo.xmlAktualizováno právě teď
<Product>
<ProductId>8236409175213</ProductId>
<SkuId>SKU-2048</SkuId>
<EAN>8594000123453</EAN>
<Brand>Nordlin</Brand>
<Category>Apparel &amp; Accessories &gt; Clothing &gt; Shirts &amp; Tops &gt; Mens</Category>
<PackageWeight>220</PackageWeight>
<Imageurl1>https://cdn.shop.example/img/linen-shirt-sand.jpg</Imageurl1>
<Imageurl2>https://cdn.shop.example/img/linen-shirt-sand-back.jpg</Imageurl2>
<StockStatus>OUTOFSTOCK</StockStatus>
<StockQuantity>12</StockQuantity>
<Description>
<Title>Lněná košile Sand</Title>
<Description>Relaxed linen shirt with a classic collar, in breathable European linen.</Description>
<AttributeSize>M</AttributeSize>
</Description>
<Price>
<Currency>EUR</Currency>
<NormalPriceWithVAT>49.00</NormalPriceWithVAT>
<VATRate>21</VATRate>
</Price>
</Product>
Mapování kategorií

Vaše typy produktů. Kategorie kanálu.

Kanál řadí nabídky podle vlastního stromu kategorií. Feedflock ke každému typu produktu ze Shopify navrhne kategorii a vy jen potvrdíte. Mapování platí pro všechny produkty daného typu, i pro ty nové.

Plná cesta kategorie ve feedu
Jedno mapování pro celý typ produktu
Přepis na úrovni jednotlivého produktu
Typ v Shopifyproduktů
Kategorie kanálu
Pánské košile
Pokrytí katalogu79 %
−20 % z původní ceny
ProduktNormalPriceWithVATDiscountPriceWithVAT
Lněná košile Sand49,00 €39,20 €
Hrnek Fjord 350 ml15,00 €12,00 €
Trail Pro119,00 €95,20 €
Batoh Ridge 28 l75,00 €60,00 €
Sójová svíčka Les14,00 €11,20 €
54,40 €zákazníci ušetří na těchto produktech
5 / 5produktů se slevovým překryvem
Akční ceny

Sleva je druhá cena ve stejném bloku Price.

Fruugo modeluje akci jako dvojici: NormalPriceWithVAT drží běžnou cenu a DiscountPriceWithVAT nese tu zlevněnou, vždy na stejné straně DPH a nikdy ne obě slevová pole najednou. Volitelné počáteční a koncové datum akci v čase ohraničí. Sleva žije ve feedu, takže cena, kterou Fruugo ukáže, je cena, kterou jste poslali.

6 fotek na produkt
1
Ve feedu
2
Ve feedu
3
Ve feedu
4
Ve feedu
5
Bez elementu
6
Bez elementu
4obrázků ve feedu
2bez elementu
Galerie obrázků

Pět číslovaných pozic pro fotky. Šestá nemá element.

Fruugo vezme jednu povinnou hlavní fotku a čtyři další v číslovaných elementech Imageurl2–5. Každý obrázek musí mít aspoň 400 × 400 px, bílé pozadí a žádné vodoznaky ani text přes fotku. Třetí fáze kontroly Fruugo ostatní zamítne. A jedna past navíc: obrázek se znovu stáhne, jen když se změní název jeho souboru.

Kontrola feedu

Chyby najdete dřív než Fruugo.

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 · fruugo.xml
76 / 100
Ke kontrole: 4
Kategorie jako neúplná cesta u 9 produktůFruugo chce vlastní plnou cestu od oddělení dolů, anglicky a s rozlišením velikosti písmen. Samotné „Shirts & Tops > Mens“ ruční kontrolou dat neprojde.
EAN rozbitý do vědecké notace u 14 variantČárový kód zaokrouhlený tabulkou na 1,05E+12 je podle samotného Fruugo zdokumentovanou příčinou zamítnutí celých feedů.
Název opakuje variantu u 7 produktůNázev seskupeného produktu nesmí zmiňovat velikost ani barvu, ty patří do AttributeSize a AttributeColor.
Prázdná VATRate u 6 produktůSazba DPH je povinná i pro prodejce mimo EU, kde se uvádí jako 0. Prázdný element kontrolou polí neprojde.

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 k Fruugo

    Přijetí je přihláška, ne samoobslužná registrace: nastavení účtu s vámi projde tým Business Development. Potřebujete být firma registrovaná k DPH a schopná zasílat do zahraničí.

  2. Nainstalujte Feedflock

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

  3. Vyberte šablonu Fruugo

    Product pro každou variantu, varianty seskupené sdíleným ProductId, prostý název produktu, cena s DPH a sazbou ve vlastním elementu a uzavřená sada stavů skladu: to všechno je namapované hned od začátku.

  4. Namapujte kategorie

    Kategorie musí být vlastní plná cesta Fruugo, anglicky a s rozlišením velikosti písmen. Feedflock strom Fruugo synchronizuje, takže vybíráte z 5 543 skutečných cest, místo abyste cesty přepisovali ručně.

  5. Předejte URL feedu

    Hostovaná URL je to, co při přijímání předáváte. První podání zkontroluje váš Integration Specialist a po spuštění si Fruugo URL stahuje pokaždé, když vyjde nová verze souboru.

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

Feed

Co kanál dostává

fruugo.xml
<Product>
  <ProductId>8236409175213</ProductId>
  <SkuId>SKU-2048</SkuId>
  <EAN>8594000123453</EAN>
  <Brand>Nordlin</Brand>
  <Category>Apparel &amp; Accessories &gt; Clothing &gt; Shirts &amp; Tops &gt; Mens</Category>
  <PackageWeight>220</PackageWeight>
  <Imageurl1>https://cdn.shop.example/img/linen-shirt-sand.jpg</Imageurl1>
  <Imageurl2>https://cdn.shop.example/img/linen-shirt-sand-back.jpg</Imageurl2>
  <StockStatus>INSTOCK</StockStatus>
  <StockQuantity>12</StockQuantity>
  <Description>
    <Title>Linen shirt Sand</Title>
    <Description>Relaxed linen shirt with a classic collar, in breathable European linen.</Description>
    <AttributeSize>M</AttributeSize>
  </Description>
  <Price>
    <Currency>EUR</Currency>
    <NormalPriceWithVAT>49.00</NormalPriceWithVAT>
    <VATRate>21</VATRate>
  </Price>
</Product>
Živý náhled
Lněná košile Sand

Nordlin

Lněná košile Sand

49 €

Pole feedu

ProductId

8236409175213

SkuId

SKU-2048

EAN

8594000123453

Brand

Nordlin

Category

Apparel & Accessories › Clothing › Shirts & Tops › Mens

PackageWeight

220

StockStatus

INSTOCK

StockQuantity

12

Title

Linen shirt Sand

Description

Relaxed linen shirt with a classic collar, in breathable European linen.

AttributeSize

M

Currency

EUR

NormalPriceWithVAT

49.00

VATRate

21

Kanál

Jeden feed, 41 zemí

Odevzdáte jeden feed ve své měně a jazyce; Fruugo ho přeloží do 28 jazyků a přepočítá ceny do 31 měn pro svých 41 tržišť.

Pokladnu řídí Fruugo

Objednávku přijímá Fruugo, řeší platbu i podvody a prodejci peníze vyplácí. Žádný proklik, na který byste přihazovali, žádný sdílený katalog, ke kterému byste se párovali: vaše položka je rovnou nabídka.

Plně veřejná specifikace

Tabulky polí, limity, dialekt CSV, pravidla pro GTIN i strom kategorií s 5 543 cestami: všechno je zveřejněné na dokumentační wiki Fruugo. Bez NDA a bez hádání.

Feed

  • Šablona psaná podle zveřejněné specifikace Fruugo, včetně přesných názvů elementů s rozlišením velikosti, jako jsou Imageurl1 a AttributeColor
  • Všech jedenáct povinných polí namapovaných od začátku, od ProductId a EAN po Title, NormalPriceWithVAT a VATRate
  • Product pro každou variantu s ProductId jako trvalým seskupovacím klíčem, a název zůstává prostý název produktu, protože velikost a barva patří do AttributeSize a AttributeColor
  • Kategorie vybrané z vlastního stromu Fruugo, synchronizovaného do Feedflocku: 5 543 úplných anglických cest zapsaných s rozlišením velikosti včetně oddělení
  • Cena tak, jak ji Fruugo chce: s DPH, desetinnou tečkou a bez symbolu měny, měna a sazba DPH ve vlastních elementech, a při akci zlevněná cena s časovým oknem
  • Vyprodané varianty zůstávají ve feedu jako OUTOFSTOCK. Fruugo zakazuje ze souboru odstraňovat i trvale nedostupné zboží
  • Hostování na stabilní URL, kterou si Fruugo stahuje podle svého plánu, generování klidně každou hodinu a sledování, kdy si Fruugo feed stáhlo naposledy

Do hloubky

01

Jeden feed pro 41 zemí

  • Jeden feed ve vaší měně a jazyce obslouží všechny země Fruugo
  • Fruugo obsah překládá do 28 jazyků a ceny přepočítává do 31 měn
  • Element Currency nese vaši měnu, ne měnu kupujícího. Fruugo doporučuje rodnou měnu země vaší registrace
  • Country je seznam povolených zemí a zůstává prázdný, pokud produkt nezasíláte do méně zemí
Technické detaily

Model Fruugo je pravým opakem marketplacu po zemích: jeden účet prodejce, jeden feed, jedna měna a jeden jazyk, a lokalizaci dělá Fruugo, překlad do 28 jazyků a přepočet do 31 měn napříč 41 zeměmi. Element Currency ve feedu proto nese vaši měnu, ne měnu zákazníka, a Fruugo doporučuje rodnou měnu země, kde je vaše firma registrovaná.

Pokud produkt zasíláte do méně zemí, než pokrývá váš účet, zúží to volitelný element Country uvnitř Price: seznam povolených zemí oddělený mezerami, například IE FR DE. Ve výchozím stavu odchází prázdný, protože vyplněný by globální feed potichu zúžil.

02

Fruugo si stahuje vaši URL a nic jiného nepřijímá

  • Feed musí žít na URL u vás, kterou si Fruugo stahuje automaticky
  • Ruční nahrávání je výslovně nepřípustné; publikujte aspoň denně
  • Strop účtu je 150 000 SKU, pokud Fruugo výslovně nepovolí víc
  • Feedflock soubor hostuje na stabilní URL a generuje ho klidně každou hodinu
Technické detaily

Zveřejněná politika Fruugo říká, že všechna data přicházejí automatickým feedem publikovaným na statickou URL, generovaným aspoň jednou denně. Ruční nahrávání se nepřijímá a jediná výjimka přes FTP se týká jen podoby CSV. Fruugo si pak soubor stahuje pokaždé, když vyjde nová verze; pevný interval zveřejněný není, takže čerstvost dat je vaše strana dohody.

A přesně na tom je Feedflock postavený: soubor žije na stabilní URL, generuje se podle vašeho plánu klidně každou hodinu a URL předáváte jednou, při přijímání. Samotný účet má strop 150 000 SKU, pokud vám Fruugo výslovně nepovolí víc.

03

Pět kontrolních fází: ta čtvrtá je člověk

  • První fáze kontroluje strukturu feedu, druhá validuje každé povinné pole proti schématu
  • Třetí fáze zamítá obrázky pod 400 × 400 px, bez bílého pozadí nebo s vodoznakem
  • Čtvrtá fáze je ruční: člověk kontroluje použití značky, kategorizaci a popisy produktů
  • Každá fáze reportuje chybná SKU a tabulkou rozbitý EAN umí zamítnout celý feed
Technické detaily

Každý feed projde pěti fázemi: kontrolou struktury, automatickou validací polí (povinná pole vyplněná, délky znaků, nepodporované hodnoty), kontrolou kvality obrázků, ruční kontrolou dat a dokončením. Report za každou fázi jmenuje chybná SKU. Právě v automatické fázi se projeví zveřejněné limity polí: skutečným příkladem je URL obrázku delší než 150 znaků.

Čtvrtou fázi žádný soubor neprojde sám: tým Fruugo ručně kontroluje použití značky, kategorizaci a popisný obsah, a proto neúplná nebo špatně napsaná cesta kategorie neprojde, i když je XML bezchybné. Fruugo samo jako varovný příklad uvádí tabulku, která 13místný EAN zaokrouhlí na 1,05E+12, chyba formátování, která zamítne celé feedy.

04

ID jsou trvalá, EAN je povinný, název zůstává prostý

  • ProductId seskupuje varianty produktu; dvojice ProductId + SkuId se nesmí nikdy změnit ani znovu použít
  • EAN je povinný u každého produktu: vlastní značka a zakázkové zboží posílá doslovné EXCEP, knihy používají ISBN
  • Název nesmí opakovat velikost ani barvu a nesmí nést cenu, sklad ani propagační texty
  • Obrázky se znovu stahují, jen když se změní název jejich souboru
Technické detaily

Na Fruugo neexistuje sdílený katalog, ke kterému byste se párovali: vaše položka je rovnou nabídka. Varianty produktu seskupuje sdílené ProductId a každou možnost identifikuje SkuId; obě hodnoty jsou trvalé, nikdy se nemění a nikdy se nepoužijí pro novou položku. EAN je povinný univerzální identifikátor do 14 číslic; výrobci vlastní, zakázkové, personalizované nebo setové zboží posílají místo něj doslovné EXCEP a knihy přepínají na ISBN.

Pravidla pro název vyplývají ze seskupování: název seskupeného produktu nesmí zmiňovat velikost ani barvu (ty cestují v AttributeSize a AttributeColor) a nikdy nesmí nést stav, cenu, sklad ani propagační text. Ještě jedna past je pro Fruugo typická: obrázek se znovu stáhne, jen když se změní název jeho souboru, takže fotka upravená na místě se na Fruugo nikdy neaktualizuje.

Shrnutí

Jeden feed ve vašem jazyce a měně, pět kontrolních fází, jednačtyřicet zemí. Feedflock drží váš feed pro Fruugo podle zveřejněné specifikace a na URL, kterou si Fruugo stahuje, přímo ze Shopify, klidně každou hodinu.

Claude · ChatGPT

Nebo nastavte feed pro Fruugo v chatu

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

feedflock · mcp

Vytvoř feed pro Fruugo a namapuj kategorie.

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

Časté dotazy

Všechny. Jeden feed ve vaší měně a jazyce obslouží všech 41 zemí Fruugo; obsah Fruugo přeloží do 28 jazyků a ceny přepočítá do 31 měn. Žádný feed pro jednotlivé země netřeba stavět.
Jedině z hostované URL. Politika Fruugo je automatický feed na statické URL, generovaný aspoň denně. Ruční nahrávání se nepřijímá. Fruugo si soubor stahuje pokaždé, když vyjde nová verze, a pevný interval nezveřejňuje, takže ho Feedflock generuje klidně každou hodinu, aby každé stažení četlo aktuální data.
Jedno z toho, nikdy oboje. NormalPriceWithVAT nebo NormalPriceWithoutVAT, jako holé číslo s desetinnou tečkou a bez symbolu měny, měna je ve vlastním elementu. VATRate je povinná vždy: sazba jako číslo bez znaku %, případně 0, pokud jste prodejce mimo EU. Šablona posílá cenu s DPH, protože přesně to je cena ve Shopify.
Vlastní značka, zakázkové, personalizované a setové zboží posílá v elementu EAN doslovné EXCEP, vlastní výjimku Fruugo. Knihy posílají místo EAN ISBN. Všechno ostatní potřebuje skutečný GTIN do 14 číslic.
Zůstane ve feedu se StockStatus OUTOFSTOCK. Trvale vyřazené zboží se označí NOTAVAILABLE a ani to se ze souboru nesmí odstranit; odstraní ho Fruugo samo. Feedflock drží vyprodané varianty ve feedu přesně z tohoto důvodu.
Fruugo reportuje za každou fázi a za každé SKU. Obvyklé příčiny: neúplná nebo špatně napsaná cesta kategorie, EAN zaokrouhlený tabulkou do vědecké notace, obrázek menší než 400 × 400 px nebo s vodoznakem, případně název nesoucí velikost, barvu či propagační text. Čtvrtá fáze je ruční kontrola značky, kategorizace a popisů.
Ano. Ve Feedflocku filtrujte podle kolekce, tagu, ceny nebo skladu, případně vyřaďte jednotlivé varianty. Kde se produkt prodává, zúží element Country uvnitř Price: seznam povolených zemí oddělený mezerami (například IE FR DE); když ho necháte prázdný, platí nastavení zemí vašeho účtu.

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