JSON v Mergade#
V Mergade sa najčastejšie pracuje so súbormi XML a CSV. Editor ale prijíma tiež JSON, TSV a TXT. Môže sa stať, že dodávateľ poskytne práve JSON feed a vy ho potrebujete nahrať do Mergada. Ak sa pri zakladaní projektu JSON nenačíta alebo vráti chybovú hlášku, býva častou príčinou nesprávny formát či obsah feedu.
Čo je JSON?#
JSON je jednoduchý textový formát pre výmenu dát. Je zrozumiteľný pre človeka a zároveň ľahko spracovateľný programami. Je to univerzálny jazyk pre predávanie štruktúrovaných dát medzi systémami.
Ako má JSON feed vyzerať?#
Aby bolo možné nahrať URL feedu vo formáte JSON do Mergada, je potrebné, aby šlo o list (pole) objektov.
Ukážka pripraveného a validného JSON polia s dvoma 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á"
}
]Príklady z praxe#
- Máte JSON od dodávateľa a Mergado ho pri vytváraní projektu nenačíta → skontrolujte, či ide o list objektov v tvare vyššie.
- Na výstupe z projektu potrebujete XML, ale váš JSON obsahuje názvy elementov, ktoré nie sú validné pre XML (napr. začínajú číslom alebo obsahujú medzery) → tieto elementy je potrebné v projekte skryť, ak je cieľom výstup do XML.
Tipy#
- Natívne JSON formáty, ktoré Mergado vie spracovať (aktuálne iba Shopify), nemusia vyššie uvedený formát spĺňať.
- Potrebujete dostať iný JSON (alebo všeobecne súbor) do požadovanej podoby listu objektov? Často to ide cez rozšírenie Blending Bull.
- JSON môže rovnako ako CSV obsahovať nevalidné XML elementy – ak mierite na XML výstup, skryte ich v projekte.
FAQ#
Dá sa v Mergade použiť JSON feed?#
Áno. Okrem XML a CSV podporuje Editor tiež JSON, TSV a TXT.
Čo je najčastejšia príčina, keď sa JSON feed nenačíta?#
Nezodpovedajúci formát alebo obsah feedu.
Ako musí byť JSON štruktúrovaný, aby sa dal nahrať?#
Ako list (pole) objektov: [ { …produkt_1… }, { …produkt_2… } ].
Platí uvedený formát aj pre všetky „nativné“ JSONy?#
Nie. Natívne JSON formáty v Mergade (aktuálne len Shopify) ho nemusia spĺňať.
Mám iný JSON – ako ho prevediem do požadovanej podoby?#
Často to možno pomocou rozšírenia Blending Bull.
Čo keď JSON obsahuje názvy nevhodné pre XML?#
Ak máte na výstupe XML, skryte v projekte elementy, ktoré sú pre XML nevalidné (napr. začínajú číslom alebo obsahujú medzery).