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

Miinto feed pro Shopify

Miinto je dánský módní marketplace, který po celé Evropě nabízí sklad kamenných butiků a značek. Není to srovnávač cen: řádek ve vašem feedu je produkt, který Miinto prodává, takže feed je zároveň váš katalog i váš skladový signál. Feedflock z katalogu Shopify vytvoří tabulátory oddělený feed pro Miinto (řádek za každou velikost, ceny jako celá čísla v centech včetně DPH, sklad jako prostý počet kusů) a hostuje ho na stabilní URL, kterou si Miinto stahuje každých třicet minut.

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 · miinto.tsvAktualizováno právě teď
id item_group_id brand title color size description material madein image_link c:stock_level:integer c:retail_price_EUR:integer c:discount_retail_price_EUR:integer gtin product_type gender
SKU-2048 8812345678901 Nordlin Lněná košile Sand Sand M A breathable linen shirt in a regular cut. {"en_EN.utf8": "100% Linen"} IT https://cdn.shop.example/files/linen-shirt-sand.jpg 0 4900 8594000123453 Shirts M
−20 % z původní ceny
Produktprice (původní)sale_​price
Lněná košile Sand49,00 €39,20 €
Hrnek Fjord 350 ml15,00 €12,00 €
Trail Pro119,00 €95,20 €
Batoh Ridge 28 l89,00 €71,20 €
Sójová svíčka Les12,00 €9,60 €
56,80 €zákazníci ušetří na těchto produktech
5 / 5produktů se slevovým překryvem
Akční ceny

Sleva je druhý sloupec: prázdný, nikdy nula.

Cenový slovník Miinto jsou dva sloupce: c:retail_price_EUR:integer pro běžnou cenu a c:discount_retail_price_EUR:integer pro akční, obě jako celá čísla s připnutými centy a včetně DPH. Feedflock posílá přeškrtnutou cenu jako běžnou, když je vyšší, a zlevněnou do sloupce se slevou a Miinto výslovně říká, že cena, která neexistuje, musí být prázdná buňka, ne 0. Produkt bez akce proto odchází s prázdným slevovým sloupcem a akce skončí, jakmile v Shopify odeberete přeškrtnutou cenu.

Kontrola feedu

Chyby najdete dřív než Miinto.

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 · miinto.tsv
76 / 100
Ke kontrole: 4
Různé obrázky u velikostí jednoho produktuVšechny řádky jednoho item_group_id musí nést stejný image_link. Validátor Miinto hodnotí „Multiple values in image_link“ jako kritickou chybu a produkty se neimportují.
Prázdný materiál u 14 produktůmaterial je povinný sloupec a Miinto ho chce jako JSON objekt s jazykovou značkou. Shopify takové pole nemá, takže se plní z metafieldu, který těmto produktům chybí.
Velikost nebo značka v názvu u 9 produktůMiinto to říká dvakrát: název nesmí obsahovat značku, velikost, id ani barvu. Velikost a barva mají vlastní sloupce.
Prázdná značka u 5 produktůbrand je povinný a plní se z výrobce (vendor) v Shopify a po spuštění feedu jeho změna produkt shodí offline.

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 jako partner Miinto

    Miinto přijímá butiky a značky přes partnerskou přihlášku a samotný feed nic nezajistí. Váš účet musí být napojený na Product Engine Miinto. Doprava se domlouvá na úrovni účtu v rámci Miinto Shipping Agreement; feed žádná data o dopravě nenese.

  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 Miinto

    Založte nový feed a zvolte Miinto. Všech 21 sloupců je namapovaných předem, řádek za každou variantu. Měna je součástí názvu cenových sloupců: šablona je eurovarianta, která obslouží eurové kanály Miinto (NL, BE, IT, FI, FR, DE, ES).

  4. Doplňte, co Shopify nemá

    Materiál a instrukce k praní odcházejí jako JSON objekty s jazykovou značkou. Drží je metafield a Liquid obálka z prostého textového metafieldu složí anglickou verzi objektu. Pohlaví je M, F nebo U a kategorie je cesta z vlastního stromu Miinto.

  5. Ověřte feed a vložte jeho URL

    Soubor nejdřív prožeňte veřejným validátorem Miinto (Feed Analysis Service), který nepotřebuje účet, a pak vložte hostovanou URL do integrace Miinto. Miinto feed stahuje každých 30 minut podle pevného plánu, takže název souboru nikdy neměňte.

    https://feedflock.appfleece.com/f/demo-miinto/miinto.tsv

