Zum Hauptinhalt springen

Produktfeed Export

[feed] [portal] [api]

Lade deinen freigegebenen Produktkatalog als CSV/JSON/Shopify-CSV/WooCommerce-XML herunter — oder bind ihn per Token-URL automatisch in deinen Shop ein.

Für wen​

Kunden (Lizenznehmer), die ihre lizenzierten 3D-Druck-Produkte in den eigenen Online-Shop übernehmen wollen.

Was du bekommst​

Pro Produkt liefert der Feed (je nach Auswahl):

  • Produktname, Beschreibung
  • Kategorie, Kompatibilitäten
  • Vorschaubild + weitere Bilder
  • Lizenzpreis (vom Tenant empfohlen)
  • Tags (= Kompatibilitäten + Kategorie)
  • Dateiformate (STL, 3MF, STEP, GCODE …)
  • Erstellungs- und Aktualisierungsdatum

Welche Felder im Feed landen, kannst du im Portal selbst auswählen.

Schritt für Schritt​

1. Im Portal zur Export-Seite​

Sidebar → Produkte öffnen. Oben rechts neben dem Ansichts-Toggle (Grid/Liste) klick auf "↓ Feed exportieren".

2. Felder auswählen​

Welche Spalten sollen im Export auftauchen? Standardmäßig sind 7 Felder vorausgewählt (Name, Beschreibung, Kategorie, Kompatibilitäten, Vorschaubild, Preis, Tags). Du kannst beliebig hinzu- oder abschalten. Auswahl speichern klicken — gilt dann auch für den automatischen Feed.

3. Format wählen​

Vier Format-Kacheln:

  • CSV — Universal: Standard-Tabellenformat, in Excel, Numbers, Google Sheets oder jedem Shop-System importierbar.
  • Shopify — Direkt: Spalten passen exakt zum Shopify-Produkt-Import (Handle, Title, Body HTML, Vendor, Type, Tags, Variant Price …).
  • WooCommerce — XML: WooCommerce-Produkt-XML, importierbar via WooCommerce Product CSV Import Suite oder ähnliche Plugins.
  • JSON — API: Standard-JSON-Array, ideal für eigene Importer.

4. Mapping anpassen (optional)​

Klick auf ▼ Spaltennamen anpassen. Pro Feld kannst du den Spaltennamen überschreiben (z.B. Produktname → "Title"). Wirkt nur bei CSV + JSON; Shopify und WooCommerce nutzen ihre festen Spaltennamen. Mapping speichern klicken.

5. Manueller Download​

Unten Feed herunterladen. Datei wird sofort als Download geliefert (produkte.csv, produkte.json, produkte-shopify.csv, produkte-woocommerce.xml).

6. Automatischer Feed (Token-URL)​

Wenn du den Feed nicht manuell sondern automatisch in deinen Shop importieren willst:

  1. Klick auf Feed-Token generieren — du siehst den Token-Klartext nur einmal direkt nach Generierung, also direkt kopieren.
  2. Die fertige URL (Format wie): 
    https://<tenant>.licensio.io/api/portal/feed?format=shopify&token=<dein-token>
  3. Diese URL in deinem Shop-System als automatischen Produkt-Import einrichten (z.B. via Cron-Job oder integriertem Feed-Importer).
  4. Der Feed wird live aus der DB generiert — Änderungen an Produkten oder am Mapping erscheinen beim nächsten Abruf automatisch.
  5. URL kopieren, Token erneuern oder Token löschen — alles über die UI.

Export-Profile​

Vorgefertigte Einstellungen für gängige Shop-Systeme:

  • Shopify Standard: Dezimal Punkt, Handle SEO-Slug, alle Bilder als Multi-Row, Format Shopify-CSV
  • WooCommerce: Dezimal Komma, Handle UUID, nur erstes Bild, Format XML
  • Eigenes Profil: alle Einstellungen manuell konfigurierbar

Profil oben rechts auf der Export-Seite per Radio wählen — die einzelnen Einstellungen werden automatisch gesetzt und gespeichert.

Export-Einstellungen​

