You can easily import a batch of new publications, or modify the metadata of existing publications, using a file formatted according to the ONIX 2.1 standard.

For a general description of the import process, see this article. You can also import your data using ONIX version 3.0 or a dynamic Excel report.

Notez que l'importation par ONIX de métadonnées d'un livre audio comporte des particularités.

Formatting the ONIX 2.1 file

Structure of the ONIX 2.1 file

Below is a description of each of the available ONIX 2.1 tags.

Mandatory data

  • Mandatory-always: Indicates that the item is mandatory at all times.
  • Mandatory-Apple: Mandatory field for export to the Apple iBookstore.
  • Optional-Apple: Optional field for export to the Apple iBookstore. (Adds value and improves the quality of the data exchanged).


 MandatoryData type ONIX 2.1 tag
 Description / Recommended values

Mandatory-always

Enveloppe du message

<Header>

Permet de distinguer ONIX de l’importation XML Standard sur la plateforme

Mandatory-always

Nom de l’expéditeur

<FromCompany>

Nom de votre entreprise


Nom du destinataire

<ToCompany>

ENQC

Mandatory-always

Date d'envoi

<SentDate>

AAAAMMJJ ou AAAAMMJJHHMM


Message particulier

<MessageNote>

Texte ou commentaire, max 500 cars


Langue par défaut des textes

<DefaultLanguageOfText>

      fre: 
Langue Française

Liste: 74


Type de prix par défaut

<DefaultPriceTypeCode>

      03: 
Prix sans taxe

Liste: 58


Devise par défaut

<DefaultCurrencyCode>

  • can: Dollar Canadien
  • eur: Euro

Liste: 96



</Header>


Mandatory-always
Mandatory-Apple

Identification de l'article

<Product>


Mandatory-always

Identifiant unique

<RecordReference>

Code interne de l’émetteur ; correspond aussi au répertoire renfermant les fichiers importés


Type d’article

<NotificationType>

  • 03: Nouveau produit
  • 04: Mise à jour

Liste: 1

Mandatory-always
Mandatory-Apple

ISBN, EAN ou Custom

<ProductIdentifier>




<Publisher>




<PublisherName>

Nom de l'éditeur. Requis seulement lors d'une importation par diffuseur.


<PublisherRole>

01. Requis seulement lors d'une importation par diffuseur.


</Publisher>


Mandatory-always
Mandatory-Apple

Identification

<ProductIDType>

Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.

  • 01: Propriétaire (custom)
  • 02: ISBN-10
  • 03: EAN
  • 15: ISBN-13

Liste: 5

Mandatory-always
Mandatory-Apple

Valeur

<IDValue>

Valeur ISBN, EAN ou Custom



</ProductIdentifier>



Type de support

<ProductForm>

Description physique du support et reliure.

  • BA: Papier
  • DG: Numérique

Liste: 7


Type de format numérique

<EpubType>

Obligatoire si <ProductForm> = DG.

  • 002: PDF
  • 022: Mobi
  • 023 (029): EPUB

Liste: 10


Type de support - détail

<ProductFormDetail>

Description physique détaillée du support et reliure

Optional-Apple

Produit lié

<RelatedProduct>

Groupe répétable d'éléments qui ensemble décrivent un produit possédant un lien spécifié avec le produit décrit dans l'enregistrement ONIX. Permet de ne faire qu’un produit global renfermant tous les formats associés. Un produit papier décrit dans cette section sera automatiquement défini comme format alternatif de la publication en cours.

Mandatory-always
Optional-Apple

Relation produit lié

<RelationCode>

