JSON in Mergado#
In Mergado wird am häufigsten mit XML- und CSV-Dateien gearbeitet. Der Editor akzeptiert aber auch JSON, TSV und TXT. Es kann vorkommen, dass ein Lieferant Ihnen genau einen JSON-Feed bereitstellt und Sie diesen in Mergado hochladen müssen. Wenn beim Anlegen des Projekts der JSON-Feed nicht geladen wird oder eine Fehlermeldung zurückgibt, liegt die häufigste Ursache in einem falschen Format oder Inhalt des Feeds.
Was ist JSON?#
JSON ist ein einfaches Textformat zum Austausch von Daten. Es ist für Menschen verständlich und gleichzeitig einfach von Programmen zu verarbeiten. Es ist eine universelle Sprache zur Übergabe strukturierter Daten zwischen Systemen.
Wie muss ein JSON-Feed aussehen?#
Damit die URL eines JSON-Feeds in Mergado hochgeladen werden kann, muss es sich um eine Liste (ein Array) von Objekten handeln.
Beispiel eines vorbereiteten und gültigen JSON-Arrays mit zwei Einträgen:
[
{
"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á"
}
]Beispiele aus der Praxis#
- Sie haben JSON von einem Lieferanten und Mergado lädt es beim Erstellen des Projekts nicht → prüfen Sie, ob es sich um eine Liste von Objekten in der Form oben handelt.
- Sie benötigen im Projektoutput XML, aber Ihr JSON enthält Elementnamen, die für XML nicht gültig sind (z. B. beginnen mit einer Zahl oder enthalten Leerzeichen) → diese Elemente müssen im Projekt ausgeblendet werden, wenn das Ziel ein XML-Output ist.
Tipps#
- Native JSON-Formate, die Mergado verarbeiten kann (aktuell nur Shopify), müssen dem oben beschriebenen Format nicht entsprechen.
- Möchten Sie ein anderes JSON (oder allgemein eine Datei) in die geforderte Form einer Objektliste bringen? Das geht oft über die Erweiterung Blending Bull.
- JSON kann wie CSV ungültige XML-Elemente enthalten – zielen Sie auf einen XML-Output, blenden Sie diese im Projekt aus.
FAQ#
Kann in Mergado ein JSON-Feed verwendet werden?#
Ja. Neben XML und CSV unterstützt der Editor auch JSON, TSV und TXT.
Was ist die häufigste Ursache, wenn der JSON-Feed nicht geladen wird?#
Ein nicht passendes Format oder ein nicht passender Inhalt des Feeds.
Wie muss JSON strukturiert sein, damit es hochgeladen werden kann?#
Als Liste (Array) von Objekten: [ { …produkt_1… }, { …produkt_2… } ].
Gilt das angegebene Format auch für alle „nativen" JSONs?#
Nein. Native JSON-Formate in Mergado (aktuell nur Shopify) müssen es nicht erfüllen.
Ich habe ein anderes JSON – wie wandle ich es in die geforderte Form um?#
Oft geht das mithilfe der Erweiterung Blending Bull.
Was, wenn JSON Namen enthält, die für XML ungeeignet sind?#
Wenn Sie im Output XML haben, blenden Sie im Projekt die Elemente aus, die für XML ungültig sind (z. B. beginnen mit einer Zahl oder enthalten Leerzeichen).