Vier Optionen die das Format der Ausgabe beeinflussen:

  • Dezimalzeichen: Punkt (11.99, Shopify-Standard) oder Komma (11,99, deutsche Schreibweise / WooCommerce)
  • Handle-Format (Shopify): SEO-Slug aus Produktname (licensio-ac-infinity-fan-mount) oder UUID (licensio-7cf26192-cc4b-...). SEO ist der Default für bessere Such-Erscheinung.
  • Mehrere Bilder pro Produkt (Shopify): "Ja" erzeugt eine Zeile pro Bild (erste Zeile mit voll-Daten, weitere Zeilen mit Handle + Image-URL + Position) — Shopify-Konvention. "Nein" gibt nur das Vorschaubild aus.
  • Trennzeichen (CSV): Komma (,, Shopify-Standard), Semikolon (;, deutsches Excel-Standard / WooCommerce-CSV), oder Tab (TSV). Wirkt für CSV + Shopify-CSV; JSON und WooCommerce-XML ignorieren das Trennzeichen.

Spaltenreihenfolge per Drag & Drop​

Im Mapping-Bereich kannst du die Reihenfolge der Spalten in CSV + JSON per Drag&Drop ändern. Der Griff ⠿ links jeder Zeile ist ziehbar — Drop auf eine andere Zeile sortiert um. Auf "Mapping speichern" klicken speichert die Reihenfolge zusammen mit den Spaltennamen-Overrides. Shopify-CSV und WooCommerce-XML haben feste Spalten und ignorieren die Sortierung.

Bekannte Eigenheiten​

  • Produkte ohne Preis: werden mit 0.00 (oder 0,00 bei Komma) ausgegeben. Eine Warnung in der UI zeigt wie viele Produkte ohne Preis exportiert würden.
  • Preis-Range (z.B. "16,99 - 29,99" für mehrere Varianten): es wird nur der niedrigste Preis übernommen.
  • Tags-Dedup: identische Werte aus compatibility[], metadata.category und metadata.tags[] werden zu einer einzigen Tag-Liste zusammengeführt.

Datenherkunft pro Feld​

Wichtig fuer Entwickler:innen: nicht alle Felder kommen aus eigenen DB-Spalten. Einige liegen im JSONB-Feld metadata:

Feed-FeldQuelle in catalog_items
Produktnamename
Beschreibungmetadata.description (JSONB-Pfad, nicht eigene Spalte!)
Kategoriemetadata.category
Kompatibilitaetencompatibility[]
Vorschaubildimages[0]
Weitere Bilderimages[1..]
Lizenzpreisrecommended_price (text, kann Range "10-20€" enthalten)
Dateiformateproduction_files.file_type (joined, distinct)
Erstellt/Aktualisiertcreated_at / updated_at

Wenn ein Tenant zukuenftig direkte description-Spalte einfuehren wuerde, muss die Feed-Route entsprechend angepasst werden — sie liest aktuell ausschliesslich aus dem JSONB-Pfad.

Häufige Fragen​

Welche Produkte sind im Feed? Genau die, die du auch im Portal sehen kannst. Paket-Einschränkungen (Paket-Einschränkungen) gelten 1:1 — der Feed exponiert keine Produkte, die für dein Paket nicht freigeschaltet sind.

Was wenn der Token in falsche Hände gerät? Token-URL kopieren erlaubt READ-only Zugriff auf deinen Produktkatalog (keine Account-Daten). Bei Verdacht: Token löschen im Portal — die alte URL stoppt sofort. Danach optional Token erneuern.

Wie oft wird der Feed aktualisiert? Der Feed ist live — bei jedem Abruf wird die DB aktuell abgefragt. Es gibt keinen Cache.

Kann ich verschiedene Formate parallel nutzen? Ja — die Token-URL akzeptiert format=csv|shopify|woocommerce|json. Du kannst die gleiche Token-URL in mehreren Shops mit verschiedenen Formaten nutzen.

Funktioniert das auch ohne Token (mit Login)? Ja, aber nur im Browser mit aktiver Session. Die Token-URL ist für Server-zu-Server-Imports gedacht, die keinen Cookie-Login machen können.

Wie limitiere ich welche Produkte im Feed sind? Nicht direkt — der Feed enthält alle für dich freigeschalteten Produkte. Wenn du nur eine Teilmenge brauchst, importiere im Shop nur einen Teil davon (Filterung im Shop-System).

Verwandt​