Hromadný import katalógu zo ZIP archívu.

1. Princíp

• Import spúšťate v portáli dodávateľa (app.getfittle.com/supplier/) v karte Hromadný import (ZIP).
• Kód položky (SKU) je kľúč. Rovnaký kód vo vašom účte = aktualizácia existujúcej položky (cena, názov, obrázok, model), nie duplicita. Obrázok alebo model, ktorý v archíve chýba, ostáva pôvodný.
• Vždy najprv Skúšobne (bez zápisu): dostanete riadok ku každej položke a nič sa neuloží. Potom Importovať.
• Nové položky dekorov idú na schválenie; zmena schválenej položky ju vráti na schválenie. Predajcovia nábytku so skúšobným prístupom majú schvaľovanie automatické.
• Limity: 5 000 položiek a 5 GB na archív; obrázok do 4 MB, náhľad do 256 kB, model do 8 MB, obrázok variantu do 1 MB. Archív sa nahráva po 50 MB častiach a spracúva na pozadí – veľký archív trvá aj desiatky minút; stránku nechajte otvorenú, priebeh vidíte v logu. Dočasný ZIP sa po importe zmaže, v úložisku ostávajú len rozbalené obrázky a modely.

2. Štruktúra archívu

Jeden priečinok na položku, názov priečinka = kód (písmená, číslice, . _ -, max 40 znakov). Archív môže mať jeden spoločný koreňový priečinok (Windows „Odoslať → Komprimovaný priečinok“ ho vytvorí).

catalog.csv                  voliteľný hromadný cenník (Excel) – prepisuje product.json
      DUB-HALIFAX/                 priečinok = kód
        product.json               polia položky (kapitola 3)
        image.jpg                  dekor: textúra; objekt: náhľad – png/jpg/webp, max 4 MB
        thumb.jpg                  voliteľný náhľad do panela (≈160 px, max 256 kB)
        model.glb                  len 3D objekt: .glb / .gltf / .kmz / .dae / .obj, max 8 MB
        variants/BIELA.jpg         voliteľné obrázky variantov (názov = kód variantu, max 1 MB)
      KOM-DUB-120/
        …

Plochý archív pre dekory

Dekory bez modelov a variantov nepotrebujú priečinky: catalog.csv + obrázky pomenované kódom (DUB-HALIFAX.jpg, DUB-HALIFAX.webp…). Kód v CSV a názov súboru sa musia zhodovať.

3. product.json

{
        "kind": "model",
        "name": { "en": "Oak sideboard 120", "de": "Kommode Eiche 120", "sk": "Komoda Dub 120" },
        "description": { "en": "Solid oak, 3 drawers, soft close." },
        "category": "Sideboards",
        "size_cm": { "w": 120, "d": 42, "h": 78 },
        "price": 349.00, "currency": "EUR", "vat": 0.23, "price_includes_vat": true, "unit": "ks",
        "url": "https://shop.example/oak-sideboard-120",
        "tags": ["living room", "solid wood"],
        "variants": [
          { "sku": "WHITE", "name": { "en": "white" }, "price": 369.00 },
          { "sku": "BLACK", "name": { "en": "black" }, "price": 369.00, "url": "https://shop.example/oak-sideboard-120-black" }
        ]
      }

Ceny sa zobrazujú len v konfigurátoroch predajcov so zapnutým cenovým režimom; stolári ceny nikdy nevidia.

4. catalog.csv

Hlavička v prvom riadku, oddeľovač , alebo ;, kódovanie UTF-8 (v Exceli „CSV UTF-8“). Stĺpce sú voliteľné okrem sku:

sku;kind;name_en;name_de;name_sk;desc_en;category;finish;hex;price;currency;vat;unit;url;w;d;h;tile_w;tile_h;tags
      OAK-SB-120;model;Oak sideboard 120;Kommode Eiche 120;Komoda Dub 120;Solid oak;Sideboards;;;349;EUR;0.23;ks;https://shop.example/sb120;120;42;78;;;living room|solid wood
      OAK-HALIFAX;decor;Halifax oak;;Dub Halifax;;Light wood;wood;#C9A87C;;;;;;;;;;;

• Hodnota z CSV prepisuje product.json – CSV sa hodí na mesačnú aktualizáciu cien z vášho systému bez opätovného posielania modelov.
• Riadok bez priečinka a súborov aktualizuje existujúcu položku (napr. len cenu); nová položka potrebuje aj obrázok.
• Názvy v jazykoch: stĺpce name_xx; značky (tags) oddeľujte zvislou čiarou |.

5. Priebeh importu

1. Vyberte archív a kliknite Skúšobne (bez zápisu). Archív sa nahrá a skontroluje; výsledok je tabuľka: vytvorí sa / aktualizuje sa / preskočené / chyba + dôvod. Nič sa nezapíše.
2. Opravte chyby (kapitola 6) a kliknite Importovať. Nahrávanie a spracovanie beží na pozadí; pri každom produkte pribudne riadok v logu. Log sa dá stiahnuť.
3. Po importe: nové dekory čakajú na schválenie (portál ich ukáže ako čaká na schválenie), aktualizované položky so zmeneným názvom/obrázkom tiež; predajcovia so skúšobným prístupom vidia položky v predajni do niekoľkých minút.
4. História importov pod formulárom ukazuje každý beh (skúšobný aj ostrý) so súhrnom a logom.

6. Čo sa kontroluje (dôvody v logu)

• chýba názov / obrázok / model / rozmer podľa typu položky,
• obrázok nad 4 MB, náhľad nad 256 kB, model nad 8 MB, .skp namiesto exportu,
• neplatný JSON, neznámy kind, finish mimo wood/matt/gloss, hex nie je #RRGGBB,
• cena nie je číslo, mena nie je 3-písmenový kód, DPH mimo 0–1, jednotka mimo ks/m2/bm,
• variant bez sku, obrázok variantu bez zodpovedajúceho variantu v JSON,
• súbory mimo štruktúry sa ignorujú (v logu ako „preskočené“).

7. Vrátenie importu

Omyl (zlý cenník, zlé modely)? V histórii importov má posledný ostrý import tlačidlo Vrátiť: položky, ktoré import vytvoril, sa zmažú aj so súbormi; položky, ktoré zmenil, dostanú späť predchádzajúce údaje, obrázky a modely (súbory sú verziované, staršie verzie sa uchovávajú 30 dní). Vrátiť sa dá len posledný ostrý import – ak ste odvtedy importovali znova, najprv vráťte ten novší. Skúšobné behy netreba vracať.

Ďalšie príručky

• Príručka pre dodávateľov dekorov – registrácia, ručné pridanie dekoru, schválenie, predplatné.
• Príručka pre predajcov nábytku – pozvánka, modely zo SketchUpu, predajňa s košíkom.
• Príručka používateľa – konfigurátor z pohľadu stolára a zákazníka.