E-book distribution platform - ONIX 30 specification
Revision history | ||
Date | ONIX composite | Change description |
Toegankelijkheidsinformatie
| For the European Accessibility Directive and Dutch legislation on digital products, values ​​from code lists have been added to various elements and P.3.11 Product Content Type has been included. See the complete overview with metadata data and the combination of values ​​from the various code lists. | |
Upgrade Codelists issue 65 and 66 | Implementation Codelists issue 65 and 66 | |
EpubUsageConstraint | For the purpose of Text & data mining, an EpubUsageContraint composite has been added, | |
Upgrade Codelists issue 55 - 64 | Implementation Codelists issue 55 and 64 | |
| P.11 Extent | Added: P.1.11 Extent composite. A group of data elements which together describe an extent pertaining to the product. Eg to give the number of pages in a paginated e-book, or to give Bytes, Kilobytes or Megabytes of the e-book file Effective as of February 26, 2023 |
Example ONIX files for download | |
---|---|
Sales | |
Sales and subscription | |
Subscription | |
The example files contain each one product which is made available for sales, subscription or both. There are multiple contributors, multiple BISAC, multiple THEMA and multiple prices (periods). For more information you need to reference the specification below: |
Block | Reference | Short_tag | Long_tag | Value | ONIX List | Short description |
Header | /Header | Start Header | ||||
Header | /Sender | Start Sender | ||||
Header | /SenderIdentifier | Start SenderIdentifier | ||||
Header | H.1 | m379 | /SenderIDType | 10 (= Centraal Boekhuis Relatie ID) | List 44 | Identification within the Centraal Boekhuis systems |
Header | H.3 | b244 | /IDValue | 8894126 | Centraal Boekhuis' relation_id | |
Header | /SenderIdentifier | End SenderIdentifier | ||||
Header | H.4 | x298 | /SenderName | CB B.V. | Offical name Centraal Boekhuis | |
Header | H.5 | x299 | /ContactName | eBoekhuis | Contact person | |
Header | H.6 | j272 | /EmailAddress | afnemers@cb.nl | Emailaddress | |
Header | /Sender | End Sender | ||||
Header | H.15 | x307 | /SentDateTime | Sent date time in format YYYYMMDDTHH24MI | ||
Header | /Header | End Header | ||||
Product | /Product | Start Product | ||||
Product | P.1.1 | a001 | /RecordReference | EAN of the product | The EAN for the ebook | |
Product | P.1.2 | a002 | /NotificationType | 03 (= Notification confirmed on publication) | List 1 | |
Product | /ProductIdentifier | Start ProductIdentifier | ||||
Product | P.2.1 | b221 | /ProductIDType | 03 (= GTIN-13) | List 5 | |
Product | P.2.3 | b244 | /IDValue | EAN of the product | The EAN for the eBook | |
Product | /ProductIdentifier | End ProductIdentifier | ||||
Descriptive detail | /Product/DescriptiveDetail | Start Desciptive detail | ONIX List | Short description | ||
Descriptive detail | P.3.1 | x314 | /ProductComposition | 00 (= Single-item retail product) | List 2 | |
Descriptive detail | P.3.2 | b012 | /ProductForm | EA (= Digital (delivered electronically) (PDF)) ED (= Digital download) | List 150 | |
Descriptive detail | P.3.3 | b333 | /ProductFormDetail | E101 (= EPUB) E107 (= PDF) | List 175 | |
Descriptive detail | /ProductFormFeature | Start ProductFormFeature | ||||
Descriptive detail | P.3.4 | b334 | /ProductFormFeatureType | 10 (= E-publication format version) | List 79 | |
Descriptive detail | P.3.5 | b335 | /ProductFormFeatureValue | 2 (= EPUB2) 3 (= EPUB3) | EPUB version number | |
Descriptive detail | P.3.6 | b336 | /ProductFormFeatureDescription | If the <ProductFormFeatureType> requires free text instead of one, or if the <ProductFormFeatureValue. code does not describe the feature sufficiently, a short text description can be added. For example; The unique document reference (UUID) under which the Due Diligence document is recorded in the systems at the publisher. Presence or absence of this element depends on the <ProductFormFeatureType> value 50, EUDR Due Diligence reference. | ||
Descriptive detail | /ProductFormFeature | End ProductFormFeature | ||||
Descriptive detail | P.3.10 | x416 | /PrimaryContentType | 01 | List 81 | |
Descriptive detail | P.3.11 | b385 | /ProductContentType | List 81 | ||
Descriptive detail | P.3.16 | x317 | /EpubTechnicalProtection | 00 (= No protection) 02 (= Watermarking) 03 (= Adobe DRM) | List 144 | |
Descriptive detail | Start EpubUsageConstraint | |||||
Descriptive detail | P.3.17 | x318 | /EpubUsageType | 02 03 05 11 | List 145 | |
Descriptive detail | P.3.18 | x319 | /EpubUsageStatus | 03 01 | List 146 | |
Descriptive detail | End EpubUsageConstraint | |||||
Descriptive detail | /Collection | Start Collection | Applicable when e-book is part of a collection. | |||
Descriptive detail | P.5.1 | x329 | /CollectionType | 10 (= Publisher collection) | List 148 | |
Descriptive detail | /TitleDetail | Start TitleDetail Collection | ||||
Descriptive detail | P.5.6 | b202 | /TitleType | 01 (= Distinctive title (book); Cover title (serial); Title on item (serial content item or reviewed resource)) | List 15 | When collection is applicable more than one occurence of TitleDetail |
Descriptive detail | /TitleElement | Start TitleElement Collection | ||||
Descriptive detail | P.5.7 | x409 | /TitleElement/TitleElementLevel | 02 (= Collection level) | List 149 | |
Descriptive detail | P.5.8 | x410 | /TitleElement/PartNumber | Part number when collection is applicable | ||
Descriptive detail | P.5.10 | b203 | /TitleElement/TitleText | Part name when collection is applicable | ||
Descriptive detail | /TitleElement | End TitleElement Colletion | ||||
Descriptive detail | /TitleDetail | End TitleDetail Collection | ||||
Descriptive detail | /Collection | End Collection | ||||
Descriptive detail | /TitleDetail | Start TitleDetail | ||||
Descriptive detail | P.6.1 | b202 | /TitleType | 01 (= Distinctive title (book); Cover title (serial); Title on item (serial content item or reviewed resource)) | List 15 | |
Descriptive detail | /TitleElement | Start TitleElement | ||||
Descriptive detail | P.6.2 | x409 | /TitleElement/TitleElementLevel | 01 (= Product) | List 149 | |
Descriptive detail | P.6.5 | b203 | /TitleElement/TitleText | Title as it should appear on site | ||
Descriptive detail | P.6.8 | b029 | /TitleElement/Subtitle | The text of a subtitle | ||
Descriptive detail | /TitleElement | End TitleElement | ||||
Descriptive detail | /TitleDetail | End TitleDetail | ||||
Descriptive detail | /Contributor | Start contributor(s) | ||||
Descriptive detail | P.7.50 | n339 | /NoContributor | When no contributors are available this tag is provided. | ||
Descriptive detail | P.7.1 | b034 | /SequenceNumber | |||
Descriptive detail | P.7.2 | b035 | /ContributorRole |
| List 17 | |
Descriptive detail | P.7.9 | b036 | /PersonName | The full name of a person | ||
Descriptive detail | P.7.12 | b039 | /NamesbeforeKey | If Contributors has got a FirstName then send FirstName else send initials | ||
Descriptive detail | P.7.13 | b247 | /PrefixToKey | Contributor Prefix | ||
Descriptive detail | P.7.14 | b040 | /KeyNames | Contributor LastName | ||
Descriptive detail | P.7.19 | b047 | /CorporateName | If Contributor role = Corporation then send this tag | ||
Descriptive detail | /Contributor | End contributor(s) | ||||
Descriptive detail | /Language | Start Language | ||||
Descriptive detail | P.10.1 | b253 | /LanguageRole | 01 (= Language of tex) | List 22 | |
Descriptive detail | P.10.2 | b252 | /LanguageCode | List 74 | The language code for the language of the title | |
Descriptive detail | /Language | End Language | ||||
Descriptive detail | P.11 | /Extent | Start Extent | |||
Descriptive detail | P.11.1 | b218 | /ExtentType | CB supports the next values:
| List 23 | |
Descriptive detail | P11.2 | b219 | /ExtentValue | Numeric value of the extent specified in <ExtentTyoe> | ||
Descriptive detail | P11.3 | x421 | /ExtentValueRoman | The value of the extent expressed in Roman numerals. Used only for page runs which are numbered in Roman. | ||
Descriptive detail | P.11.4 | b220 | /ExtentUnit | CB supports the next values:
| List 24 | Indication of the unit used for the <ExtentValue> |
Descriptive detail | P.11 | /Extent | End Extent | |||
Descriptive detail | /Subject | Start Subject | ||||
Descriptive detail | x425 | /MainSubject | ||||
Descriptive detail | P.12.1 | b067 | /SubjectSchemeIdentifier | 10 (= BISAC Subject Heading) 20 (= Keywords) 32 (= NUR) | List 27 | |
Descriptive detail | P.12.5 | b069 | /SubjectCode | BISAC code for the title NUR code for the title | ||
Descriptive detail | P.12.6 | b070 | /SubjectHeadingText | Keyword for the title | ||
Descriptive detail | /Subject | End Subject | ||||
Descriptive detail | /Product/DescriptiveDetail | End Desciptive detail | ||||
Collateral detail | /Product/CollateralDetail | Start Collateral detail | ||||
Collateral detail | /TextContent | Start Textcontent | ||||
Collateral detail | P.14.1 | x426 | /TextType | 03 (= Description) | List 153 | |
Collateral detail | P.14.2 | x427 | /ContentAudience | 03 (= End-customers) | List 154 | |
Collateral detail | P.14.3 | d104 | /Text | Full description of eBook as it should appear on site | ||
Collateral detail | /TextContent | End Textcontent | ||||
Collateral detail | /Product/CollateralDetail | End Collateral detail | ||||
Publishing detail | /Product/PublishingDetail | Start Publishing detail | ||||
Publishing detail | /Imprint | Start Imprint | ||||
Publishing detail | P.19.4 | b079 | /Imprint/ImprintName | The name of the imprint if apply to | ||
Publishing detail | /Imprint | End Imprint | ||||
Publishing detail | /Publisher | Start Publisher | ||||
Publishing detail | P.19.5 | b291 | /PublishingRole | 01 (= Publisher) | List 45 | |
Publishing detail | /PublisherIdentifier | Start PublisherIdentifier | ||||
Publishing detail | P.19.6 | x447 | /PublisherIDType | 10 (= Centraal Boekhuis Relatie ID) | List 44 | |
Publishing detail | P.19.8 | b244 | /IDValue | Unique id of publisher | ||
Publishing detail | /PublisherIdentifier | End PublisherIdentifier | ||||
Publishing detail | P.19.9 | b081 | /Publisher/PublisherName | Name of publisher as it should appear on site | ||
Publishing detail | /Publisher | End Publisher | ||||
Publishing detail | P.20.1 | b394 | /PublishingStatus | 01 (= Cancelled) 02 (= Forthcoming) 04 (= Active) 09 (= Unknown) | List 64 | |
Publishing detail | /PublishingDate | Start PublishingDate | ||||
Publishing detail | P.20.3 | x448 | /PublishingDateRole | 01 (= Publication date) 02 (= Embargo date) | List 163 | |
Publishing detail | P.20.5 | b306 | /Date | Applicable date in format YYYYMMDD | ||
Publishing detail | /PublishingDate | End PublishingDate | ||||
Publishing detail | /SalesRights | Start SalesRights | ||||
Publishing detail | P.21.1 | b089 | /SalesRights/SalesRightsType | 02 (= For unrestricted sale with non-exclusive rights in the specified countries or territories) | List 46 | |
Publishing detail | /Territory | Start Territory | ||||
Publishing detail | P.21.2 | x449 | /CountriesIncluded | NL and/or BE and/or LU | List 91 | |
Publishing detail | P.21.3 | x450 | /RegionsIncluded | WORLD or ECZ | List 49 | |
Publishing detail | /Territory | End Territory | ||||
Publishing detail | /SalesRights | End SalesRights | ||||
Publishing detail | /Product/PublishingDetail | End Publishing detail | ||||
Related material | /Product/RelatedMaterial | Start Related material | ||||
Related material | /RelatedProduct | Start RelatedProduct | ||||
Related material | P.23.1 | x445 | /ProductRelationCode | 13 (= Epublication based on (print product)) | List 51 | |
Related material | /ProductIdentifier | Start ProductIdentifier | ||||
Related material | P.23.2 | b221 | /ProductIDType | 03 (= GTIN-13) | List 5 | |
Related material | P.23.4 | b224 | /IDValue | Associated EAN if the title exists in another format | ||
Related material | /ProductIdentifier | End ProductIdentifier | ||||
Related material | /RelatedProduct | End RelatedProduct | ||||
Related material | /Product/RelatedMaterial | End Related material | ||||
Product supply | /Product/ProductSupply | Start Product supply | When a customer offers sales and subscription always 2 ProductSupply blocks are mentioned per product. When a product is only available for sales, subscription is also mentioned as not available. | |||
Product supply | /Market | Start Market | ||||
Product supply | /Territory | Start Territory | ||||
Product supply | P.24.1 | x449 | /CountriesIncluded | NL and/or BE and/or LU | List 91 | |
Product supply | P.24.2 | x450 | /RegionsIncluded | WORLD or ECZ | List 49 | |
Product supply | /Territory | End Territory | ||||
Product supply | /SalesRestriction | Start SalesRestriction | ||||
Product supply | P.24.5 | b381 | /SalesRestrictionType | 13 (= Restricted to organisations or services offering consumers subscription access to a library of books) | List 71 | |
Product supply | /SalesRestriction | End SalesRestriction | ||||
Product supply | /Market | End Market | ||||
Product supply | /SupplyDetail | Start SupplyDetail | ||||
Product supply | /Supplier | Start Supplier | ||||
Product supply | P.26.1 | j292 | /SupplierRole | 00 (= Unspecified) | List 93 | |
Product supply | P.26.5 | j137 | /SupplierName | CB | ||
Product supply | /Supplier | End Supplier | ||||
Product supply | P.26.17 | j396 | /ProductAvailability | 01 (= Cancelled) 10 (= Not yet available) 21 (= Avaialble - In stock) 34 (= Temporarily withdrawn from sale) 40 (= Not available) | List 65 | If value is 01, 34 or 40 then the digital product should be removed from the platform |
Product supply | /SupplyDate | Start SupplyDate | Only applicable when ProductAvailability is 10 or 40 | |||
Product supply | P.26.18 | x461 | /SupplyDateRole | 08 (= Expected availability date) | List 166 | |
Product supply | P.26.20 | b308 | /Date | |||
Product supply | /SupplyDate | End SupplyDate | ||||
Product supply | /Price | Start Price | ||||
Product supply | P.26.43 | x462 | /PriceType | 02 (= RRP including tax) 06 (= Supplier’s net price excluding tax: rental goods) 42 (= Publishers retail price including tax) | List 58 | |
Product supply | P.26.62 | j151 | /PriceAmount | Suggested List Price when PriceType = 02 or 42 | ||
Product supply | /PriceCoded | Start PriceCoded | Only applicable when publisher registrered an identification to identify the business model agreed between publisher and customer | |||
Product supply | P.26.63 | x465 | /PriceCodeType | 01 (= Proprietary) | List 179 | |
Product supply | P.26.64 | x477 | /PriceCodeTypeName | PRIJSAFSPRAAKKENMERK | ||
Product supply | P.26.65 | x468 | /PriceCode | Identification for the product to identify the business model agreed between publisher and customer | ||
Product supply | /PriceCoded | End PriceCoded | ||||
Product supply | P.26.82 | j152 | /CurrencyCode | EUR | List 96 | |
Product supply | /PriceDate | Start PriceDate | When more prices in a period are valid, then repeatable | |||
Product supply | P.26.83 | x476 | /PriceDateRole | 14 (= Date from) 15 (= Date until) | List 173 | |
Product supply | P.26.85 | b306 | /Date | |||
Product supply | /PriceDate | End PriceDate | ||||
Product supply | /Price | End Price | ||||
Product supply | /SupplyDetail | End SupplyDetail | ||||
Product supply | /Product/ProductSupply | End Product supply | ||||
Product | /Product | End Product |