Soubor JSON - jak má takový formát vypadat?
Vysvětlit, zda a jak lze v Mergado Editoru použít feed ve formátu JSON, jak má vypadat jeho základní struktura a na co si dát pozor při nahrávání.
Kontext
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?
Lehký textový formát pro výměnu dat. Je srozumitelný pro člověka a zároveň snadno zpracovatelný programy – „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ů, např.:
Jasně — tady je hezky zarovnané (a validní) JSON pole se dvěma položkami, připravené k vložení do Markdownu:
[
{
"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í (aktuálně jen 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).