JSON a Mergadóban#
Ez a cikk bemutatja, hogyan használhatsz JSON formátumú feedet a Mergado Editorban, milyen legyen az alapstruktúrája, és mire figyelj a betöltésnél.
Kontextus#
A Mergadóban leggyakrabban XML és CSV fájlokkal dolgozol. Az Editor azonban JSON, TSV és TXT fájlokat is elfogad. Előfordulhat, hogy a beszállítód éppen JSON feedet biztosít, és azt kell betöltened a Mergadóba. Ha a Projekt létrehozásakor a JSON nem töltődik be, vagy hibaüzenetet kapsz, ennek oka általában a feed helytelen formátuma vagy tartalma.
Mi az a JSON? Könnyűsúlyú szöveges adatcsere-formátum. Ember számára is érthető, és a programok is könnyen feldolgozzák – „univerzális nyelv strukturált adatok átadására" rendszerek között.
A JSON feed elvárt szerkezete#
Ahhoz, hogy JSON formátumú feed URL-jét be lehessen tölteni a Mergadóba, objektumok listájának (tömbjének) kell lennie, pl.:
[
{
"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éldák a gyakorlatból#
- Van egy JSON a beszállítódtól, és a Mergado nem tölti be a Projekt létrehozásakor → ellenőrizd, hogy objektumok listája formátumban van-e a fenti minta szerint.
- A Projekt kimenetén XML-t szeretnél, de a JSON-od olyan Elem-neveket tartalmaz, amelyek XML-ben nem érvényesek (pl. számmal kezdődnek vagy szóközt tartalmaznak) → ezeket az Elemeket a Projektben el kell rejtened, ha XML kimenetet szeretnél.
Tippek#
- A natív JSON formátumoknak, amelyeket a Mergado ismer (jelenleg csak Shopify), nem kell megfelelniük a fenti formátumnak.
- Más JSON-t (vagy általában fájlt) kell az objektumlista formátumra hoznod? Gyakran megoldható a Blending Bull Bővítménnyel.
- A JSON – akárcsak a CSV – tartalmazhat érvénytelen XML Elemeket – ha XML kimenetre törekszel, rejtsd el őket a Projektben.
GYIK#
Használhatok JSON feedet a Mergadóban? Igen. Az XML és CSV mellett az Editor JSON, TSV és TXT fájlokat is támogat.
Mi a leggyakoribb oka, ha a JSON feed nem töltődik be? A feed nem megfelelő formátuma vagy tartalma.
Hogyan kell strukturálva lennie a JSON-nak, hogy betölthető legyen?
Objektumok listájaként (tömbjeként): [ { ...termek_1... }, { ...termek_2... } ].
A megadott formátum érvényes minden “natív” JSON-ra? Nem. A Mergado natív JSON formátumainak (jelenleg csak Shopify) nem kell megfelelniük.
Más JSON-om van – hogyan alakítsam át a szükséges formátumra? Gyakran megoldható a Blending Bull Bővítménnyel.
Mi van, ha a JSON olyan neveket tartalmaz, amelyek XML-ben nem érvényesek? Ha a kimeneted XML, rejtsd el a Projektben az XML szempontjából érvénytelen Elemeket (pl. számmal kezdődnek vagy szóközt tartalmaznak).