Feed

Co kanál dostává

miinto.tsv
id	item_group_id	brand	title	color	size	description	material	madein	image_link	c:stock_level:integer	c:retail_price_EUR:integer	c:discount_retail_price_EUR:integer	gtin	product_type	gender
SKU-2048	8812345678901	Nordlin	Linen shirt Sand	Sand	M	A breathable linen shirt in a regular cut.	{"en_EN.utf8": "100% Linen"}	IT	https://cdn.shop.example/files/linen-shirt-sand.jpg	0	4900		8594000123453	Shirts	M
Živý náhled
Lněná košile Sand

Nordlin

Lněná košile Sand

49 €

Pole feedu

id

SKU-2048

item_group_id

8812345678901

brand

Nordlin

title

Linen shirt Sand

color

Sand

size

M

description

A breathable linen shirt in a regular cut.

material

{"en_EN.utf8": "100% Linen"}

madein

IT

c:stock_level:integer

0

c:retail_price_EUR:integer

4900

gtin

8594000123453

product_type

Shirts

gender

M

Kanál

Marketplace, ne srovnávač

Miinto nabízí sklad kamenných butiků a značek a zákazník nakupuje přímo na Miinto. Řádek ve feedu je produkt, který Miinto prodává. Feed je tak zároveň váš katalog i skladový signál, ne jen jedna nabídka mezi mnoha v cenové mřížce.

Sklad a cena se obnovují samy

Miinto stahuje každý feed každých 30 minut podle pevného plánu a sklad s cenami, včetně slev, jsou atributy, které se s každým stažením aktualizují automaticky. Naskladnění nebo změna ceny v Shopify se na Miinto dostane do půl hodiny.

Veřejný validátor ještě před startem

Feed Analysis Service Miinto je otevřený komukoli bez účtu: vložíte URL feedu a dostanete chybějící hlavičky, zastaralé sloupce i chyby jednotlivých položek s váhou. Přesně vidíte, co Miinto řekne, dřív než cokoli připojíte.

Feed

  • Šablona psaná podle vlastní integrační příručky Miinto a ověřená proti jeho živému Feed Analysis Service. Všech 21 sloupců a žádný zastaralý: availability, price, sale_price a c:style_id se nikdy nevykreslí, protože zastaralá hlavička je chyba struktury feedu
  • Název je čistý název produktu. Miinto odmítá v názvech značku, velikost, id a barvu, takže je šablona posílá ve sloupcích brand, size a color
  • Ceny odcházejí jako celá čísla s připnutými centy včetně DPH: 49 € je 4900 v c:retail_price_EUR:integer a přeškrtnutá cena se sama rozdělí do běžného a slevového sloupce. Bez akce zůstane slevová buňka prázdná, nikdy 0
  • Sklad je nezáporný počet oříznutý na 0. Shopify hlásí přeprodané varianty záporným číslem a Miinto bere 0 a víc, takže ho šablona ořízne
  • Jeden obrázek na skupinu: image_link je ve výchozím stavu hlavní obrázek produktu, protože validátor Miinto bere různé obrázky uvnitř jednoho item_group_id jako kritickou chybu, která produkty vyřadí
  • Materiál a instrukce k praní odcházejí ve tvaru JSON s jazykovou značkou, který Miinto chce, složeném z prostého metafieldu pomocí Liquid obálky šablony
  • Generováno každou hodinu na stabilní URL (přesně model hostovaného souboru, který fixní třicetiminutové stahování Miinto čeká) a sledování stahování ukáže, kdy si Miinto soubor naposledy stáhlo

Do hloubky

01

Jak Miinto váš feed čte

  • URL, kterou Miinto stahuje každých 30 minut, podle fixního plánu, který pro jednoho partnera nezmění
  • Pokaždé celý katalog: přírůstkové (delta) aktualizace nepodporuje
  • HTTP/HTTPS nebo FTP, veřejně nebo s Basic Auth; sFTP nepodporuje
  • Název souboru se nikdy nesmí změnit a soubor se musí stáhnout do 15 sekund, první bajt do 5
