ONIX für Aktionen und Specials
Für Verlage, die nicht nur ihre Produkte, sondern auch Aktionen und Specials in ihrem Verlagssystem pflegen, bietet VLB-TIX eine vollautomatische Übertragung an. Analog zur Produktmeldung an das VLB können Sie auch Aktionen und Specials über ONIX 3 senden.
Die nachfolgend beschriebene Verwendung von ONIX 3 basiert auf einen Best Practice Dokument der IG Produktmetadaten.
Sichtbarkeit nur auf VLB-TIX
Über ONIX gemeldete Produkte sind generell auf VLB und VLB-TIX sichtbar und werden allen VLB-Datenbeziehern für die Nutzung in Shopsystemen etc. bereitgestellt. Aktionen und Specials sollen hingegen nur auf VLB-TIX angezeigt werden.
Um eine ausschließliche Sichtbarkeit von Aktionen und Specials auf VLB-TIX festzulegen, hinterlegen Sie den Supplier in Ihrer ONIX-Meldung für Aktionen und Specials bitte wie folgt.
ONIX 3 Short
-
<supplier>
<j292>01</j292>
<supplieridentifier>
<j345>05</j345>
<b244>5271159</b244>
</supplieridentifier>
</supplier>
ONIX 3 Reference
-
<Supplier>
<SupplierRole>00</SupplierRole>
<SupplierIdentifier>
<SupplierIDType>05</SupplierIDType>
<IDValue>5271159</IDValue>
</SupplierIdentifier>
</Supplier>
Produktform
Um eine Aktion bzw. ein Special als solches zu markieren, hinterlegen sie bitte die folgende Kombination von ProductCompositionund ProductForm.
GTIN und Special-ID
Eine Aktion enthält eine definierte Anzahl verschiedener Produkte und Werbemittel. Die Aktion kann vom Handel als ein solches Paket bestellt werden und benötigt daher eine GTIN-13 analog zu normalen Produkten.
Ein Special ist eine Zusammenstellung von Produkten, die nicht als solche bestellt werden kann. Folglich darf ein Special keine GTIN-13 besitzen. Um trotzdem beim Update eine Referenz auf das zu aktualisierende Special zu haben, können Sie eine proprietäre Special-ID angeben. Bitte verwenden Sie im ONIX hierfür ProductIDType bzw. b221 mit dem Wert 01.
Hinweis: Nutzen Sie als Special-ID nur UUIDs. Diese können Sie z.B. unter https://www.uuidgenerator.net generieren lassen.
ONIX 3 Short
-
<productidentifier>
<b221>01</b221>
<b244>630c4cec-4572-11ee-be56-0242ac120002</b244>
</productidentifier>
ONIX 3 Reference
-
<ProductIdentifier>
<ProductIDType>01</ProductIDType>
<IDValue>630c4cec-4572-11ee-be56-0242ac120002</IDValue>
</ProductIdentifier>
Titel und Untertitel
Die Benennung von Aktionen und Specials können Sie wie beim Haupttitel von Produkten vornehmen. Der Titel ist ein Pflichtfeld während Untertitel optional sind.
Beschreibung
Auch die Beschreibung der Aktion bzw. des Specials kann analog zur Hauptbeschreibung eines normalen Produktes vorgenommen werden.
Verlag
Ein weiteres Pflichtfeld ist der Verlag. Auch die Verlagsangabe ist wie der Hauptverlag bei allen anderen Produkten anzugeben.
Cover, Bühne, Marketinggrafiken und Youtube-Links
Auch in Aktionen und Specials können Sie Mediendateien übermitteln. Gegenüber Produkten ist der Umfang an bereitstehenden Arten von Mediendateien jedoch geringer. Die folgenden Angaben sind möglich.
Für Marketinggrafiken und Youtube-Links können Sie ergänzend einen Überschrift und ein Copyright in ResourceFeature festlegen. Den Text geben Sie in FeatureNote bzw. x440 an und ob es ich, um ein Copyright oder die Überschrift handelt in ResourceFeatureType bzw. x438.
Special-Hintergrundfarbe
Für Specials können Sie eine Hintergrundfarbe festlegen. Die Farbe legen Sie durch einen HEX-Wert fest. Die Angabe kann im Cover und/oder der Bühne eingebettet sein.
Bitte verwenden Sie zur Angabe einer Hintergrundfarbe ResourceFeature mit dem Wert 10 in ResourceFeatureType bzw. x438 und dem Farbcde in FeatureValue bzw. x439.
ONIX 3 Short
-
<supportingresource>
<x436>01</x436>
<x427>01</x427>
<x437>03</x437>
<resourcefeature>
<x438>10</x438>
<x439>#FF00AA</x439>
</resourcefeature>
<resourceversion>...</resourceversion>
</supportingresource> ONIX 3 Reference
-
<SupportingResource>
<ResourceContentType>01</ResourceContentType>
<ContentAudience>01</ContentAudience>
<ResourceMode>03</ResourceMode>
<ResourceFeature>
<ResourceFeatureType>10</ResourceFeatureType>
<FeatureValue>#FF00AA</FeatureValue>
</ResourceFeature>
<ResourceVersion>...</ResourceVersion>
</SupportingResource>
Enthaltene Produkte
In einer Aktion bzw. In einem Special enthaltene Produkte sind analog denen in einem mehrteiligen Produkt anzulegen. Die Produktreihenfolge richtet sich nach der Anordnung der ProdcutPart-Elemente im ONIX. Es ist kein PrimaryPart anzugeben, da alle Produkte gleichwertig sind.
Die Anzahl der Produkt in der Aktion ist mittels NumberOfCopies bzw. x323 festzulegen.
Hinweise:
- NumberOfCopies bzw. x323 für die Erstellung einer validen ONIX-Datei im ProductPart Pflichtangaben. Daher ist das Feld auch für Specials notwendig. Bitte hinterlegen Sie für Specials immer den Wert 1.
- Ebenso muss für die Erzeugung einer validen ONIX-Datei immer die ProductForm bzw. b012 im ProductPart angegeben werden. Bei der Anzeige auf VLB-TIX wird allerdings immer die Produktformangeben der referenzierten ISBN/GTIN herangezogen.
ONIX 3 Short
-
<productpart>
<productidentifier>
<b221>03</b221>
<b244>9783765734397</b244>
</productidentifier>
<b012>BC</b012>
<x323>1</x323>
</productpart>
ONIX 3 Reference
-
<ProductPart>
<ProductIdentifier>
<ProductIDType>15</ProductIDType>
<IDValue>9783765734397</IDValue>
</ProductIdentifier>
<ProductForm>BC</ProductForm>
<NumberOfCopies>1</NumberOfCopies>
</ProductPart>
Lieferbarkeit & (Publikations-)Status
Die Lieferbarkeit ist für Aktionen aber auch aus Gründen der Validität für Specials ein Pflichtfeld.
Aktionen können Sie für Kunden mit den beiden folgenden Lieferbarkeiten versehen.
Melden Sie Specials bitte immer als lieferbar. Der Lieferbarkeitsstatus wird nicht am Special angezeigt.
Da Aktionen und Specials nicht über ONIX gelöscht werden können, benutzen Sie bitte die beiden folgenden Lieferbarkeiten, um Aktionen und Specials auf VLB-TIX nicht mehr zur Anzeige zu bringen.
Durch ein Update mit „noch nicht lieferbar“ oder „lieferbar“ können Sie die Aktion oder das Special wieder sichtbar machen.
Möchten Sie Aktionen nur für Mitarbeiter Ihres Verlags sichtbar machen, aber nicht für die Öffentlichkeit, können Sie die Aktion auch auf Entwurf setzen. Dies kann über den Publikationsstatus mit den beiden folgenden Werten vorgenommen werden.
Termine für Aktionen
Für Aktionen können die folgenden Termine hinterlegt werden, wobei der Erscheinungstermin ein Pflichtfeld ist. Alle Restriktionen auf Terminen gelten analog zu normalen Produkten.
Schlagwörter für Aktionen
Um Ihre Aktion besser auffindbar zu machen, können Sie diese mit Schlagwörtern versehen.
Referenz auf andere Aktionsgrößen
Durch einen Produktverweis mit ProductRelationCode bzw. x455 mit dem Wert 06 können Sie auf andere Größen der Aktion hinweisen. Nutzen Sie hierfür bitte immer die GTIN-13 der zu referenzierenden Aktion.
ONIX 3 Short
-
<relatedproduct>
<x455>06</x455>
<productidentifier>
<b221>03</b221>
<b244>4250939808765</b244>
</productidentifier>
</relatedproduct>
ONIX 3 Reference
-
<RelatedProduct>
<ProductRelationCode>06</ProductRelationCode>
<ProductIdentifier>
<ProductIDType>03</ProductIDType>
<IDValue>4250939808765</IDValue>
</ProductIdentifier>
</RelatedProduct>
Preise
In einer Aktion können Sie entscheiden, ob VLB-TIX den Gesamtpreis auf Basis der Preise der enthaltenen Produkte tagesaktuell errechnen soll oder ob Sie einen Festpreis festlegen. Zusätzlich können Sie einen Rabatt für Aktionen ausweisen.
Da in einer Aktion Produkte mit vollem und reduziertem Mehrwertsteuersatz enthalten sein können, zeigt VLB-TIX immer den Bruttopreis an und es ist keine Angabe einer Mehrwertsteuer notwendig.
Auch werden nur Preise für Deutschland, Österreich und die Schweiz angezeigt.
Für Specials gibt es zwar keinen Gesamtpreis, jedoch ist in ONIX eine Angabe zu hinterlegen, um die ONIX-Datei valide zu halten.
Aktion mit Festpreis
Wenn Sie einen festen Preis für eine Aktion angeben, der unabhängig von den enthaltenen Produkten und deren aktueller Lieferbarkeit sein soll, können Sie einen UVP-Preis (PriceType=02) pro Lande angeben.
ONIX 3 Short
-
<price>
<x462>02</x462>
<j266>02</j266>
<j151>399.95</j151>
<j152>EUR</j152>
<territory>
<x449>DE</x449>
</territory>
</price>
ONIX 3 Reference
-
<Price>
<PriceType>02</PriceType>
<PriceStatus>02</PriceStatus>
<PriceAmount>399.95</PriceAmount>
<CurrencyCode>EUR</CurrencyCode>
<Territory>
<CountriesIncluded>DE</CountriesIncluded>
</Territory>
</Price>
Aktion mit berechnetem Preis
Wenn der Preis Ihrer Aktion immer exakt dem Preis der enthaltenen Produkte, entsprechen soll, kann VLB-TIX eine tagesaktuelle Preisberechnung für Sie vornehmen. Diese findet jede Nacht statt, wobei alle aktualisierten Preise des Tages herangezogen werden und nicht mehr lieferbare Produkte aus dem Gesamtpreis entfernt werden.
Dass ein Preis für ein Land berechnet werden soll, können Sie durch die Verwendung von UnpricedItemType mit dem Wert 07 (Calculated from contents) mitteilen.
Da Sie UnpricedItemType immer pro Land angeben, können Sie beispielsweise auch mitteilen, dass nur für Deutschland ein Preis berechnet werden soll und für Österreich und die Schweiz kein Preis existiert. Alternativ können Sie auch für ein Land einen Festpreis angeben und für ein anderes Land den Preis berechnen lassen.
ONIX 3 Short
-
<price>
<x462>02</x462>
<j266>02</j266>
<j192>07</j192>
<j152>EUR</j152>
<territory>
<x449>DE</x449>
</territory>
</price>
ONIX 3 Reference
-
<Price>
<PriceType>02</PriceType>
<PriceStatus>02</PriceStatus>
<UnpricedItemType>07</UnpricedItemType>
<CurrencyCode>EUR</CurrencyCode>
<Territory>
<CountriesIncluded>DE</CountriesIncluded>
</Territory>
</Price>
Aktionen mit Rabattangabe
Sie können für Aktionen mit Festpreis sowie für Aktionen mit berechnetem Preis eine prozentuale Rabattangabe übermitteln. Der Rabatt wird auf den von Ihnen angegebenen Preis angewendet und als rabattierter Preis für Buchhandlungen zur Anzeige gebracht.
Integrieren Sie hierfür bitte ein Discount-Composite in Ihrem Price und geben Sie in DiscountPercent bzw. j267 eine Zahl für die Prozentangabe an.
ONIX 3 Short
-
<discount>
<j267>33.5</j267>
</discount>
ONIX 3 Reference
-
<Discount>
<DiscountPercent>33.5</DiscountPercent>
</Discount>
Specials
In ONIX ist eine Preisangabe Pflicht, da sonst die ONIX-Datei invalide ist. Da für Specials kein Preis existiert, lassen Sie bitte das Price-Composite weg und hinterlegen in UnpricedItemType bzw. j192 den Wert 07 direkt im SupplyDetail.
ONIX 3 Short
-
<j192>07</j192>
ONIX 3 Reference
-
<UnpricedItemType>07</UnpricedItemType>
ONIX-FTP-Upload
Durch die Einschränkung der Sichtbarkeit von Aktionen und Specials auf VLB-TIX ist es möglich, die ONIX-Meldungen als Bestandteil Ihrer regulären ONIX-Uploads im VLB zu integrieren.
Sie können Aktionen und Specials somit über den gewohnten Weg Ihres FTP-Uploads mit Ihren VLB-Nutzerdaten vornehmen. Die Rückmeldung ist somit ebenfalls in Ihrem nächtlichen Mail-Report enthalten.