Tržiště

eMAG feed pro Shopify

eMAG Marketplace prodává v Rumunsku, Bulharsku a Maďarsku přes jedno Marketplace API. Feed si nestahuje: produkty a nabídky do něj přicházejí jako data product_offer, posílaná po dávkách. Feedflock tato data připraví z vašeho katalogu Shopify pro eMAG Rumunsko (nabídku za každou variantu s cenou bez DPH, ID sazby DPH, cenovým pásmem, skladem a dobou expedice) a každou hodinu je vygeneruje znovu, aby je vaše synchronizace mohla odeslat.

Instalovat na Shopify

01 · ShopifyProdukt v katalogu

Lněná košile SandNordlin · Pánské košileSKU-2048 · S–XL

Cena

259 lei

Skladem

0 ks

Když není skladem

02 · emag.jsonAktualizováno právě teď

[

{

"id": "243409",

"part_number": "SKU-2048",

"part_number_key": "",

"ean": "8594000123453",

"category_id": "506",

"brand": "Nordlin",

"vendor_category_id": "",

"name": "Lněná košile Sand",

"description": "Relaxed linen shirt with a classic collar.",

"url": "https://shop.example/products/linen-shirt-sand",

"warranty": "0",

"weight": "220",

"images_main": "https://cdn.shop.example/img/linen-shirt-sand.jpg",

"images_secondary": [

"https://cdn.shop.example/img/linen-shirt-sand-back.jpg"

"sale_price": "214.05",

"recommended_price": "",

"min_sale_price": "149.835",

"max_sale_price": "321.075",

"vat_id": "1",

"currency_type": "",

"status": "1",

"stock": "0",

"handling_time": "1",

"supply_lead_time": "14"

}

]

Nastavení

V provozu v pěti krocích

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

Založte si prodejní účet a přístup k API
Zaregistrujte se na eMAG Marketplace, získejte uživatele pro API a nahlaste IP adresy, ze kterých bude volat vaše synchronizace. eMAG přijímá volání jen z povolených IP.
Nainstalujte Feedflock
Přidejte Feedflock z Shopify App Store. Produkty, varianty, sklad i nastavení daní načte přímo přes Shopify API.
Vyberte šablonu eMAG
Založte feed ze šablony eMAG. part_number, name, brand, ean, sale_price bez DPH, stock a handling_time jsou namapované pro každou variantu; ID produktu prodejce se čte z metafieldu custom.emag_id.
Nastavte ID kategorie a DPH
Zadejte category_id listové kategorie ze seznamu kategorií eMAG, pevně nebo z metafieldu, a nastavte vat_id ze seznamu sazeb ve vašem účtu. Ceny odcházejí bez DPH a sazba jde zvlášť jako ID.
Odešlete data svou synchronizací
Vaše synchronizace vezme hodinová data, zabalí vždy nejvýš 50 nabídek do datové obálky eMAG a pošle je do Marketplace API. Feedflock obsah připraví, sám ho do eMAG neodesílá.
https://feedflock.appfleece.com/f/demo-emag/emag.json

Kontrola feedu

Chyby najdete dřív než eMAG.

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 · emag.json

76 / 100

Ke kontrole: 4

Cena s DPH v sale_price u 5 produktůeMAG čte každé cenové pole jako cenu bez DPH; cena s DPH pošle špatné číslo a rozhodí cenové pásmo min–max.

vat_id poslané jako 21 u 3 produktůvat_id je ID sazby ze seznamu ve vašem účtu, ne procento: 21 znamená sazbu číslo 21.

part_number delší než 25 znaků u 4 varianteMAG omezuje part_number na 25 znaků a při uložení z něj odstraní mezery, čárky a středníky.

ID varianty Shopify jako id u 9 produktů13–14místná ID Shopify jsou daleko nad maximem eMAG 16 777 215, takže nabídku eMAG odmítne.

Feed

Co kanál dostává

emag.json

[
  {
    "id": "243409",
    "part_number": "SKU-2048",
    "part_number_key": "",
    "ean": "8594000123453",
    "category_id": "506",
    "brand": "Nordlin",
    "vendor_category_id": "",
    "name": "Linen shirt Sand",
    "description": "Relaxed linen shirt with a classic collar.",
    "url": "https://shop.example/products/linen-shirt-sand",
    "warranty": "0",
    "weight": "220",
    "images_main": "https://cdn.shop.example/img/linen-shirt-sand.jpg",
    "images_secondary": [
      "https://cdn.shop.example/img/linen-shirt-sand-back.jpg"
    ],
    "sale_price": "214.05",
    "recommended_price": "",
    "min_sale_price": "149.835",
    "max_sale_price": "321.075",
    "vat_id": "1",
    "currency_type": "",
    "status": "1",
    "stock": "0",
    "handling_time": "1",
    "supply_lead_time": "14"
  }
]

Živý náhled

Nordlin

Lněná košile Sand

259 lei

Pole feedu

.0.id

243409

.0.part_number

SKU-2048

.0.part_number_key

.0.ean

8594000123453

.0.category_id

506

.0.brand

Nordlin

.0.vendor_category_id

.0.name

Linen shirt Sand

.0.description

Relaxed linen shirt with a classic collar.

.0.url

https://shop.example/products/linen-shirt-sand

.0.warranty

.0.weight

220

.0.sale_price

214.05

.0.recommended_price

.0.min_sale_price

149.835

.0.max_sale_price

321.075

.0.vat_id

.0.currency_type

.0.status

.0.stock

.0.handling_time

.0.supply_lead_time

Kanál

Prodávejte na produktech, které eMAG už má

Pokud produkt v katalogu eMAG už je, vaše nabídka se k němu připojí přes part_number_key nebo EAN, bez nové produktové stránky a bez čekání na kontrolu obsahu.

Jedno API, tři země

Stejné Marketplace API a stejná struktura product_offer slouží pro eMAG v Rumunsku, Bulharsku i Maďarsku. Mezi platformami se liší jen jazyk, měna a ID sazeb DPH.

Cenové pásmo proti překlepům

Při prvním uložení chce eMAG ke každé nabídce minimální a maximální cenu, takže překlep mimo toto pásmo se nikdy nezobrazí.

Feed

Šablona eMAG mapuje všechny klíče, které eMAG vyžaduje: id, part_number, category_id, name, brand, sale_price, minimální a maximální cenu, vat_id, status, stock a handling_time
Ceny odcházejí bez DPH, jak eMAG chce, vydělené sazbou z vašeho nastavení daní v Shopify, a sazba jde zvlášť jako její ID
ID produktu prodejce se čte z metafieldu, protože ID variant Shopify se do celočíselného rozsahu eMAG nevejdou
Povinné cenové pásmo je předvyplněné na 70 % a 150 % ceny bez DPH a dá se upravit
Akční ceny z přeškrtnuté ceny: recommended_price nad sale_price zobrazí nabídku jako akci
Sklad se ořezává na nulu a vyprodaná varianta zůstává aktivní se stock 0, přesně jak eMAG vyprodání vyjadřuje

Do hloubky

Jak se produkty dostanou do eMAG

eMAG si feed z URL nestahuje: jeho Marketplace API přijímá data přímo v požadavku
Nabídky chodí po dávkách nejvýš 50 na požadavek, s přístupem HTTP Basic z povolených IP
Sklad jde aktualizovat samostatně, bez opětovného posílání celé nabídky
Feedflock data product_offer připravuje každou hodinu; odesílá je vaše synchronizace

Technické detaily

eMAG není srovnávač, který si stahuje feed z URL. Jeho Marketplace API přijímá produktová data a nabídky v těle každého požadavku (nejvýš 50 nabídek najednou, s přihlášením HTTP Basic a jen z IP adres, které si necháte povolit) a sklad jde aktualizovat i samostatně.

Feedflock připravuje data product_offer pro každou variantu, se všemi klíči, které API potřebuje, a generuje je každou hodinu, takže synchronizace, která je odesílá, vždy pracuje s aktuálním katalogem. Samotné odeslání ale dělá vaše synchronizace, ne Feedflock.

Produkt a nabídka v jednom objektu

Jeden product_offer nese produktovou dokumentaci i prodejní nabídku
Aktualizace nabídky potřebuje jen id, status, sale_price, vat_id, stock a handling_time
Nový produkt potřebuje navíc category_id, name, part_number a brand a projde kontrolou obsahu
min_sale_price a max_sale_price jsou povinné při prvním uložení

Technické detaily

Jeden product_offer má dvě poloviny: produktovou dokumentaci (name, brand, part_number, description, obrázky, ean a category_id) a prodejní nabídku (sale_price, vat_id, stock, handling_time a status). Aktualizace existující nabídky potřebuje jen nabídkové klíče a vaše id; nový produkt navíc category_id, name, part_number a brand a potom prochází kontrolou obsahu eMAG.

Při prvním uložení eMAG chce i min_sale_price a max_sale_price. ID produktu prodejce musí být celé číslo nejvýš 16 777 215, což ID variant Shopify mnohonásobně přesahují, a proto ho šablona čte z metafieldu, který přiřadíte.

Ceny bez DPH a ID sazby

Všechny ceny jsou bez DPH, nejvýš na čtyři desetinná místa a vždy nad nulou
Sazba DPH jde zvlášť jako ID z vašeho účtu, nikdy jako procento
Na eMAG Rumunsko jsou ceny v lei a currency_type se vynechává
Feedflock počítá ceny bez DPH z vašich sazeb v Shopify

Technické detaily

Všechny ceny jsou bez DPH, nejvýš na čtyři desetinná místa a vždy nad nulou; sazba DPH jde zvlášť jako ID ze seznamu sazeb ve vašem účtu, nikdy jako procento v ceně. Na eMAG Rumunsko se platí v lei, vlastní měně platformy, takže currency_type zůstává prázdné.

Feedflock ceny bez DPH počítá ze sazby ve vašem nastavení daní v Shopify, takže se do pole bez DPH nikdy nedostane cena s daní. recommended_price je přeškrtnutá cena, rovněž bez DPH, a aby se zobrazila jako akce, musí být vyšší než sale_price.

Párování s katalogem eMAG

K existujícímu produktu se nabídka připojí přes part_number_key nebo jeden EAN
Založení nového produktu je až záložní cesta a před prodejem prochází kontrolou obsahu
category_id musí být listová kategorie a kategorie určuje, zda je povinný EAN nebo záruka
Vyprodáno znamená stock 0, ne status 0

Technické detaily

Pokud produkt v katalogu eMAG už existuje, připojte k němu nabídku přes jeho part_number_key nebo jeden EAN, místo abyste zakládali duplicitu. Založení nového produktu je až záložní cesta a před prodejem prochází kontrolou obsahu.

category_id musí být listová kategorie ze seznamu eMAG a právě kategorie určuje, jestli je povinný EAN nebo záruka. Nabídka se prodává jen se skladem nad nulou a statusem 1, takže vyprodaná varianta zůstává aktivní se stock 0.

Shrnutí

Šablona, která už umí strukturu product_offer eMAG, s cenami bez DPH, cenovým pásmem a skladem generovanými každou hodinu. Váš katalog Shopify zůstává jediným zdrojem pravdy a vaše synchronizace s eMAG vždy posílá jeho aktuální stav.

Claude · ChatGPT

Nebo nastavte feed pro eMAG v chatu

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

Jak to funguje →

feedflock · mcp

Vytvoř feed pro eMAG a namapuj kategorie.

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

Časté dotazy

Ne. Marketplace API eMAG přijímá data v každém požadavku, po dávkách nejvýš 50 nabídek, a jen z IP adres, které si necháte povolit. Feedflock data product_offer připravuje a každou hodinu obnovuje; do eMAG je posílá synchronizace na vaší straně.

Pro eMAG Rumunsko: ceny v lei a rumunské DPH. Stejné API i stejná struktura dat slouží eMAG v Bulharsku a Maďarsku, kde se liší jen jazyk, měna a ID sazeb DPH.

eMAG čte každé cenové pole jako cenu bez DPH a daň nese zvlášť jako ID sazby. Šablona proto počítá ceny bez DPH z vašeho nastavení daní v Shopify, protože cena s daní by poslala špatné číslo.

Každá nabídka potřebuje stálé ID produktu prodejce (celé číslo nejvýš 16 777 215, které ID varianty Shopify přesahuje, takže ho mějte v metafieldu) a part number do 25 znaků, namapovaný ze SKU varianty. Pro připojení k produktu, který eMAG už má, přidejte jeho part_number_key nebo jeden EAN.

recommended_price vyšší než sale_price zobrazí nabídku jako akci; stejná nebo nižší cena slevou není. Šablona ji bere z přeškrtnuté ceny v Shopify, přepočtené na cenu bez DPH.

Do nabídky ne. Poplatek za doručení je nastavení ve vašem prodejním účtu eMAG; nabídka nese jen handling_time, tedy počet dní do odeslání objednávky, 0 pro tentýž den.

Ano. Filtrujte podle kolekce, tagu, ceny nebo skladu, případně vyřaďte jednotlivé varianty, třeba produkty bez EAN v kategorii, která ho vyžaduje.