In diesem Artikel finden Sie die technische Dokumentation zu den ONIX-3.1-Katalogdaten von Libri.

Die Dokumentation richtet sich an technische Ansprechpartnerinnen, Warenwirtschaftsanbieter, Schnittstellenpartner und Kundinnen, die Libri-Katalogdaten automatisiert verarbeiten oder von ONIX 2.1 auf ONIX 3.1 umstellen.

Download

Download: ONIX 3.1 Dokumentation

Die Excel-Datei enthält die aktuelle technische Dokumentation zu den von Libri bereitgestellten ONIX-3.1-Katalogdaten.

Inhalt der Dokumentation

Die Datei enthält unter anderem:

• Struktur der ONIX-3.1-Daten mit Tags, Beispielen, Kardinalität und ergänzenden Libri-Hinweisen

• Hinweise zum Abruf der Katalogdaten

• FAQ zu häufigen technischen Fragen

• Mapping von ONIX 2.1 auf ONIX 3.1

• Libri Produktklassifikation

• Mapping der Availability Codes / Libri Meldeschlüssel

• Lieferzeitklassen

• Informationen zur Bestandsmeldung

• Beispiel für Bundle-Artikel

Abruf der Katalogdaten

Die ONIX-3.1-Katalogdaten werden über den Libri-FTP-Server bereitgestellt.

1. Initial Load / Urladung

Für den initialen Aufbau des Katalogbestands laden Sie zunächst die vollständige Urladung herunter.

• Server: ftp-comm.librinet.de

• Verzeichnis Gesamt-Katalog: /initial_load_GESAMT_ONI_3_1/

• Verzeichnis Libri-Katalog: /initial_load_LIBRI_ONI_3_1/

Die Zugangsdaten erhalten Sie bei Bedarf über Libri.

2. Tägliche Updates / TUPs

Nach der Urladung werden die täglichen Aktualisierungen verarbeitet.

Wichtig: Starten Sie mit dem ersten Tag nach dem Erstellungsdatum der Urladung.

• Server: ftp-comm.librinet.de

• Verzeichnis: /TUP/ONI

• Zugriff: FTPS oder SFTP mit individuellen Zugangsdaten

Wichtige Hinweise zur Verarbeitung

Zeichensatz

Die ONIX-Nachrichten werden in UTF-8 bereitgestellt. Sonderzeichen wie Ä, Ö, Ü, é oder è können direkt enthalten sein. Bestimmte XML-Zeichen werden entsprechend codiert, zum Beispiel & als &.

Eindeutige Artikelreferenz

Die eindeutige Referenz eines Artikels ist die Record Reference im Feld <a001>. Andere Nummern wie EAN, LibriNr oder Bestellnummer können zusätzlich verwendet werden, sind aber je nach Fall nicht immer dauerhaft eindeutig.

Availability Codes / Meldeschlüssel

Die ONIX-Availability-Codes werden im Feld <j396> bereitgestellt. Zusätzlich stellt Libri ein Mapping zu den Libri-Meldeschlüsseln bereit. Die aktuelle Zuordnung ist in der Excel-Dokumentation enthalten.

Lieferzeiten

Lieferzeiten werden über Lieferzeitklassen bereitgestellt. Die Zuordnung der Lieferzeitklassen zu Tagen ist in der Excel-Dokumentation enthalten.

Bestandsinformationen

Bestandsinformationen werden nicht als exakte Stückzahl, sondern als Bestandsklasse bzw. Mindestmenge innerhalb einer Spanne gemeldet.

Bilder

Bildlinks werden in den ONIX-Daten bereitgestellt. Für den Zugriff ist ein individueller Zugangsschlüssel erforderlich. Bitte stellen Sie sicher, dass dieser Schlüssel nicht öffentlich im Frontend sichtbar ist.

Empfohlen wird die Nutzung über einen Backend-Proxy oder eine sichere Übergabe über einen Authorization Header.

Löschungen aus dem Katalog

Entfernungen aus dem Katalog können über den Notification Type <a002>05</a002> erkannt werden.

Häufige Fragen

Wo finde ich die offizielle ONIX-Standarddokumentation?

Die offizielle ONIX-Dokumentation und die Codelisten werden von EDItEUR bereitgestellt. Die Libri-Dokumentation ergänzt diese Informationen um Libri-spezifische Hinweise zur Bereitstellung und Verarbeitung der Katalogdaten.

Wo finde ich die ONIX-Codelisten?

Die ONIX-Codelisten finden Sie bei EDItEUR. In der Excel-Dokumentation wird bei vielen Feldern auf die entsprechende Codeliste verwiesen.

Wie erkenne ich Artikel, die nicht in meinen Katalog übernommen werden sollen?

Für bestimmte Libri-Produktklassifikationen kann das Feld <b275> innerhalb der Produktklassifikation verwendet werden. Damit lassen sich zum Beispiel bestimmte Materialien, Gutscheine, Bundle-Komponenten oder andere Sonderformen erkennen.

Wie erkenne ich Print-to-Order-Artikel?

Print-to-Order-Artikel werden ohne Bestandsinformation gemeldet. In der Dokumentation sind die entsprechenden Libri-Meldeschlüssel und ONIX-Availability-Codes beschrieben.

Wo finde ich Hinweise zu GPSR-relevanten Daten?

GPSR-relevante Kontaktinformationen können je nach Datensatz in <productcontact> oder <supplycontact> bereitgestellt werden. Weitere Details finden Sie in der Excel-Dokumentation.

Gibt es ein Beispiel für Bundle-Artikel?

Ja. Die Excel-Datei enthält einen eigenen Reiter mit einem Beispiel für Bundle-Artikel.

Kontakt

Bei technischen Rückfragen zur ONIX-3.1-Dokumentation oder zum Abruf der Katalogdaten wenden Sie sich bitte an den Libri Support oder an den zuständigen technischen Kontakt für EDI/Katalogdaten.