Export

Das Export-Modul des anyPIM stellt Produktdaten in strukturierter Form für externe Systeme bereit. Es unterstützt sowohl generische JSON-Exporte als auch die spezialisierte Publixx-Integration.

Exportformate

Das anyPIM bietet zwei Export-Kanäle:

Kanal	Format	Zielgruppe	Beschreibung
JSON-Export	JSON	Entwickler, Systeme	Generischer Export mit konfigurierbaren Filtern und Formaten
Publixx-Export	JSON	Publixx-Plattform	Spezialisierter Export mit Mapping-Konfiguration für Publixx-Kataloge

Export-Pipeline

Der Exportprozess folgt einer klar definierten Pipeline:

1. Anfrage

Der Export wird über einen API-Endpunkt oder eine PQL-Abfrage ausgelöst. Der Aufrufer definiert dabei Filter, Include-Optionen und das gewünschte Ausgabeformat.

2. Filterung

Die Produktmenge wird anhand der angegebenen Kriterien eingeschränkt:

• Status -- Nur Produkte mit bestimmtem Status (z. B. active)
• Hierarchie -- Produkte eines bestimmten Hierarchieknotens oder -pfads
• Attribute -- Filterung über Attributwerte
• Attributansichten -- Einschränkung auf bestimmte Views
• Ausgabehierarchie -- Strukturierung nach einer Output-Hierarchie
• Delta-Zeitstempel -- Nur seit einem bestimmten Zeitpunkt geänderte Produkte (updated_after)

3. Datenanreicherung

Die gefilterten Produkte werden mit den angeforderten Zusatzdaten angereichert:

• Attributwerte (mit Vererbungsauflösung bei Varianten)
• Medien (Bilder, Dokumente, Videos)
• Preise (nach Währung und Gültigkeit)
• Relationen (Zubehör, Ersatzteile, Querverweise)
• Varianten (mit eigenen Attributwerten)

4. Transformation

Die angereicherten Daten werden in das gewünschte Format transformiert:

Format	Beschreibung
flat	Flache Struktur mit allen Attributen als Schlüssel-Wert-Paare
nested	Verschachtelte Struktur, gruppiert nach Attributgruppen
publixx	Publixx-spezifisches Format mit Mapping-Transformation

Delta-Export

Der Delta-Export ermöglicht effiziente inkrementelle Synchronisationen. Über den Parameter updated_after werden nur Produkte exportiert, die seit dem angegebenen Zeitpunkt geändert wurden:

GET /api/v1/export/products?updated_after=2025-06-15T10:00:00Z

Der Zeitstempel berücksichtigt Änderungen an:

• Produkt-Stammdaten (Name, SKU, Status)
• Attributwerten
• Medienzuordnungen
• Preisen
• Varianten und deren Attributwerten
• Relationen

BMEcat-Export

Das anyPIM unterstützt den Export von Produktdaten im BMEcat-Format (Versionen 1.2 und 2005). Der BMEcat-Export generiert standardkonforme XML-Dateien, die von ERP-Systemen, Online-Shops und Beschaffungsplattformen direkt verarbeitet werden können.

Unterstützte Versionen

Version	Element-Mapping
BMEcat 1.2	Klassische Elementnamen und Struktur
BMEcat 2005	Erweiterte Elementnamen (z.B. PRODUCT statt ARTICLE)

Filteroptionen

Der BMEcat-Export unterstützt flexible Filterung:

• Hierarchie -- Export nur für bestimmte Kategorien/Hierarchieknoten
• Produkttypen -- Einschränkung auf bestimmte Produkttypen
• Attribute -- Auswahl der zu exportierenden Attribute
• Preistypen -- Filterung nach Preistyp
• Relationstypen -- Auswahl der zu exportierenden Produktbeziehungen

Exportierte Elemente

BMEcat-Element	Inhalt
PRODUCT / ARTICLE	Produktstammdaten (SKU, Name, Beschreibung)
PRODUCT_DETAILS	Detailattribute (Langbeschreibung, Hersteller, Lieferzeit)
PRODUCT_FEATURES	Produktmerkmale aus EAV-Attributen
PRODUCT_PRICE_DETAILS	Preisinformationen mit Währung und Staffelung
MIME_INFO	Medienreferenzen (Bilder, Dokumente)
PRODUCT_REFERENCE	Produktbeziehungen (Zubehör, Ersatzteile)
CATALOG_GROUP_SYSTEM	Hierarchiestruktur
PRODUCT_TO_CATALOGGROUP_MAP	Produkt-Kategorie-Zuordnungen

Technische Details

• Streaming-Ausgabe -- Der Export nutzt XMLWriter für eine speichereffiziente Verarbeitung. Produkte werden in Blöcken (Chunks) verarbeitet.
• Element-Mapping -- Die Klasse BmecatElementMap übersetzt automatisch zwischen BMEcat 1.2 und 2005 Elementnamen.

Weiterführende Dokumentation

• JSON-Export -- Endpunkte, Filter, Formate und Paginierung
• Publixx-Export -- Mapping-Konfiguration und Publixx-Integration