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