Importation au format Onix 2.1

Ce document décrit la procédure à suivre pour importer facilement un lot de nouvelles publications, ou pour modifier les métadonnées de vos publications existantes, à l'aide du standard Onix 2.1. Pour une description générale du processus d'importation, consultez cette capsule. Vous pouvez aussi importer vos données en utilisant Onix version 3.0les données d'un chiffrier ou par notre XML spécifique.


Étape 1 : Structure du fichier ONIX 2.1

Vous trouverez, ci-dessous, une description de chacune des balises disponibles.

    Obligatoire-toujours : Indique que l'élément est obligatoire en tout temps.
  • Obligatoire-Apple : Champs obligatoire pour l'exportation vers le Apple iBookstore.
  • Optionnel-Apple : Champs optionnel pour l'exportation vers le Apple iBookstore. (Ajoute de la valeur et améliore la qualité des données échangées.)

 Obligatoire  Type de données
 Balise ONIX 2.1
 Description / Valeurs suggérées
Obligatoire-toujours

Enveloppe du message

<Header>

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

Nom de l’expéditeur

<FromCompany>

Nom de votre entreprise

 

Nom du destinataire

<ToCompany>

ENQC

Obligatoire-toujours

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>

 
Obligatoire-toujours
Obligatoire-Apple

Identification de l'article

<Product>

 
Obligatoire-toujours

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

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

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

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

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

Obligatoire-toujours
Optionnel-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

Obligatoire-toujours
Optionnel-Apple

ISBN, EAN ou Custom

<ProductIdentifier>

 
Obligatoire-toujours
Optionnel-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

Obligatoire-toujours
Optionnel-Apple

Valeur

<IDValue>

Valeur ISBN, EAN ou Custom

   

</ProductIdentifier>

 
Optionnel-Apple

Type de support

<ProductForm>

Description physique du support et reliure.

  • BA : Papier
  • DG : Numérique

Liste : 7

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

 
Obligatoire-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é.

Obligatoire-Apple
 

<Price>

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

Obligatoire-Apple

Pays

<CountryCode>

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

Obligatoire-Apple

Type de prix

<PriceTypeCode>

Optionnel si défini dans le message header

    03 : Prix sans taxe

Liste : 58

Obligatoire-Apple

Montant

<PriceAmount>

Ex : 18,99 ou 18.99

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

 
Optionnel-Apple

Séries

<Series>

 
Optionnel-Apple

Collection

<TitleOfSeries>

Titre complet de la collection

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

 
Obligatoire-Apple

Titre

<Title>

 
Obligatoire-toujours
Obligatoire-Apple

Type de titre

<TitleType>

  • 01 : Titre distinctif
  • 10 : Titre du distributeur

Liste : 15

Obligatoire-toujours
Obligatoire-Apple

Texte du titre

<TitleText>

 
 

Préfixe du titre

<TitlePrefix>

 
 

Sous-titre

<Subtitle>

 
   

</Title>

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

Obligatoire-Apple

Séquence

<SequenceNumber>

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

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

Obligatoire-toujours
Obligatoire-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)

Obligatoire-toujours

Identification

<MainSubjectSchemeIdentifier>

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

Liste : 26

Obligatoire-toujours

Code

<SubjectCode>

Valeur du code.

   

</MainSubject>

 
 

Classification (Sujets, thèmes ou genres)

<Subject>

Classification additionnelle (Répétable)

Obligatoire-toujours

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

Obligatoire-toujours

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>

 
Obligatoire-Apple

Résumé

<OtherText>

 
Obligatoire-Apple

Identification

<TextTypeCode>

    01 : Description principale (résumé)

Liste : 33

Obligatoire-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 (Optionnel)

   

</MediaFile>

 
Optionnel-Apple

Traduit de

<Language>

 
Optionnel-Apple

Rôle

<LanguageRole>

    02 : Langage original – texte traduit

Liste : 22

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

 

Étape 2 : Importer le fichier dans votre compte

Référez vous à la capsule générale d'importation pour bien structurer et importer vos données.