Étant donné que le catalogue du libraire n'est pas synchronisé en temps réel avec celui de la plateforme Cantook, il est possible que certaines différences existent entre les deux catalogues au moment précis de la vente d'un livre. Ce service Web permet au libraire de vérifier que tous les paramètres requis pour déclarer une vente sont toujours valides, ce qui lui confirmera que la vente est toujours possible.


Lors de cette simulation, la vente n'est pas enregistrée sur la Plateforme. La vente doit être déclarée via le service Vente d'une publication.


Déclaration

Adresse :  /api/organisations/[organisation_id]/publications/[isbn]/sales/new

Méthode : GET

Sécurité : HTTP/BASIC (Nom d'utilisateur et mot de passe)


Paramètres

organisation_id : (Obligatoire)

Numéro d'organisation. Fourni lors de l'inscription.


isbn  (Obligatoire)

ISBN de la publication.


format  (Obligatoire)

Format de la publication vendue (pdf/epub/mobi/audio/proof).


cost  (Obligatoire)

Prix de vente en centime (Ex. 19,99 $ => 1999).


protection :  (Obligatoire)

Type de protection de la publication vendue (open/watermark/acs4/acs4_timelimited/drm/drm_timelimited).


drm_type :  (Optionnel)

Type de DRM de la publication vendue (acs/lcp/urms).


country :  (Obligatoire)

Pays qui sera considéré pour valider le prix de la publication. Format ISO 3166-1 Alpha-3 (can, fra, ita) ou Alpha-2 (CA, FR, IT).


cost_without_taxes :  (Optionnel / Obligatoire sur Eden Livres)

Prix hors taxes, dans le pays du client, en centimes (ex. : 19,99$ => 1999)


price_type :  (Optionnel)

Le type de prix ONIX qui sera utilisé pour la validation du prix de la publication. Valeurs acceptées de la liste 58 : 01, 02, 03, 04, 41 et 42.


currency :  (Obligatoire)

La devise qui sera utilisée pour la validation du prix de la publication. Codes à 3 lettres ISO-4217.


Réponses

200 : valid

La simulation a été exécutée avec succès.


400 : cannot_sell

L'organisation ne peut pas vendre cette publication.


400 : missing_format

Le format est absent de la requête.


400 : invalid_format

Le format fourni n'est pas disponible pour cette publication.


400 : missing_cost

Le prix est absent de la requête.


400 : invalid_sale_parameters

Soit le cost, country, currency ou price_type est invalide.


400 : missing_protection

Le type de protection est absent de la requête.


400 : invalid_protection

Cette protection n'est pas disponible dans ce form.


400 : invalid_country

Le code de pays n'est pas valide.


400 : invalid_price_type

Le type de prix est invalide.


401 : access_denied

Accès refusé à la ressource.


404 : not_found

L'organisation ou l'ISBN n'ont pu être trouvés.


503 : service_unavailable

Le serveur a des difficultés à se connecter.


Notes

Dans le cas d'une erreur de type 400, le détail de l'erreur est fourni dans un vecteur.