Introduction

This guide allows for electronic publications in PDF and EPUB formats, as well as associated metadata and image, audio and video files to be integrated on the Platform. This guide deals with the addition of new files and the modification of files and information already present on the Platform.

Description of the XML File Tags According to the ONIX 2.1 Standard

You will find, below, a description of each of the available tags.

  • Mandatory-always : State that the element is always mandatory
  • Mandatory-Apple : Field is mandatory for the Apple iBookstore's export.
  • Optional-Apple : Field is optional for the Apple iBookstore's export. (Value-added to the data exported to Apple)

 Mandatory Type of data
 ONIX Tag
Description / Suggested Values
Mandatory-always 

<ONIXMessage>

Allows to distinguish ONIX from the Standard XML import on the platform

Mandatory-always

Message envelope

<Header>

 
Mandatory-always

Name of sender

<FromCompany>

Name of your company

 

Name of recipient

<ToCompany>

ENQC

Mandatory-always

Sending date

<SentDate>

AAAAMMDD or AAAAMMDDHHMM

 

Particular message

<MessageNote>

Text or comment, max 500 chars

 

Default text language

<DefaultLanguageOfText>

  • fre : French language

List : 74

 

Default price type

<DefaultPriceTypeCode>

  • 03 : Price before tax

List : 58

 

Default currency

<DefaultCurrencyCode>

  • can : Canadian dollar
  • eur : Euro

List : 96

  

</Header>

 
Mandatory-always
Mandatory-Apple

Article identification

<Product>

 
Mandatory-always

Unique identifier

<RecordReference>

Internal code of the transmitter; also corresponds to the directory containing the imported files

 

Type of article

<NotificationType>

  • 03 : New product
  • 04 : Update

List : 1

Mandatory-always
Mandatory-Apple

ISBN, EAN or Custom

<ProductIdentifier>

 
Mandatory-always
Mandatory-Apple

Identification

<ProductIDType>

Only one of these identifiers is required, with or without dashes. The platform will make the necessary conversions.

  • 01 : Owner (custom)
  • 02 : ISBN-10
  • 03 : EAN
  • 15 : ISBN-13

List : 5

Mandatory-always
Mandatory-Apple

Value

<IDValue>

ISBN, EAN or Custom value

  

</ProductIdentifier>

 
 

Support type

<ProductForm>

Physical description of support and binding

  • BA : Paper
  • DG : Electronic

List : 7

 

Type of electronic format

<EpubType>

Required if = DG.

  • 002 : PDF
  • 022 : Mobi
  • 023 (or 029) : ePub

List : 10

 

Support type - detail

<ProductFormDetail>

Detailed physical description of support and binding

Optional-Apple

Linked product

<RelatedProduct>

A repeatable group of elements which together describe a product with a specified link to the product described in the ONIX recording. Allows for the creation of one global product encompassing all the associated formats.

Mandatory-always
Optional-Apple

Linked product relationship

<RelationCode>

Code identifying the nature of the relationship between two products

  • 01 : Includes (this product includes the following products as distinct items)
  • 02 : Is part of (this product is a part of the following item)
  • 06 : X is an alternative format of product Y
  • 13 : X is an epublication based on the paper product Y

List : 51

Mandatory-always
Optional-Apple

ISBN, EAN or Custom

<ProductIdentifier>

 
  

<Publisher>

 
  

<PublisherName>

Name of publisher. Required only if importing from the distributor's account.
  

<PublisherRole>

01, only if previous field is present.
  

</Publisher>

 
Mandatory-always
Optional-Apple

Identification

<ProductIDType>

Only one of these identifiers is required, with or without dashes. The platform will make the necessary conversions.

  • 01 : Owner (custom)
  • 02 : ISBN-10
  • 03 : EAN
  • 15 : ISBN-13

List : 5

Mandatory-always
Optional-Apple

Value

<IDValue>

ISBN, EAN or Custom value

  

</ProductIdentifier>

 
Optional-Apple

Support type

<ProductForm>

Physical description of support and binding

  • BA : Paper
  • DG : Electronic

