Príručka

Príručka pre predajcov nábytku – vaše produkty ako 3D objekty.

Hotové kusy nábytku z vášho katalógu (komody, sedačky, stoly, postele, svietidlá…) si zákazník položí do 3D izby, prejde sa okolo nich a pošle vám dopyt s košíkom. Táto príručka vedie od pozvánky cez prípravu modelov a import až po nastavenie vašej predajne. Dekory, podlahy a dlaždice majú vlastnú príručku.

1. Čo dostanete

  • Vlastnú predajňu – 3D konfigurátor s vaším katalógom (značka → kategória), cenami, variantmi a košíkom; zákazník vidí len vaše produkty, nie cudzí nábytok.
  • Hostovanú stránku app.getfittle.com/s/vasa-firma a kód na vloženie konfigurátora do vášho webu alebo e-shopu (iframe/skript s vaším kľúčom, viazaný na vašu doménu).
  • Dopyty s košíkom (kódy, varianty, množstvo, ceny) na váš e-mail, do zoznamu dopytov v účte a cez webhook alebo API do vášho systému.
  • Portál, e-maily, faktúry aj táto príručka vo vašom jazyku.

Spolupráca s predajcami nábytku je individuálna (počet produktov, počet dopytov, integrácia). Začína sa skúšobným prístupom na 30 dní zadarmo s vaším vlastným katalógom – pozvánku vám pošleme e-mailom; ak ju ešte nemáte, napíšte nám na info@softverova-agentura.sk (názov firmy, kontakt, jazyk).

2. Prihlásenie pozvánkou

  1. Otvorte odkaz z našej pozvánky (tvar app.getfittle.com/login/?invite=…). Odkaz platí 60 dní a je určený vašej firme.
  2. Zadajte e-mail (pošleme odkaz) a potvrďte. Ak bola pozvánka viazaná na konkrétnu adresu, prihláste sa ňou.
  3. Pri prvom prihlásení vznikne všetko samo: účet, profil dodávateľa s povolenými 3D objektmi a skúšobná predajňa s kľúčom, hostovanou stránkou a zapnutými cenami. Nič nevypĺňate; presmerujeme vás rovno na import.
  4. V portáli (app.getfittle.com/supplier/) je hore karta Skúšobná predajňa s tlačidlami: hostovaná stránka, konfigurátor, nastavenia predajne (dopyty, kľúč pre web). V karte Profil a fakturačné údaje doplňte firmu, adresu, krajinu, IČO a IČ DPH – budú na faktúrach.
Dva účty v jednom. Máte rolu dodávateľ (katalóg, import) aj stolár (predajňa: dopyty, webhook, kľúč, hostovaná stránka). Medzi nimi prepínate odkazmi v hlavičke portálu; obe sú pod tým istým prihlásením.

3. Príprava 3D modelov

Konfigurátor zobrazí .glb (odporúčané), .gltf, .kmz, .dae alebo .obj. Súbory .skp zo SketchUpu prehliadač nezobrazí – treba ich exportovať.

Zo SketchUpu

  • Jednotlivo: File → Export → 3D Model → formát glb (alebo kmz / dae).
  • Hromadne: nainštalujte náš plugin fittle_convert.rb (Window → Extension Manager → Install Extension), potom Extensions → Fittle → Convert catalogue a vyberte priečinok s modelmi v tvare KÓD/model.skp. Plugin ku každému modelu vytvorí model.glb, image.jpg, thumb.jpg a doplní rozmer do product.json; pôvodné .skp ostávajú.

Pravidlá

  • Veľkosť súboru max 8 MB na model (pri importe). Zmenšujte polygóny (skryté vnútro, spojovací materiál a skrutky netreba) a textúry (max 1 024 px; väčšie konfigurátor zmenší sám).
  • Model je jeden kus nábytku v reálnych proporciách; konfigurátor ho škáluje na rozmer š × h × v v cm, ktorý zadáte – ten je záväzný aj v dopyte.
  • Pôvod modelu na podlahe v strede pôdorysu, predná strana dopredu. V izbe sa objekt umiestňuje pri stene: stena, poloha pozdĺž steny, odstup od steny a otočenie (0/90/180/270°).
  • Materiály a textúry vložte do súboru (glb ich nesie v sebe; pri .obj priložte .mtl a textúry sa nenačítajú – radšej glb).
  • Náhľad do katalógu je samostatný obrázok (fotka alebo render, PNG/JPG/WEBP do 4 MB pri importe).

4. Katalóg ako ZIP

Katalóg nahrávate hromadne cez Import v portáli. Archív má jeden priečinok na produkt, názov priečinka = váš kód (SKU):

catalog.csv                  voliteľný hromadný cenník
      KOM-DUB-120/                 priečinok = kód produktu
        product.json               názvy v jazykoch, kategória, rozmer, cena, varianty
        model.glb                  3D model
        image.jpg                  náhľad do katalógu
        thumb.jpg                  voliteľný malý náhľad do panela
        variants/BIELA.jpg         voliteľné obrázky variantov (názov = kód variantu)
      KOM-DUB-160/
        …

