
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.

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.
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.
Nastavení
V provozu v pěti krocích
Od holého Shopify obchodu k zařazené nabídce: celé nastavení stihnete na jedno kafe.
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.
Nainstalujte Feedflock
Přidejte Feedflock z Shopify App Store. Produkty, varianty, sklad i obrázky načte přímo přes Shopify API.
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).
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.
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á
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

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
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/HTTPSneboFTP, 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á.
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.
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é.
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í
JPGaWEBP, další jenJPG - 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.
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
Související feedy
Prozkoumat všech 101 kanálů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ý.