Technické detaily

Product Engine Miinto stahuje feed každého partnera každých třicet minut a ten plán je fixní. Miinto ho pro jednoho partnera nezpomalí ani nezrychlí. Soubor obsahuje pokaždé celý katalog, protože delta aktualizace neexistují, a je dostupný přes HTTP/HTTPS nebo FTP pod názvem, který se nikdy nemění. Existuje dokonce rychlostní rozpočet: stahování smí trvat nejvýš 15 sekund a první bajt musí dorazit do 5.

Přesně to je model hostované URL Feedflocku: jedna stabilní adresa, přegenerovaná každou hodinu, kterou do integrace vložíte jednou. Formát je TSV nebo CSV v UTF-8 s unixovými konci řádků a jedním hlavičkovým řádkem. Na pořadí sloupců nezáleží, na velikosti písmen v názvech ano, a každý použitý sloupec musí být v hlavičce, i když je hodnota prázdná.

02

Sloupce, které Miinto očekává

  • Třináct povinných hodnot, od id a item_group_id po material a madein
  • Název nenese značku, velikost, id ani barvu. Ty mají vlastní sloupce
  • Velikost je ta od výrobce, přímo z etikety. Přepočty se nepřijímají a kód země z etikety zůstává (36 IT, 8 UK)
  • gender zná jen M, F a U. Dětské zboží se deklaruje cestou kategorie
Technické detaily

Povinná sada Miinto je větší než jinde: id, item_group_id, brand, title, color, size, description, material, madein, image_link, počet kusů na skladě a oba cenové sloupce. Pravidlo pro název je to, na kterém se feedy nejčastěji spletou. Miinto dvakrát uvádí, že názvy nesmí obsahovat značku, velikost, id a barvu, a proto šablona posílá čistý název produktu a tuto práci nechává sloupcům pro velikost a barvu.

Některé hodnoty mají vlastní tvary. Velikost musí pocházet přímo od výrobce. Vaše přepočty Miinto nepřijme a když etiketa nese kód země, je kód součástí hodnoty: 36 IT, 38 FR, 8 UK. gender je výčet tří hodnot, M, F a U; dětská hodnota neexistuje, takže dětský produkt se deklaruje cestou kategorie, třeba Kids > Shoes > Sneakers. A gtin je nepovinný, na marketplace nezvyklé, ale když ho pošlete, musí mít 9 až 13 číslic s platnou kontrolní číslicí: osmimístný EAN se doplní nulou na začátek a čtrnáctimístné GTIN je mimo rozsah.

03

Ceny v centech, sklad jako počet

  • Ceny jsou celá čísla s připnutými centy včetně DPH: 100099 se čte jako 1000,99
  • Měna je součástí názvu sloupce: c:retail_price_EUR:integer obslouží eurové kanály
  • Cena, která neexistuje, je prázdná buňka, nikdy 0
  • Vyprodaná velikost zůstává ve feedu se skladem 0. Alespoň hodinu ji neodstraňujte
Technické detaily

Cena na Miinto je celé číslo s připnutými centy včetně DPH: 4900 znamená 49,00 €. Měna žije přímo v názvu sloupce (c:retail_price_EUR:integer) a každý prodejní kanál má svůj pár sloupců: eurové sloupce obslouží nizozemský, belgický, italský, finský, francouzský, německý a španělský obchod, zatímco Dánsko, Švédsko, Norsko, Polsko, Švýcarsko a Velká Británie čtou sloupce ve vlastní měně. A cena, která neexistuje, musí být prázdná buňka: 0 je cena, prázdné pole znamená „v této měně cenu nemám“.

Sklad je prostý počet v c:stock_level:integer a žádný prvek dostupnosti neexistuje. Starý sloupec availability je zastaralý. Když se velikost vyprodá, řádek necháte ve feedu a pošlete 0, a Miinto žádá, abyste položku alespoň hodinu neodstraňovali. A tady je část, se kterou musíte počítat: sklad a ceny jsou jediné atributy, které Miinto aktualizuje automaticky. Přejmenujete produkt, změníte barvu, šáhnete na značku a na Miinto se nic nezmění, dokud jejich strana produkt neodstraní a feed ho nevytvoří znovu. item_group_id, brand, color a size jsou po spuštění rovnou zmrazené.

04