Code identifiant la nature de la relation entre deux produits

  • 01: Inclus (utiliser ce code pour indiquer quels chapitres distincts sont inclus dans cette publication)
  • 02: Est une partie de (utiliser ce code pour indiquer qu'un chapitre distinct est une partie du livre complet)
  • 06: X est un format alternatif du produit Y
  • 13: X est une epublication basée sur le produit papier Y

Liste: 51

Mandatory-always
Optional-Apple

ISBN, EAN ou Custom

<ProductIdentifier>


Mandatory-always
Optional-Apple

Identification

<ProductIDType>

Il faut un seul de ces identifiants obligatoirement, avec ou sans tirets. La plateforme fera les conversions nécessaires.

  • 01: Propriétaire (custom)
  • 02: ISBN-10
  • 03: EAN
  • 15: ISBN-13

Liste: 5

Mandatory-always
Optional-Apple

Valeur

<IDValue>

Valeur ISBN, EAN ou Custom



</ProductIdentifier>


Optional-Apple

Type de support

<ProductForm>

Description physique du support et reliure.

  • BA: Papier
  • DG: Numérique

Liste: 7

Optional-Apple

Type de format numérique

<EpubType>

Obligatoire si <ProductForm> = DG.

  • 002: PDF
  • 023: ePub

Liste: 10



</RelatedProduct>




<SalesRights>




<SalesRightsType>

Défini le statut de vente

  • 01: Disponible à la vente
  • 02: Disponible à la vente
  • 03: Consultation seulement


</SalesRights>


Mandatory-Apple

Prix

<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>

Cette section est répétable pour chaque pays nécessitant un prix et sa devise.

Mandatory-Apple

Pays

<CountryCode>

Le code de pays ISO 3166-1 (2 caractères) pour lequel le prix est valide.

Mandatory-Apple

Type de prix

<PriceTypeCode>

Facultatif si défini dans le message header

      03: 
Prix sans taxe

Liste: 58

Mandatory-Apple

Montant

<PriceAmount>

Ex.: 18,99 ou 18.99

Mandatory-Apple

Devise

<CurrencyCode>

Si différent de <DefaultCurrencyCode> (Voir message Header)

  • CAD: Dollar Canadien
  • EUR: Euro

Liste: 96

Afin d'importer un prix Groupe Euro, ne pas inclure la balise CountryCode, et inclure le CurrencyCode à EUR pour ce prix.



</Price>




</SupplyDetail>


Optional-Apple

Séries

<Series>


Optional-Apple

Collection

<TitleOfSeries>

Titre complet de la collection

Optional-Apple

Séries - Titre d’ensemble

<NumberWithinSeries>

Titre complet de l’ensemble



</Series>



Set

<Set>



Collection

<TitleOfSet>

Titre complet de la collection


Numéro dans la collection

<ltemNumberWithinSet>

Numéro du produit dans la collection



</Set>


Mandatory-Apple

Titre

<Title>


Mandatory-always
Mandatory-Apple

Type de titre

<TitleType>

  • 01: Titre distinctif
  • 10: Titre du distributeur

Liste: 15

Mandatory-always
Mandatory-Apple

Texte du titre

<TitleText>



Préfixe du titre

<TitlePrefix>



Sous-titre

<Subtitle>




</Title>


Mandatory-Apple

Auteur, illustrateur, photographe...

<Contributor>

Dans le cas d'exportation vers le Apple iBookstore, cette section doit comporter au moins un contributeur primaire pour que la publication soit acceptée.

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 de contribution

<ContributorRole>

Dans le cas d'exportation vers le Apple iBookstore, au moins 1 contributeur doit correspondre aux codes marqués d'un astérique ci-dessous (contributeur primaire).

  • *A01: Auteur
  • *A02: Avec
  • *A06: Fait par le compositeur
  • *A07: Fait par l'artiste
  • *A08: Fait par le photographe
  • *A99: Autre créateur primaire
  • A12: Illustratations par
  • A15: Préface par
  • A16: Prologue par
  • B06: Traduit par
  • E03: Narrateur

Liste: 17

Mandatory-always
Mandatory-Apple

Nom complet

<PersonName>

Prénom (initiales) et nom de famille


Nom inversé

<PersonNameInverted>

Nom de famille et prénom (initiales)


Pays

<CountryCode>

Pays du contributeur


Site Internet

<WebsiteLink>

Site Internet du contributeur


Facebook / Twitter

<Website>




<WebsiteRole>

42


<WebsiteLink>

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

http://twitter.com/username



</Website>




</Contributor>



Classification (Sujets, thèmes ou genres)

<MainSubject>

Classification primaire pour la publication (Unique, et ne peut pas être des mots-clés, voir classification additionnelles)

Mandatory-always

Identification

<MainSubjectSchemeIdentifier>

  • 01: Dewey
  • 10: BISAC Subject Heading
  • 24: Genres par défaut
  • 28: Thèmes Electre
  • 29: CLIL

Liste: 26

Mandatory-always

Code

<SubjectCode>

Valeur du code.



</MainSubject>



Classification (Sujets, thèmes ou genres)

<Subject>

Classification additionnelle (Répétable)

Mandatory-always

Identification

<SubjectSchemeIdentifier>

  • 01: Dewey
  • 10: BISAC Subject Heading
  • 20: Mots clés
  • 24: Genres par défaut
  • 28: Thèmes Electre
  • 29: CLIL

Liste: 26

Mandatory-always

Code

<SubjectCode>

Valeur du code (Obligatoire seulement si MainSubjectSchemeIdentifier n'est pas '20')


Description

<SubjectHeadingText>

Seulement si MainSubjectSchemeIdentifier est '20': Mots clés séparés par des point-virgules (;)



</Subject>



Type de public

<Audience>



Identification liste de public type

<AudienceCodeType>

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

Liste: 29


Nom de la liste

<AudienceCodeTypeName>

BTLF; Electre


Code local du type de public

<AudienceCodeValue>

Valeur du code.



</Audience>


Mandatory-Apple

Résumé

<OtherText>


Mandatory-Apple

Identification

<TextTypeCode>

      01: 
Description principale (résumé)

Liste: 33

Mandatory-Apple

Contenu

<Text>

Texte



</OtherText>



Commentaires

<OtherText>



Identification

<TextTypeCode>

      42: 
Commentaires

Liste: 33


Contenu

<Text>

Texte



</OtherText>



Présentation

<OtherText>



Identification

<TextTypeCode>

      18: 
Présentation couverture arrière

Liste: 33


Contenu

<Text>

Texte



</OtherText>



Photo de l'auteur

<MediaFile>



Identification

<MediaFileTypeCode>

  • 04: Couverture principale
  • 08: Photo d'un contributeur
  • 0323: Image: Extrait
  • 24: Couverture arrière
  • 27: Couverture autre
  • 32: Entrevue vidéo avec l'auteur
  • 35: Vidéo: Extrait
  • 36: Vidéo promotionel
  • 37: Critique vidéo
  • 42: Entrevue audio avec l'auteur
  • 44: Audio: Extrait
  • 45: Audio promotionel
  • 46: Critique audio
  • 51: Application: Extrait

Liste: 38



<MediaFileFormatCode>

    03

Type de lien

<MediaFileLinkTypeCode>

  • 01: Lien Web
  • 06: Fichier

Liste: 40


Fichier

<MediaFileLink>

Adresse du lien web ou nom complet du fichier envoyé


Titre

<DownloadCaption>

Titre du média


Description

<TextWithDownload>

Description du média (facultatif)



</MediaFile>


Optional-Apple

Traduit de

<Language>


Optional-Apple

Rôle

<LanguageRole>

      02: 
Langage original – texte traduit

Liste: 22

Optional-Apple

Code de langue

<LanguageCode>

  • eng: Anglais
  • fre: Français

Liste: 74



</Language>



Site web produit

<ProductWebSite>



Lien Internet

<ProductWebsiteLink>

URL du site web produit



</ProductWebSite>



Pages en chiffre romain

<PagesRoman>

Nombre de pages en début de publication en chiffre romain


Date de publication

<PublicationDate>




<Date>

AAAAMMJJ ou AAAAMMJJHHMM



</PublicationDate>



Type de protection à utiliser

<EpubTechnicalProtection>

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

Liste: 144 (ONIX 3)


Nombre de pages

<Extent>

Si cet élément n'est pas présent, le nombre de page sera automatiquement déterminé à partir du fichier envoyé



<ExtentType>

00 (nombre de pages du contenu principal)

Liste: 23 (ONIX 3)



<ExtentUnit>

03 (en pages)

Liste: 24 (ONIX 3)



<ExtentValue>

Nombre de pages



</Extent>



Texte original

<EditionTypeCode>




<NoEdition>

Ajouter cette balise (vide) si ceci est la version originale du texte



</EditionTypeCode>




</Product>




</ONIXMessage>


Importer le fichier dans votre catalogue

Référez-vous aux articles sur la procédure d'importation pour structurer et importer vos données.