List : 7

Optional-Apple

Type of electronic format

<EpubType>

Required if = DG.

  • 002 : PDF
  • 023 : ePub

List : 10

  

</RelatedProduct>

 
  

<SalesRights>

 
  

<SalesRightsType>

Defines the sale status

  • 01 : Available for sale
  • 02 : Available for sale
  • 03 : Consultation only
  

</SalesRights>

 
Mandatory-Apple

Price

<SupplyDetail>

Dans le cas d'exportation vers le Apple iBookstore, cette section servira à déterminer les territoires permis à la vente, avec leur prix et leur devise approprié.

Mandatory-Apple
 

<Price>

This section is repeatable for each country requiring a cost and a currency.

Mandatory-Apple

Country

<CountryCode>

ISO 3166-1 country code (2 characters) for which price is related.

Mandatory-Apple

Price type

<PriceTypeCode>

Optional if specified in header message

  • 03 : Price before tax

List : 58

Mandatory-Apple

Amount

<PriceAmount>

Eg. 18,99 or 18.99

Mandatory-Apple

Currency

<CurrencyCode>

If different from (See header message)

  • CAD : Canadian dollar
  • EUR : Euro

List : 96

In order to import a Euro Zone price, include the CountryCode tag set to EUR, but do not include the CountryCode tag.

  

</Price>

 
  

</SupplyDetail>

 
Optional-Apple

Series

<Series>

 
Optional-Apple

Collection

<TitleOfSeries>

Full title of the collection

Optional-Apple

Series - Title of the series

<NumberWithinSeries>

Full title of the series

  

</Series>

 
 

Set

<Set>

 
 

Collection

<TitleOfSet>

Full title of the collection

 

Number in the collection

<ltemNumberWithinSet>

Product number in the collection

  

</Set>

 
Mandatory-Apple

Title

<Title>

 
Mandatory-always
Mandatory-Apple

Type of title

<TitleType>

  • 01 : Unique title
  • 10 : Title of distributor

Liste : 15

Mandatory-always
Mandatory-Apple

Title text

<TitleText>

 
 

Title prefix

<TitlePrefix>

 
 

Subtitle

<Subtitle>

 
  

</Title>

 
Mandatory-Apple

Author, illustrator, photographer…

<Contributor>

In case of Apple iBookstore's export, this section must contain at least one primary contributor to get the publication accepted.

Mandatory-Apple

Séquence

<SequenceNumber>

Position/ordre à lequel doit figuré le contributeur lorsque plusieurs pour une même publication, "1" étant le contributeur primaire.

Mandatory-always
Mandatory-Apple

Type of contribution

<ContributorRole>

In case of Apple iBookstore's export, at least 1 contributor must be related to a role flagged with the symbol *. (Primary contributor)

  • *A01 : Author
  • *A02 : With
  • *A06 : Made by the compositor
  • *A07 : Made by the artist
  • *A08 : Made by the photograph
  • *A99 : Other primary creator
  • A12 : Illustratations by
  • A13 : Photographs par
  • A15 : Preface by
  • A16 : Prologue by
  • B06 : Translated by
  • E03 : Narrator

Liste : 17

Mandatory-always
Mandatory-Apple

Full name

<PersonName>

First (initials) and last name

 

Name inverted

<PersonNameInverted>

Last name and first name (initials)

 

Country

<CountryCode>

Country of contributor

 

Website

<WebsiteLink>

Contributor's website

 

Website

<Website>

 
 

Website

<WebsiteRole>

42
 Website

<WebsiteLink>

http://www.facebook.com/username or

http://twitter.com/username

  

</Website>

 
  

</Contributor>

 
 

Themes and genres

<MainSubject>

Primary classification for the publication (unique, it cannot be a keyword, see additional classification)

Mandatory-always

Identification

<MainSubjectSchemeIdentifier>

  • 01 : Dewey
  • 10 : BISAC Subject Heading
  • 24 : Default genres
  • 28 : Themes genres Electre
  • 29 : CLIL

List : 26

Mandatory-always

Code

<SubjectCode>

