3DQuoteX Logo 3DQuoteX
Login

Documentation

3DQuoteX – Integration & Feature Guide

Alles, was du für Setup, Betrieb und die tägliche Nutzung brauchst – inkl. mehrsprachiger UI, Shopify-Anbindung, Stripe-Abrechnung und Bestellarchiv.

Impressum Datenschutz

1. Einrichtung

  1. Stripe-Abo abschließen: Wähle dein Paket direkt auf der Startseite im Stripe Pricing Table.
  2. Konto anlegen & einloggen: Nach Abschluss registrierst du dich in 3DQuoteX und meldest dich an.
  3. Shopify Custom App: Erstelle in Shopify eine Custom App mit write_draft_orders. Hinterlege API Key und Admin API Access Token im Dashboard.
  4. Theme-Button: Verlinke im Produkt-Template auf https://3dquotex.st-braun.de/client?shop={{ shop.permanent_domain }}.
  5. Slicer-Profil & Preise: Lade deine config.ini hoch, pflege Filamente mit Preis pro kg, Farben und Layer Heights.

2. Funktionsumfang

  • Dateiupload & Analyse: Kunden laden STL/3MF hoch. 3DQuoteX liest Druckzeit, Filamentverbrauch und berechnet Material-, Energie- und Maschinenkosten.
  • Materialverwaltung: Filamente werden als Liste gepflegt, inkl. Preis pro kg und optionaler Dichte.
  • Farben & Schichthöhen: Beliebig viele Farben und Layer Heights per Klick hinzufügen.
  • Zweisprachige UI: Alle Kundenseiten und das Marketing sind in Deutsch & Englisch abrufbar.
  • Shopify Draft Orders: Line Item Properties enthalten Material, Farbe, Infill, Layer Height, Gewicht, Druckzeit und die 3DQuoteX Order ID.
  • Bestellarchiv: Jede Datei wird beim Klick auf „Zum Warenkorb“ gespeichert und ist im Dashboard downloadbar.
  • Shopify Zuordnung: Die 3DQuoteX Order ID wird an das Draft-Order-Line-Item angehängt, sodass du sie im Shopify-Backend siehst.

3. Ablauf für Kund:innen

  1. Button im Shopify-Produkt führt zu /client mit dem Shop-Parameter.
  2. Upload + Auswahl von Material, Farbe, Infill, Layer Height.
  3. Kalkulation via Slicer-Profil; Ergebnis inklusive Preis, Zeit, Gewicht.
  4. „Zum Warenkorb“ löst Draft-Order aus, speichert die Datei und vergibt die interne 3DQuoteX Order ID.
  5. Weiterleitung zum Shopify-Checkout der Draft Order.

4. Preislogik

Gesamtpreis = (Gewicht in kg × Materialpreis) + (Druckzeit × Energie & Maschine) + optionaler Aufschlag.

  • Materialpreis: wird je Filament separat gepflegt.
  • Energie: Wh pro Stunde × Preis je kWh.
  • Maschine: Wartung + Verschleiß je Stunde.
  • Markup: Prozentualer Aufschlag auf die Summe.

5. Troubleshooting & Tipps

  • Slicer fehlt? Stelle sicher, dass prusaslicer im Server-Pfad liegt; sonst erscheint eine klare Fehlermeldung.
  • Draft Order schlägt fehl? Prüfe API Key & Token im Dashboard und ob die App-Berechtigung write_draft_orders aktiv ist.
  • Datei nicht sichtbar? Kunden-Datei wird erst beim Klick auf „Zum Warenkorb“ gespeichert. Prüfe den Bestell-Reiter im Dashboard.