API de précommande

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écommande. 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écommande:

Les règles suivantes peuvent être appliquées afin de déterminer quels sont les publications qui sont disponibles en précommande:

État : <ProductAvailability>40</ProductAvailability> (non disponible à la vente)

Date à partir de laquelle il est possible de faire des précommandes :

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

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