JSON v Mergadu#
V Mergadu se nejčastěji pracuje se soubory XML a CSV. Editor ale přijímá také JSON, TSV a TXT. Může se stát, že dodavatel poskytne právě JSON feed a vy jej potřebujete nahrát do Mergada. Pokud se při zakládání projektu JSON nenačte nebo vrátí chybovou hlášku, bývá častou příčinou nesprávný formát či obsah feedu.
Co je JSON?#
JSON je jednoduchý textový formát pro výměnu dat. Je srozumitelný pro člověka a zároveň snadno zpracovatelný programy. Je to univerzální jazyk pro předávání strukturovaných dat mezi systémy.
Jak má JSON feed vypadat?#
Aby bylo možné nahrát URL feedu ve formátu JSON do Mergada, je potřeba, aby šlo o list (pole) objektů.
Ukázka připraveného a validního JSON pole se dvěma položkami:
[
{
"ITEM_ID": "342",
"AVAILABILITY": "preorder",
"URL": "https://wp533.mergadoshop.com/produkt/woocommerce-simple-product-test/",
"NAME_EXACT": "WooCommerce Simple product TEST",
"CURRENCY": "EUR",
"VAT": "21",
"PRICE": "0.068302",
"PRICE_VAT": "0.08",
"IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2020/06/tricko-nastvany-bily-tygr-white-edition.jpg",
"PARAM": [
{
"NAME": "Size",
"VALUE": "SM | S | M | L"
},
{
"NAME": "EAN",
"VALUE": "ean222"
},
{
"NAME": "Příušniče",
"VALUE": "Druhá vlastnost, žeřemě"
}
],
"STOCK_QUANTITY": "0",
"DESCRIPTION_SHORT": "[WCMC]",
"CATEGORY": "Polštáře",
"CATEGORY_ALTERNATIVE": [
"Nezařazené",
"Čaje, káva"
],
"PRODUCTNO": "SKU01-6",
"VISIBILITY": "public",
"CATALOG_VISIBILITY": "visible"
},
{
"ITEM_ID": "11089",
"AVAILABILITY": "in stock",
"URL": "https://wp533.mergadoshop.com/produkt/voyage-451-mikina-damska/?attribute_pa_barva=cerna&attribute_pa_varianta=xs",
"NAME_EXACT": "Voyage 451 Mikina dámská - černá, XS",
"CURRENCY": "EUR",
"VAT": "21",
"PRICE": "650",
"PRICE_VAT": "786.5",
"IMAGE": "https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg",
"PARAM": [
{
"NAME": "Barva",
"VALUE": "černá"
},
{
"NAME": "Varianta",
"VALUE": "XS"
}
],
"STOCK_QUANTITY": "156",
"DESCRIPTION": "lehce vypasovaný střih s bočními švy\ncelopropínací kovový zip\ntáhlo zipu s gravírovaným logem\nkapuce s podšívkou, na stažení šňůrkou\nvnitřní průkrčník začištěn páskou\nraglánové rukávy s ozdobným prošitím\nnakládané kapsy ve stylu klokanky\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\nkontrastní prvky\nvnitřní strana nepočesaná lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná",
"DESCRIPTION_SHORT": "Výplňková pletenina, vnitřní strana nepočesaná\n100 % bavlna (barva 12 - složení se může lišit - 85 % bavlna, 15 % viskóza)",
"CATEGORY": "Nezařazené",
"VISIBILITY": "public",
"CATALOG_VISIBILITY": "visible",
"IMAGE_ALTERNATIVE": [
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_cw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_aw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_01_bw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_cw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_aw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_02_bw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_cw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_aw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_12_bw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_cw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_aw600.jpg",
"https://wp533.mergadoshop.com/wp-content/uploads/2025/03/451_71_bw600.jpg"
],
"SHIPPING_WEIGHT": "500 g",
"ITEMGROUP_ID": "11088",
"VARIANT_DESCRIPTION": "lehce vypasovaný střih s bočními švy\\ncelopropínací kovový zip\\ntáhlo zipu s gravírovaným logem\\nkapuce s podšívkou, na stažení šňůrkou\\nvnitřní průkrčník začištěn páskou\\nraglánové rukávy s ozdobným prošitím\\nnakládané kapsy ve stylu klokanky\\ndolní lem a manžety rukávů z žebrového úpletu 2:2 s 5 % elastanu\\nkontrastní prvky\\nvnitřní strana nepočesaná"
}
]Příklady z praxe#
- Máte JSON od dodavatele a Mergado jej při vytváření projektu nenačte → zkontrolujte, zda jde o list objektů ve tvaru výše.
- Na výstupu z projektu potřebujete XML, ale váš JSON obsahuje názvy elementů, které nejsou validní pro XML (např. začínají číslem nebo obsahují mezery) → tyto elementy je potřeba v projektu skrýt, pokud je cílem výstup do XML.
Tipy#
- Nativní JSON formáty, které Mergado umí zpracovat (aktuálně pouze Shopify), nemusí výše uvedený formát splňovat.
- Potřebujete dostat jiný JSON (nebo obecně soubor) do požadované podoby listu objektů? Často to jde přes rozšíření Blending Bull.
- JSON může stejně jako CSV obsahovat nevalidní XML elementy – pokud míříte na XML výstup, skryjte je v projektu.
FAQ#
Lze v Mergadu použít JSON feed?#
Ano. Kromě XML a CSV podporuje Editor také JSON, TSV a TXT.
Co je nejčastější příčinou, když se JSON feed nenačte?#
Neodpovídající formát nebo obsah feedu.
Jak musí být JSON strukturovaný, aby šel nahrát?#
Jako list (pole) objektů: [ { …produkt_1… }, { …produkt_2… } ].
Platí uvedený formát i pro všechny „nativní“ JSONy?#
Ne. Nativní JSON formáty v Mergadu (aktuálně jen Shopify) ho nemusí splňovat.
Mám jiný JSON – jak jej převedu do požadované podoby?#
Často to lze pomocí rozšíření Blending Bull.
Co když JSON obsahuje názvy nevhodné pro XML?#
Pokud máte na výstupu XML, skryjte v projektu elementy, které jsou pro XML nevalidní (např. začínají číslem nebo obsahují mezery).