ONIX-Titeldaten

Für jedes im VLB enthaltene Produkt können die vollständigen bibliographischen Daten sowie weiterführende Produktinformationen wie Preise, Lieferbarkeit, Verkaufsrechte, Links zu ergänzenden Medien etc. in Form eines Datensatzes pro Produkt bezogen werden.

Die Produktdaten stellt das VLB in den internationalen Standard-Austauschformaten der Buchbranche ONIX 2.1 und ONIX 3.0 zur Verfügung. Neben täglichen Update-Meldungen (Neumeldungen, Veränderungsmeldungen etc.) wird einmal im Quartal auch ein Gesamtabzug der im VLB enthaltenen Produkte erstellt. Beide können in Form von ONIX-Feeds bezogen werden.

Nachfolgend finden Sie Informationen zum Umfang der ONIX-Feeds und wie Sie diese beziehen können.

Das VLB stellt dem Handel Titeldaten in ONIX 2.1 sowie ONIX 3.0 in einer homogenen Form bereit, die die einfache Nachnutzung in Anwendungssystemen garantiert. Hierfür führt das VLB eine Vielzahl von Plausibilitätsprüfungen beim Import bzw. bei der Datenpflege durch und sorgt mittels automatischer Datenkorrekturen für den Export von problemlos zu verarbeitenden Datensätzen. Um die hohe Qualität der exportierten Daten zu garantieren, verarbeitet das VLB ein festdefiniertes ONIX-Elementset. Das Elementset orientiert sich an den Anforderungen der deutschen Marktteilnehmer und wird stetig erweitert.

Welche ONIX-Elemente in den ONIX-Titeldaten des VLB zu finden sind, haben wir in einer Übersicht für Sie zusammengestellt:

• ONIX im VLB – Übersicht

Des Weiteren können Sie den VLB-ONIX-Empfehlungen detaillierte Beschreibungen für die einzelnen ONIX-Felder entnehmen. Diese Empfehlungen richten sich zwar primär an Verlage und Dienstleister, die ONIX-Titeldaten an das VLB anliefern, zeigen aber auch wie Produktinformationen aus dem VLB exportiert werden.

• VLB-ONIX-Empfehlungen

Ein häufiger Anwendungsfall für die Produktselektion ist das Ignorieren von E-Books bzw. digitalen Online-Produkten (Produktform E* in ONIX 3.0 und DG in ONIX 2.1). Auch kann eine separate Behandlung von Bundles (erkennbar an Produktform und Mehrwertsteuer-Splitting) hilfreich sein.

Weiterführende Informationen rund um ONIX finden Sie auf der Website von EDItEUR.

Der VLB-Titelbestand teilt sich aufgrund unterschiedlicher Nachnutzungsszenarien, aber auch aufgrund seines Umfangs in die zwei nachfolgenden Teilbereiche:

1. aktive Titel: Vorankündigungen, lieferbare Produkte etc.
2. archivierte Titel: Vergriffen-Meldungen, vom Kauf zurückgezogen etc.

Da Händler teilweise nur Interesse an lieferbaren Produkten haben, stellt das VLB den ONIX-Gesamtabzug sowie die Tagesupdates getrennt nach aktiven und archivierten Titeln zur Verfügung. Beim Abschluss des Datenvertrages legen Sie fest, auf welche Datenbestände Sie Zugriff haben.

Bei Tagesupdates wird darüber hinaus eine Differenzierung nach Neuzugang, Änderung oder Löschung vorgenommen. Die nachfolgende Tabelle verdeutlicht die einzelnen Anwendungsfälle.

Bei der Verarbeitung der Feeds sollten Sie darauf achten, die nachfolgende Reihenfolge einzuhalten, um in Ihrem System die aktuellsten Daten vorzuhalten.

1. Del (Löschungen)
2. New (Neuzugänge)
3. Upd (Updates aktiver Titel)
4. Upd_archiv (Updates archivierter Titel)

Um Produkte anschaulicher zu machen, kann ein Verlag Bild-, Text, Audio- und Videodateien zu seiner VLB-Produktbeschreibung hinzufügen.

In den ONIX-Titeldaten finden Sie diese Mediendateien als Link vor.

Mediendateien, die auf dem VLB-Assetstore gespeichert wurden, können Sie nur unter Benutzung des Ihnen zugesandten Tokens abrufen.

• Beispiel-URL: http://api.vlb.de/api/v1/cover/9783540537120/?access_token=04186fb7-397d-47a0-a9be-fbdbc1b95a3b

Bilddateien können in unterschiedlicher Auflösung vom VLB-Assetstore heruntergeladen werden. Um eine festdefinierte Bildgröße abzurufen, ist einer der Parameter aus der nachfolgenden Tabelle an den VLB-Link anzufügen.

• Beispiel-URL: http://api.vlb.de/api/v1/cover/9783540537120/m?access_token=04186fb7-397d-47a0-a9be-fbdbc1b95a3b

Tipps, wie Sie Link auf Mediendateien performant abrufen:

