- About Release 2.1
- Release 2.1 downloads
- ONIX for Books Supply Update, Release 1.0
- ONIX tagname converter
- Documentation in French and German
Prior to Release 3.0, the current release for users in most countries was Release 2.1 revision 02, published in 2004, with some minor revisions to documentation in February 2005.
To meet the specific needs of ONIX implementations in Australia and Spain, a further minor revision, 03, was published in January 2006, adding a small number of optional elements to Groups PR.24 and PR.26. All other users were recommended to continue to work with Release 2.1 revision 02.
However, even if you are staying with Revision 02, you may wish to use the Revision 03 documentation package, which includes some more general improvements. Within the documentation, new elements that are applicable only to Revision 03 are clearly marked as such. Note that the Main Series and Subseries Records have been removed from revision 03 documentation. They remain in the DTD and Schema for reasons of backwards compatibility, but have not been carried forward into ONIX 3.0. These record types were added specifically to support a national application requirement in Germany. They were never recommended for general use, and have now been withdrawn by the user group concerned.
To enable all users of ONIX for Books Release 2.1 revisions 02 and 03 to to use the same master copies of the DTD and Schema for reference and validation purposes, the interactive reference copies on the EDItEUR website – whose locations are documented in Section 5 of the ONIX for Books Release 2.1 XML Message Specification – are updated to Revision 03. Those who continue to use Revision 02 will notice no change, except that a minor unintended restriction in Group PR.18 was corrected (if you use Group PR.18, please see the Revision 03 release notes in the Product Record Specification).
To meet additional specific needs of ONIX implementations in Japan, another minor revision, 2.1 rev.04, was published in early 2011. This added a very small number of optional data elements and a new optional data attribute. This revision is not recommended for use outside Japan. Anyone wishing to use this version should contact EDItEUR or the Japan Publishing Organisation for Information Infrastructure Development (JPO). Similar functionality to meet the needs of ONIX users in Japan and China has also been added to ONIX 3.0 revision 1.
You can download Release 2.1 rev 03 directly from this page. If you need to consult the documentation and/or schemas for other releases back to 2.0, they are still available here.
- Download Release 2.1 format specifications (revision 03) with codelists Issue 21
- Download Release 2.1 DTD and graphical views (revision 03)
- Download Release 2.1 XML schema (revision 03) with codelists Issue 21
- Download Release 2.1 format specifications (revision 04) with codelists Issue 21 note that Revision 04 is intended for use in Japan only
- Download Release 2.1 format specifications (revisions 03/04) with codelists Issue 21 (HTML version) NEW note that this HTML version includes the Product Record Format and XML Message Specification in a single document (where PDF versions of the documentation include two separate documents)
Specifying different terms of supply in different territories
These guidelines – which are applicable to ONIX 2.1 – give details of how to specify agency terms in an ONIX message, using new code values added in March 2010. They will also be useful to senders who need to specify different terms in different supply territories, even if they are not adopting an agency model.
The ONIX for Books Supply Update message format has been developed at the request of a number of ONIX user groups to enable price and availability and other supply-related data to be updated without the need to re-send a complete descriptive record for the product in question.
In effect, the Supply Update format allows SupplyDetail and/or MarketRepresentation composites, together with a very small number of related elements, to be replaced without sending any other parts of the ONIX record.
Use of the Supply Updates format is entirely optional. Its adoption should be agreed between trading partners or within an ONIX user group before it is brought into use.
The current release is Release 1.0, dated August 2006, and consistent with the ONIX for Books Product Information Message Release 2.1 revision 02 or 03. An outline specification is given in the Overview, which must be used in conjunction with the full specifications of the applicable ONIX for Books release.
- Download Supply Update Release 1.0 Overview (PDF)
- Download Supply Update Release 1.0 XML DTD and graphical views (ZIP)
- Download Supply Update Release 1.0 XML Schema with codelists Issue 20 (ZIP)
For details of the location of online reference versions of the DTD and Schema, see section 3 of the Supply Update message specification.
The ONIX for Books tagname converter is an XSLT script which enables ONIX reference names to be translated into short tags, and vice versa. The XSLT script and instructions for its use are available here. In its present form, the converter is suitable only for use with ONIX releases up to and including ONIX 2.1 rev 03. It cannot be used with Release 3.0.
Pour les utilisateurs des pays francophones, il existe une traduction en français des ONIX Version 2.1 (03), avec autre documents réalisée sous le contrôle du groupe ONIX France et avec le soutien du Cercle de la Librairie (Paris), disponible sur le site:
- Message Information Produit Aperçu et Eléments
- Message de mise à jour des informations de distribution Aperçu French language version
A German translation of the Supply Update Overview is also available: