Guide

Guide for furniture retailers – your products as 3D objects.

Finished pieces from your catalogue (sideboards, sofas, tables, beds, lamps…) are placed by the customer in a 3D room, walked around and sent to you as a quote request with a cart. This guide goes from the invitation through model preparation and import to setting up your shop. Decors, floors and tiles have their own guide.

1. What you get

  • Your own shop – a 3D configurator with your catalogue (brand → category), prices, variants and a cart; the customer sees only your products, no third-party furniture.
  • A hosted page app.getfittle.com/s/your-company and the embed code for the configurator on your website or e-shop (iframe/script with your key, bound to your domain).
  • Quote requests with the cart (codes, variants, quantities, prices) to your e-mail, to the request list in your account and via webhook or API into your own system.
  • Portal, e-mails, invoices and this guide in your language.

Cooperation with furniture retailers is individual (number of products, number of requests, integration). It starts with a 30-day free trial with your own catalogue – we send the invitation by e-mail; if you do not have one yet, write to info@softverova-agentura.sk (company name, contact, language).

2. Signing in with the invitation

  1. Open the link from our invitation (of the form app.getfittle.com/login/?invite=…). The link is valid for 60 days and meant for your company.
  2. Enter your e-mail (we send a link) and confirm. If the invitation was bound to a specific address, sign in with it.
  3. On first sign-in everything is created automatically: account, supplier profile with 3D objects enabled and a trial shop with a key, hosted page and prices switched on. Nothing to fill in; we redirect you straight to the import.
  4. In the portal (app.getfittle.com/supplier/) the top card Trial shop has buttons: hosted page, configurator, shop settings (requests, key for your website). In Profile and billing details add company, address, country, company ID and VAT ID – they go on invoices.
Two accounts in one. You have the supplier role (catalogue, import) and the carpenter role (shop: requests, webhook, key, hosted page). Switch between them with the links in the portal header; both are under the same sign-in.

3. Preparing 3D models

The configurator displays .glb (recommended), .gltf, .kmz, .dae or .obj. SketchUp .skp files cannot be shown in a browser – they must be exported.

From SketchUp

  • One by one: File → Export → 3D Model → format glb (or kmz / dae).
  • In bulk: install our plugin fittle_convert.rb (Window → Extension Manager → Install Extension), then Extensions → Fittle → Convert catalogue and pick the folder with models laid out as CODE/model.skp. For every model the plugin writes model.glb, image.jpg, thumb.jpg and fills the size into product.json; the original .skp files stay.

Rules

  • File size max 8 MB per model (at import). Reduce polygons (hidden interiors, fittings and screws are not needed) and textures (max 1,024 px; larger ones are shrunk by the configurator).
  • A model is one piece of furniture in real proportions; the configurator scales it to the W × D × H size in cm that you enter – that size is also binding in the quote request.
  • Model origin on the floor in the centre of the footprint, front side facing forward. In the room the object is placed at a wall: wall, position along the wall, distance from the wall and rotation (0/90/180/270°).
  • Embed materials and textures in the file (glb carries them inside; with .obj textures do not load even with an .mtl – prefer glb).
  • The catalogue preview is a separate image (photo or render, PNG/JPG/WEBP up to 4 MB at import).

4. The catalogue as a ZIP

You upload the catalogue in bulk via Import in the portal. The archive has one folder per product, folder name = your code (SKU):

catalog.csv                  optional bulk price list
      OAK-SB-120/                  folder = product code
        product.json               names per language, category, size, price, variants
        model.glb                  3D model
        image.jpg                  catalogue preview
        thumb.jpg                  optional small panel thumbnail
        variants/WHITE.jpg         optional variant images (name = variant code)
      OAK-SB-160/
        …

A minimal product.json for furniture:

{
        "kind": "model",
        "name": { "en": "Oak sideboard 120", "de": "Kommode Eiche 120", "sk": "Komoda Dub 120" },
        "category": "Sideboards",
        "size_cm": { "w": 120, "d": 42, "h": 78 },
        "price": 349.00, "currency": "EUR", "vat": 0.23, "price_includes_vat": true,
        "url": "https://www.your-shop.com/oak-sideboard-120",
        "variants": [
          { "sku": "WHITE", "name": { "en": "white" }, "price": 369.00 },
          { "sku": "BLACK", "name": { "en": "black" }, "price": 369.00 }
        ]
      }
  • Names per language: the customer sees the name in their language; a missing language falls back to English, then to the first available. Your language + English is enough.
  • Category forms the drop-down in the configurator (Sideboards, Sofas, Tables…) – use it consistently.
  • Price is per unit; url links to the product in your e-shop (the "Order" button). Variants have their own code, name, price, optionally a link and an image.
  • Details of all fields, catalog.csv and the error messages are in the import guide (technical specification: IMPORT.md).

5. Import and check

  1. In the portal → Bulk import (ZIP) pick the archive and click Dry run (no writes). Nothing is saved; for every product you get a line will be created / updated / skipped / error with the reason (model missing, model over 8 MB, size missing, .skp instead of an export, invalid JSON…).
  2. Fix the errors in the archive and click Import. Large archives (up to 5 GB, up to 5,000 items) are uploaded in parts and processed in the background – keep the page open, progress shows in the log.
  3. Items are not approved by hand – in the trial they are in your shop within minutes. Only your shop sees them.
  4. The same code = an update (new price, name, model), not a duplicate. Undo a mistake with the Roll back button next to the latest import in the history.

6. Your shop and the customer

What the customer sees

  • They open the hosted page or the configurator on your website. They enter the room size (also an L-shape, windows and doors, the floor), in the 3D objects section pick your brand and a category and place products in the room; they can rotate them, move them along and away from the wall, change variant and quantity.
  • They see prices and the cart total (prices are on only in retailers' shops; carpenters never see prices). They can walk through the room in first person and on a phone show the furniture in AR in their own room.
  • They send a quote request: contact, note, optionally a photo; the request lists the products with codes, variants, quantities and prices + a link to the 3D preview.

Where the requests go

  • By e-mail to the shop address (and further addresses you set), to the Requests list in your account with a 3D preview.
  • Webhook: in the shop settings enter a URL and a secret; we post every request as signed JSON (HMAC) to your CRM/e-shop. An API key lets you read requests and designs. Details in the user guide.

Embedding on your website

The shop settings show your key FITT-XXXX-XXXX-XXXX and a ready snippet. Embedding in WordPress, Shopify, Wix or plain HTML is described in the installation guide. The key is bound to your domain – set it in your account.

7. After the trial

The trial lasts 30 days (the date is shown in the Trial shop card). We write to you before it ends; continuation is an individual offer based on the number of products and requests – per-request billing or a monthly package. Invoices are sent automatically as PDF (immediately for card payments, monthly with a due date for per-request billing) and are also in the portal card Invoices; VAT follows your country and VAT ID (reverse charge for EU companies with a valid VAT ID).

8. Support

Write to info@softverova-agentura.sk or reply to our invitation. For an import problem attach the dry-run log; for a model problem attach the file (glb) – we will look at it.