• Laden Sie bitte nur aktualisierte Mediendateien herunter. Sie können dafür auf verschiedenen Wegen einen Identifier für die aktuellste Version der Mediendatei oder das letztes Aktualisierungsdatum abrufen.
  • Option a) Wenn Ihr System einen Link zu einer VLB-Mediendatei abruft, schickt das VLB im HTTP-Header den sogenannten ETag (Entity-Tag) als Identifier und das letzte Aktualisierungsdatum im Feld Last-Modified zurück. Beide Header-Felder gehören zum HTTP-Standard. Das VLB empfiehlt, einen GET-Request mit der Bedingung If-None-Match oder If-Modified-Since zu implementieren, da Sie mit lediglich einem HTTP-Standard-Request zeitsparend prüfen, ob die Datei bereits bei Ihnen im System vorliegt und diese ggf. sogleich herunterladen.
    • If-None-Match: Diese Bedingung gleicht den gesendeten ETag-Wert mit dem ETag-Wert im VLB ab. Die angeforderte Mediendatei wird nur zurückgegeben, wenn die beiden Werte nicht übereinstimmen (Status 200). Wenn die beiden Werte übereinstimmen, Sie die Datei also bereits in der korrekten aktuellen Version haben, dann gibt der Server 304 (Not Modified) zurück.
    • If-Modified-Since: Ein Request mit dieser Bedingung gibt die angeforderte Mediendatei nur zurück, wenn das Datum in Last-Modified nach dem angegebenen Datum liegt (Status 200), andernfalls ist der Response 304 (Not Modified) ohne Body, d.h. ohne Mediendatei.
  • Option b) Außerdem unterstützt das VLB sogenannte HEAD-Requests und gibt im HTTP-Header wie bei GET-Requests den ETag (Entity-Tag) und das letzte Aktualisierungsdatum im Feld Last-Modified an. Falls Sie in Ihrem Datenbestand für eine Mediendatei bereits dasselbe Update-Datum oder denselben ETag-Wert haben, brauchen Sie die Datei nicht erneut mit einem GET-Request herunterladen, da sich an der Datei nichts verändert hat.
  • Option c) Falls Sie die Produktdaten für eine Prüfung heranziehen möchten, gibt es in den Produktdaten für jede Mediendatei ein letztes Aktualisierungsdatum im JSON-Feld lastUpdated und den MD5-Hash-Wert im Feld JSON-Feld md5Hash, die Sie mit den Werten in Ihrem Datenstand abgleichen können.
• Benutzen Sie bitte Caching: Speichern Sie Mediendateien wie ein Cover nach einmaligem Download zwischen, damit das Cover nicht jedes Mal erneut über den VLB-Assetstore abgerufen wird, wenn es z.B. nach einer Suchanfrage zur Anzeige in der Trefferliste benötigt wird.
• Der Abruf aus dem VLB-Assetstore ist primär für den Abruf der zum einzelnen Produkt gehörenden Mediendateien gedacht und nicht zum Abruf größerer Cover- bzw. Mediendateien-Mengen wie z. B. für den Aufbau eines Mediendatenpools. Hierfür empfehlen wir Ihnen unsere Mediendatei-Feeds.

Gelöschte Mediendateien

Wurde eine Mediendatei vom Verlag aus dem VLB entfernt, ist der Titel im nächsten ONIX-Feed ohne diese Mediendatei zu finden. Wurde ein Titel beispielsweise an einem Tag mit einer Innenansicht im VLB angelegt, ist der Titel im nächsten ONIX-Feed mit der Innenansicht als Link zu finden. Sollte der Verlag diese Innenansicht später aus dem VLB entfernen, ist der Titel im nächsten ONIX-Feed ohne diese Innenansicht, also auch ohne Mediendatei-Link zu finden.

Farbwerte werden in ONIX2.1 / ONIX3.0 in dem Composite <ProductFormFeature> exportiert. Die Coverfarbe wird von unserem System ermittelt. Maximal werden 5 Farben, die am häufigsten vorkommen, gespeichert und exportiert (Also nicht immer für jedes Cover 5 Farben, sondern ggf. höchstens 5-Farben).

ONIX 3.1 wurde durch EDItEUR im März 2023 eingeführt. Felder, die durch neue Anforderungen ergänzt wurden, können nur noch über ONIX 3.1 ausgetauscht und nicht in ONIX 3.0 hinterlegt werden.

Als Datenbezieher sollten Sie sicherstellen, dass Ihr ONIX3-Importer mit ONIX 3.1 wie auch mit ONIX 3.0 umgehen kann. ONIX 3.1 ist abwärtskompatibel, alle ONIX 3.0 Felder sind unverändert enthalten. Es kommen lediglich neue Felder hinzu. Sie müssen aber den Umgang mit dem angepassten release-Attribut sicherstellen.

VLB-Felder, die nur in ONIX 3.1 existieren:

• StreetAddress / x552, LocationName / j349, PostalCode / x590 und CountryCode / b251 in ProductContact

Das VLB stellt einmal im Vierteljahr einen ONIX-Export aller im VLB vorhandenen Produkte bereit, der zur initialen Befüllung Ihres Systems verwendet werden kann. Dieser steht jeweils zu Beginn der Monate Februar, Mai, August und November eines Jahres bereit. Auch kann der Gesamtabzug genutzt werden, um ein Recovery in Ihrer Anwendung zu ermöglichen.

Täglich von Montag bis Sonntag (inkl. Feiertage) werden alle Neuzugänge, Updates und Löschungen in zusätzlichen Tagesupdates zur Verfügung gestellt. Nach Erstbefüllung Ihrer Datenbank ist es nur noch notwendig, die Tagesupdates einzuspielen. Da Tagesupdates unter Umständen sehr umfangreich sein können, bietet das VLB die Tagesexporte auch in gesplitteten Teilpaketen an. Wie Sie zwischen gesplitteten und vollständigen Feeds unterscheiden, entnehmen Sie bitte der Übersicht in der folgenden Tabelle.

(*) Teildateien zu 200 MB; nn für fortlaufende Nummerierung

(*) Teildateien zu 200 MB; nn für fortlaufende Nummerierung