Obrázky, duplicity a validátor

  • Všechny řádky jednoho item_group_id nesou stejný image_link. Různé obrázky jsou kritická chyba
  • Obrázky musí být https s důvěryhodným certifikátem; hlavní JPG a WEBP, další jen JPG
  • První obrázek je produktová fotka na bílém pozadí, tu ukazují výpisy
  • Opakovaná kombinace group_id + size + color + brand vyřadí celou kolidující sadu
Technické detaily

Obrázky si Miinto stahuje samo, podle vlastních pravidel: https s certifikátem od důvěryhodné autority, žádné triky s user-agentem, žádné 403 ani zástupné obrázky a odkaz, který se po připojení feedu nikdy nezmění. Hlavní obrázek bere JPG a WEBP, další obrázky jen JPG, a první fotka musí být produktový snímek na bílém pozadí. Jedno pravidlo nad ostatními: všechny řádky skupiny variant opakují stejný image_link. Validátor Miinto hodnotil různé obrázky uvnitř skupiny jako kritickou chybu i na vzorovém feedu samotného Miinto, a proto šablona ve výchozím stavu bere hlavní obrázek produktu, ne obrázek varianty.

Duplicity jsou stejně přísné: kombinace group_id, size, color a brand musí být jedinečná a opakovaná kombinace drží mimo web všechny produkty, které ji sdílejí, ne jen ty navíc. Než cokoli připojíte, prožeňte soubor Feed Analysis Service Miinto na proxy-fas.miinto.net: je veřejný, nepotřebuje účet a nahlásí chybějící hlavičky, zastaralé sloupce i chyby položek s jejich vahou.

Shrnutí

Jedna stabilní URL, fixní třicetiminutové stahování a šablona, která už umí TSV pro Miinto: cenové sloupce v centech, zmrazené atributy variant, materiály v JSON a všechno kolem. Váš katalog Shopify zůstává jediným zdrojem pravdy a skladový signál Miinto není nikdy starší než půl hodiny.

Claude · ChatGPT

Nebo nastavte feed pro Miinto v chatu

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

feedflock · mcp

Vytvoř feed pro Miinto a namapuj kategorie.

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

Časté dotazy

Přihlaste se přes partnerský onboarding Miinto (přijímá butiky a značky). Samotný feed nic nezařídí: váš účet musí být napojený na Product Engine Miinto a doprava se domlouvá zvlášť v rámci Miinto Shipping Agreement, smlouvy na úrovni účtu. Teprve pak se URL feedu, kterou poskytnete, začne stahovat.
Měna je součástí názvu cenového sloupce, takže pokrytí odpovídá sloupcům, které pošlete. Šablona je eurovarianta a její sloupec c:retail_price_EUR:integer obslouží nizozemský, belgický, italský, finský, francouzský, německý a španělský kanál Miinto. Dánsko, Švédsko, Norsko, Polsko, Švýcarsko a Velká Británie čtou každá sloupec ve vlastní měně.
Zůstane ve feedu se skladem 0: Miinto výslovně žádá, abyste vyprodanou položku alespoň hodinu neodstraňovali, a žádný příznak dostupnosti, který byste poslali místo toho, neexistuje. Sklad a cena jsou jediné atributy, které Miinto obnovuje automaticky, a nový počet si přečte nejbližší třicetiminutové stažení.
Protože se automaticky aktualizují jen sklad a ceny. Každý jiný atribut (název, popis, materiál) vyžaduje odstranění produktu v Product Management Service Miinto a nové vytvoření z feedu, což je ruční krok na straně Miinto. A item_group_id, brand, color a size se změnit nedají vůbec: jejich úprava produkt shodí offline.
Na Miinto jsou nepovinné, na rozdíl od většiny marketplaců. Když je pošlete, musí mít 9 až 13 číslic s platnou kontrolní číslicí. Osmimístný EAN se doplní úvodní nulou, zatímco čtrnáctimístné GTIN, které pole čárového kódu v Shopify často obsahuje, je mimo přijímaný rozsah.
Atribut gender má přesně tři hodnoty (M, F a U) a dětskou možnost nemá. Dětské produkty se deklarují kategorií: cestou product_type jako Kids > Shoes > Sneakers, ze zveřejněného stromu Miinto se 462 anglickými cestami.

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