Minimálny product.json pre nábytok:

{
        "kind": "model",
        "name": { "sk": "Komoda Dub 120", "en": "Oak sideboard 120", "de": "Kommode Eiche 120" },
        "category": "Komody",
        "size_cm": { "w": 120, "d": 42, "h": 78 },
        "price": 349.00, "currency": "EUR", "vat": 0.23, "price_includes_vat": true,
        "url": "https://www.vas-eshop.sk/komoda-dub-120",
        "variants": [
          { "sku": "BIELA", "name": { "sk": "biela" }, "price": 369.00 },
          { "sku": "CIERNA", "name": { "sk": "čierna" }, "price": 369.00 }
        ]
      }
  • Názvy v jazykoch: zákazník vidí názov vo svojom jazyku; chýbajúci jazyk padne na angličtinu, potom na prvý dostupný. Stačí váš jazyk + angličtina.
  • Kategória tvorí rozbaľovací zoznam v konfigurátore (Komody, Sedačky, Stoly…) – používajte ju konzistentne.
  • Cena je jednotková; url je odkaz na produkt vo vašom e-shope (tlačidlo „Objednať“). Varianty majú vlastný kód, názov, cenu, prípadne odkaz a obrázok.
  • Podrobnosti všetkých polí, catalog.csv a chybové hlásenia sú v príručke k importu (technická špecifikácia v angličtine: IMPORT.md).

5. Import a kontrola

  1. V portáli → Hromadný import (ZIP) vyberte archív a kliknite Skúšobne (bez zápisu). Nič sa neuloží; ku každému produktu dostanete riadok vytvorí sa / aktualizuje sa / preskočí / chyba s dôvodom (chýba model, model nad 8 MB, chýba rozmer, .skp namiesto exportu, neplatný JSON…).
  2. Opravte chyby v archíve a spustite Importovať. Veľké archívy (do 5 GB, do 5 000 položiek) sa nahrávajú po častiach a spracúvajú na pozadí – stránku nechajte otvorenú, priebeh vidíte v logu.
  3. Položky sa neschvaľujú ručne – v skúšobnom prístupe sú v predajni do niekoľkých minút. Vidí ich len vaša predajňa.
  4. Rovnaký kód = aktualizácia (nová cena, názov, model), nie duplicita. Chybu vrátite tlačidlom Vrátiť pri poslednom importe v histórii.

6. Vaša predajňa a zákazník

Čo vidí zákazník

  • Otvorí hostovanú stránku alebo konfigurátor na vašom webe. Zadá rozmery izby (aj tvar L, okná a dvere, podlahu), v sekcii 3D objekty vyberie vašu značku a kategóriu a produkty položí do izby; môže ich otáčať, posúvať pozdĺž steny a od steny, meniť variant a množstvo.
  • Vidí ceny a súčet košíka (ceny sú zapnuté len v predajniach predajcov; stolári ceny nevidia). Môže sa po izbe prejsť v prvej osobe a na mobile si nábytok zobraziť v AR vo vlastnej izbe.
  • Pošle dopyt: kontakt, poznámka, prípadne fotka; v dopyte je zoznam produktov s kódmi, variantmi, množstvom a cenami + odkaz na 3D náhľad.

Kam idú dopyty

  • E-mailom na adresu predajne (a ďalšie adresy, ktoré nastavíte), do zoznamu Dopyty v účte s 3D náhľadom.
  • Webhook: v nastaveniach predajne zadáte URL a tajný kľúč; každý dopyt pošleme ako JSON s podpisom (HMAC) do vášho CRM/e-shopu. API kľúč umožňuje dopyty a návrhy čítať. Podrobnosti v príručke používateľa.

Vloženie na web

V nastaveniach predajne je váš kľúč FITT-XXXX-XXXX-XXXX a hotový úryvok. Vloženie do WordPressu, Shopify, Wixu alebo vlastného HTML popisuje návod na inštaláciu. Kľúč je viazaný na vašu doménu – v účte si ju nastavte.

7. Po skúšobnom období

Skúšobný prístup trvá 30 dní (termín vidíte v karte Skúšobná predajňa). Pred koncom vám napíšeme; pokračovanie je individuálna ponuka podľa počtu produktov a dopytov – účtovanie za dopyt alebo mesačný balík. Faktúry chodia automaticky v PDF (pri platbe kartou hneď, pri účtovaní za dopyt mesačne so splatnosťou) a sú aj v portáli v karte Faktúry; DPH podľa vašej krajiny a IČ DPH (prenesenie daňovej povinnosti pre firmy v EÚ s platným IČ DPH).

8. Podpora

Napíšte na info@softverova-agentura.sk alebo odpovedzte na našu pozvánku. K problému s importom priložte log zo skúšobného behu; k problému s modelom priložte súbor (glb) – pozrieme ho.

Ďalšie príručky