Code value.

  

</MainSubject>

 
 

Classification (subjects, themes or genres)

<Subject>

Additional classification (repeatable)

Mandatory-always

Identification

<SubjectSchemeIdentifier>

  • 01 : Dewey
  • 10 : BISAC Subject Heading
  • 20 : Keywords
  • 24 : Default genres
  • 28 : Electre themes
  • 29 : CLIL

List : 26

Mandatory-always

Code

<SubjectCode>

Code value. (Mandatory only if MainSubjectSchemeIdentifier is not '20')

 

Description

<SubjectHeadingText>

Keywords separated by semi-colons (;)

  

</Subject>

 
 

Audience type

<Audience>

 
 

Audience type identification list

<AudienceCodeType>

  • 06 : BTLF Audience Code
  • 07 : Electre Audience Code

List : 29

 

List name

<AudienceCodeTypeName>

BTLF ; Electre

 

Local code of the audience type

<AudienceCodeValue>

Code value.

  

</Audience>

 
Mandatory-Apple

Summary

<OtherText>

 
Mandatory-Apple

Identification

<TextTypeCode>

  • 01 : Main description (summary)

Liste : 33

Mandatory-Apple

Content

<Text>

Text

  

</OtherText>

 
 

Comments

<OtherText>

 
 

Identification

<TextTypeCode>

  • 42 : Comments

List : 33

 

Content

<Text>

Text

  

</OtherText>

 
 

Presentation

<OtherText>

 
 

Identification

<TextTypeCode>

  • 18 : Back cover presentation

List : 33

 

Content

<Text>

Text

  

</OtherText>

 
 

Author picture

<MediaFile>

 
 

Identification

<MediaFileTypeCode>

  • 04 : Main cover
  • 08 : Contributor's picture
  • 23 : Image: Sample content
  • 24 : Back cover
  • 27 : Additional cover
  • 32 : Video interview with author
  • 35 : Video: Sample content
  • 36 : Video promotional
  • 37 : Video review
  • 42 : Audio interview with author
  • 44 : Audio: Sample content
  • 45 : Audio promotional
  • 46 : Audio review
  • 51 : Application: Sample content

List : 38

  

<MediaFileFormatCode>

  • 03
 

Link type

<MediaFileLinkTypeCode>

  • 01 : Web link
  • 06 : Filename

List : 40

 

File

<MediaFileLink>

Document name. No space or accents in file name.

 

Title

<DownloadCaption>

Title of media. If this file is a contributor's picture, it must match exactly the name of the contributor.

 

Description

<TextWithDownload>

Media description (optional)

  

</MediaFile>

 
Optional-Apple

Translated from

<Language>

 
Optional-Apple

Role

<LanguageRole>

  • 02 : Original language - translated text

List : 22

Optional-Apple

Language code

<LanguageCode>

  • eng : English
  • fre : French

List : 74

  

</Language>

 
 

Product website

<ProductWebSite>

 
 

Internet link

<ProductWebsiteLink>

Product website URL

  

</ProductWebSite>

 
 

Pages in roman numerals

<PagesRoman>

Number of pages at the beginning of the publication in roman numerals

 

Publication date

<PublicationDate>

 
  

<Date>

AAAAMMJJ or AAAAMMJJHHMM

  

</PublicationDate>

 
 

Type of protection to use

<ePub Technical Protection>

  • 00 : None (open)
  • 02 : Watermark
  • 03 : Adobe DRM (Adobe Content Server)

List : 144 (ONIX 3)

 

Number of pages

<Extent>

If this element is not present, the page number will be determined automatically based upon the file that has been sent

  

<ExtentType>

00 (number of pages of main content)

List : 23 (ONIX 3)

  

<ExtentUnit>

03 (in pages)

List : 24 (ONIX 3)

  

<ExtentValue>

Number of pages

  

</Extent>

 
 

Original text

<TypeCode editon>

 
  

<NoEdition>

Add this tag (empty) if this is the text's original version

  

</TypeCode editon>

 
  

</Product>

 
  

</ONIXMessage>