Hromadný import katalógu zo ZIP archívu

1. Princíp

Import spúšťate v portáli dodávateľa (app.furniconf.com/supplier/) v karte Hromadný import (ZIP) – sú tam samostatné tlačidlá Import dekorov · Import nábytku (3D objekty) · Import podláh · Import dlažby · Import obkladu, každé s popisom a ukážkou archívu. Tlačidlo určuje druh položiek, kind v súboroch netreba (ak nesúhlasí, položka skončí chybou). Dlažba sa ponúkne len na podlahe, obklad len na stenách.
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ť.

SketchUp. Súbor .skp prehliadač nezobrazí a import ho odmietne. Exportujte File → Export → 3D Model → glb (alebo kmz / dae), alebo použite plugin furniconf_convert.rb (Window → Extension Manager → Install Extension → Extensions → Fittle → Convert catalogue): z priečinka KÓD/model.skp vytvorí model.glb, image.jpg, thumb.jpg a rozmer do product.json. Modely nad 8 MB zmenšite (menej polygónov, textúry max 1 024 px).

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" }
  ]
}

Pole	Typ	Povinné	Poznámka
`kind`	`decor` / `floor` / `tile` / `model`	nie	bez `kind`: je súbor modelu → `model`, inak `decor`
`name`	text alebo `{jazyk: text}`	áno (nová položka)	24 jazykov EÚ (`en`, `de`, `sk`, `cs`, `pl`, `hu`…); chýbajúci jazyk → `en` → prvý dostupný
`description`	text alebo `{jazyk: text}`	nie	max 1 000 znakov
`category`	text	nie	napr. „Drevo · svetlé“, „Komody“ – kategórie tvoria rozbaľovací zoznam v konfigurátore, používajte rovnaký zápis
`finish`	`wood` / `matt` / `gloss`	nie	dekory: povrch (predvolené `wood`)
`hex`	`#RRGGBB`	nie	priemerná farba dekoru (náhrada, kým sa načíta obrázok)
`size_cm`	`{w, d, h}`	áno pre `model`	rozmer objektu š × h × v v cm – model sa naň škáluje
`tile_cm`	`{w, h}`	áno pre `tile`	rozmer jednej dlaždice v cm
`use`	`floor` / `wall` / `both`	nie (`tile`)	dlažba na podlahu / obklad na stenu / oboje – tlačidlá Import dlažby a Import obkladu to nastavia samy
`price`	číslo	nie	jednotková cena; `unit` = `ks`, `m2`, `bm` (bežný meter), `bal` (balenie)
`plank_cm`	`{w, h}`	nie (`floor`)	rozmer lamely v cm (dĺžka × šírka) – podlaha sa počíta po kusoch podľa pravidiel pokládky (nižšie)
`pack_m2`	číslo	nie (`floor`, `tile`)	m² v balení, napr. `2.4` – košík zaokrúhli na celé balenia
`pack_pcs`	celé číslo	nie (`floor`, `tile`)	kusov v balení (namiesto `pack_m2`)
`currency`	`EUR`…	nie	predvolené EUR
`vat`	0–1	nie	sadzba DPH, napr. `0.23`
`price_includes_vat`	true/false	nie	predvolené true (cena s DPH)
`url`	https odkaz	nie	stránka produktu vo vašom e-shope („Objednať“)
`tags`	pole textov	nie	max 20
`variants`	pole	nie	max 50; každý `sku` (povinné), `name`, `price`, `url`; obrázok = `variants/<sku>.jpg`

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

Podlahy, dlažba a obklad – plocha, balenia a cena

Zákazník zadá rozmery izby, vyberie podlahu, dlažbu alebo obklad a v košíku vidí potrebnú plochu, počet balení a cenu:

Dlažba a obklad. Plánovač položí dlaždice po kusoch (vzor, špára, okná a dvere; odrezok sa použije, kde sa zmestí) → počet kusov a m² dlaždíc.
Podlaha z lamiel (plank_cm). Simuluje sa skutočná pokládka: lamely pozdĺžne k oknu (bez okna pozdĺž dlhšej strany), dilatačná škára 10 mm pri stenách, koncový kus radu aspoň 20 cm, spoje susedných radov odsadené aspoň 40 cm, posledný rad rezaný pozdĺžne (pásy sú odpad). Lamela sa klikom zasúva len z jednej strany, preto sa odrezok z konca radu nedá použiť hocikde – iba ako začiatok ďalšieho radu, rezaným koncom k stene. Odpad vzniká z týchto pravidiel, žiadna percentuálna rezerva sa nepripočítava. Podlaha bez plank_cm: plocha izby.
Balenia. pack_m2: balenia = plocha ÷ m² v balení, zaokrúhlené nahor; pack_pcs: kusy ÷ ks v balení. Bez balenia sa účtuje presná plocha alebo kusy.
Cena podľa unit. m2: zaplatené m² celých balení × cena; bal: balenia × cena za balenie; ks: kusy × cena.

Príklad. Izba 4 × 3 m, laminát 120 × 20 cm, balenie 2,4 m², 19,90 €/m² → 15 radov po 3,98 m → 57 lamiel = 13,68 m² (plocha 12,0 m², odpad ≈ 12 %) → 6 balení (14,4 m²) → 286,56 €. Dlažba 60 × 60 cm, špára 3 mm, 4 ks v balení, 28 €/balenie → 35 dlaždíc → 9 balení → 252 €. V dopyte je pri riadku počet balení, m² a cena.

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

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.
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ť.
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.
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/bal, bal bez pack_m2/pack_pcs,
variant bez sku, obrázok variantu bez zodpovedajúceho variantu v JSON,
súbory mimo štruktúry sa ignorujú (v logu ako „preskočené“).

Typické chyby. Kód v CSV nesedí s názvom priečinka/obrázka (veľké/malé písmená, medzera); Excel uložil CSV v inom kódovaní (diakritika rozbitá – uložte ako „CSV UTF-8“); JSON s koncovou čiarkou alebo úvodzovkami „“ namiesto ""; model uložený ako .skp; textúry vo vedľajšom priečinku pri .obj (použite glb).

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.

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

1. Princíp

2. Štruktúra archívu

Plochý archív pre dekory

3. product.json

Podlahy, dlažba a obklad – plocha, balenia a cena

4. catalog.csv

5. Priebeh importu

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

7. Vrátenie importu

Ďalšie príručky