JSON у Mergado#
У Mergado найчастіше працюють із файлами XML і CSV. Але редактор приймає також JSON, TSV і TXT. Може статися, що постачальник надасть саме JSON-фід і вам потрібно завантажити його в Mergado. Якщо під час створення проєкту JSON не завантажується або повертає повідомлення про помилку, частою причиною буває неправильний формат чи вміст фіду.
Що таке JSON?#
JSON — це простий текстовий формат для обміну даними. Він зрозумілий для людини й водночас легко опрацьовується програмами. Це універсальна мова для передавання структурованих даних між системами.
Як має виглядати JSON-фід?#
Щоб можна було завантажити URL фіду у форматі JSON у Mergado, потрібно, щоб це був список (масив) об’єктів.
Приклад підготовленого й валідного JSON-масиву з двома позиціями:
[
{
"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á"
}
]Приклади з практики#
- У вас є JSON від постачальника, і Mergado не завантажує його під час створення проєкту → перевірте, чи це список об’єктів у вигляді, наведеному вище.
- На виході з проєкту вам потрібен XML, але ваш JSON містить назви елементів, які не є валідними для XML (наприклад, починаються з цифри або містять пробіли) → ці елементи потрібно в проєкті приховати, якщо метою є вихід у XML.
Поради#
- Нативні формати JSON, які Mergado вміє опрацьовувати (наразі лише Shopify), не обов’язково мають відповідати наведеному вище формату.
- Потрібно привести інший JSON (або загалом файл) до потрібного вигляду списку об’єктів? Часто це можна зробити за допомогою розширення Blending Bull.
- JSON, як і CSV, може містити невалідні XML-елементи – якщо ви плануєте вихід у XML, приховайте їх у проєкті.
Часті запитання#
Чи можна в Mergado використовувати JSON-фід?#
Так. Крім XML і CSV, редактор підтримує також JSON, TSV і TXT.
Що найчастіше спричиняє те, що JSON-фід не завантажується?#
Невідповідний формат або вміст фіду.
Якою має бути структура JSON, щоб його можна було завантажити?#
Список (масив) об’єктів: [ { …товар_1… }, { …товар_2… } ].
Чи стосується наведений формат також усіх «нативних» JSON?#
Ні. Нативні формати JSON у Mergado (наразі лише Shopify) не обов’язково мають йому відповідати.
У мене інший JSON – як привести його до потрібного вигляду?#
Часто це можна зробити за допомогою розширення Blending Bull.
Що робити, якщо JSON містить назви, непридатні для XML?#
Якщо на виході у вас XML, приховайте в проєкті елементи, які для XML невалідні (наприклад, починаються з цифри або містять пробіли).