Les libraires peuvent offrir la possibilité à leurs clients d'acheter à l'avance les publications qui sont offertes en pré-vente. Lorsqu'une pré-vente est enregistrée, le libraire doit la déclarer en utilisant l'API de pré-vente. Dès que la publication devient disponible à la vente, une vente correspondant à chaque pré-vente doit être déclarée via l'API de vente. L'identifiant de client (customer_id) doit correspondre à celui qui a été utilisé pour faire la pré-commande. Le téléchargement de la publication sera disponible dès que la vente aura été déclarée, via le service web Téléchargement d'une publication.
Publications disponibles en pré-vente
Les règles suivantes peuvent être appliquées afin de déterminer quels sont les publications qui sont disponibles en pré-vente :
Date à partir de laquelle il est possible de faire des pré-commandes :
<PublishingDate>
<PublishingDateRole>09</PublishingDateRole>
<DateFormat>14</DateFormat>
<Date>20131107T000000-0500</Date>
</PublishingDate>
La date de disponibilité prévue est indiquée dans le flux ONIX de la façon suivante (cette date doit donc être dans le futur) :
<SupplyDate>
<SupplyDateRole>02</SupplyDateRole>
<DateFormat>14</DateFormat>
<Date>2012-10-25T00:00:00-04:00</Date>
</SupplyDate>
Déclaration
Adresse : /api/organisations/[organisation_id]/publications/[publication_id]/preorders
Méthode : POST
Sécurité : HTTP/BASIC (Nom d'utilisateur et mot de passe)
Paramètres
organisation_id : (Obligatoire)
Id de l'organisation qui a fait la vente
publication_id : (Obligatoire)
Identifiant (ISBN, EAN ou clé interne) de la publication
for : (Obligatoire)
epub ou pdf
customer_id : (Obligatoire)
Le customer_id de la précommande
Réponses
200 : created
La pré-vente a été enregistrée.
401
Problème d'authentification utilisateur.
404
La publication n'a pas été trouvée.