API PNB

API PNB

Gestion des versions de l'API PNB

A chaque évolution importante de PNB (par exemple la modification du WSDL : ajout de nouveaux services, …), le service passe de la version N à la version N+1. Le numéro de version commence par le numéro 1. Ce numéro est visible dans les URL(s) des services. La syntaxe est la suivante :

[ Nom de la plateforme PNB]/v[ numéro de version]/pnb-numerique/[nom de service]

Versions de l'API PNB

Numéro de version	Statut	URL WSDL	Date de mise en production	Date de désactivation de la version
1	Actif	v1	26-08-2014	30-06-2015 - ATTENTION - Disposition particulière pour les libraires qui doivent répondre aux exigences de la V2 dès le 30 avril 2015
2	Actif	v2	16-02-2015

Adresses de l'API PNB

Version SOAP : le WSDL est disponible via l'URL suivant :

plateforme de test: https://pnb-test.centprod.com/v[ numéro de version]/pnb-numerique/pnb-services.wsdl
plateforme de production: https://pnb-dilicom.centprod.com/v[ numéro de version]/pnb-numerique/pnb-services.wsdl

Exemple :

version n°2 (Plateforme de production) : https://pnb-dilicom.centprod.com/v2/pnb-numerique/pnb-services.wsdl
version n°2 (Plateforme de test) : https://pnb-test.centprod.com/v2/pnb-numerique/pnb-services.wsdl

Version REST : les différents services sont disponibles aux URL suivantes :

plateforme de test: https://pnb-test.centprod.com/v[ numéro de version]/pnb-numerique/json/[nom de service]
plateforme de production: https://pnb-dilicom.centprod.com/v[ numéro de version]/pnb-numerique/json/[nom de service]

Gestion des retours, gestion des erreurs et codes de retour

Le numéro de traitement d'une requête est systématiquement rappelé dans la réponse sous la forme : <pnb:requestId>xxxxxxxx</pnb:requestId> Ce numéro de traitement est utile pour toute correspondance avec PNB (SAV, tracing…)

Dans le cas d'erreur de traitement d'une requête PNB, le serveur PNB envoie une réponse contenant les champs returnStatus et une liste de returnMessage précisant l'erreur rencontrée. L'erreur peut être attachée au niveau de status global de la requête ou plus précisément au niveau de status d'une ligne de requête (si la requête est composée de plusieurs lignes; par exemple le service sendOrder).

Exemple SOAP :

<xxxxResponse>
	<returnStatus>AUTHENTICATION_ERROR</returnStatus>
	<returnMessage>Bad credentials</returnMessage >
</xxxxResponse>

Exemple REST :

{
	returnStatus:"AUTHENTICATION_ERROR",
	returnMessage: ["Bad credentials"]
}

Codes de retour (returnStatus)

Les codes de retours PNB sont resumés dans le tableau ci-dessous:

Code	Description
OK	La requête est traitée sans erreur (toutes les lignes de la requête sont traitées sans erreur)
WARNING	La requête est traitée avec des erreurs (erreur de traitement de quelques ou toutes les lignes de la requête)
ERROR	La requête n’est pas traitée. Ce code regroupe les erreurs suivantes : une erreur technique est survenue coté serveur PNB ou une erreur inconnue est survenue coté plateforme de distribution
INVALID_ARGUMENTS	Ce code regroupe les erreurs suivantes : les paramètres de la requête ne respectent pas le XSD, les paramètres de la requête ne sont pas valides, les paramètres obligatoires ne sont pas présents dans la requête
AUTHENTICATION_ERROR	Les informations d’authentification de l’utilisateur sont erronées
ACCES_DENIED	L’utilisateur n’a pas le droit d’accès à la ressource demandée
NOT_IMPLEMENTED	Le service demandé n’est pas implémenté
NOT_FOUND	La ressource demandée n’est pas trouvée
UNKNOWN_GLN	Le GLN fourni n’est pas référencé dans la base de fuel
DUPLICATED	L’existence de doublons
CANCELLED	Une commande ou une ligne de commande est annulée
DATE_TOO_OLD	La date fournie est plus âgée
PRODUCT_CANNOT_BE_SOLD	La ressource demandée n’est pas vendable
INVALID_PRICE	Le prix fourni par l’utilisateur n’est pas valide
PRODUCT_CANNOT_BE_LOAN	La ressource demandée ne peut pas être prêtée pour les raisons suivantes : le lien de téléchargement de la ressource n'est pas valide ou la ressource est déjà prêtée ou l’état de la référence de la ligne de commande vaut une valeur différente de « OK »
MAX_LOAN_QUANTITY_REACHED	La limite du nombre de prêts est atteinte
MAX_SIMULTANEOUS_LOAN_REACHED	Le nombre maximal de prêts simultanés a été atteint
LOAN_DURATION_EXPIRED	La durée de prêt a expiré

Codes de retour de base

La liste des codes de retour communs à tous les services PNB est la suivante :

OK,
WARNING,
ERROR,
INVALID_ARGUMENTS,
AUTHENTICATION_ERROR,
ACCES_DENIED,
NOT_IMPLEMENTED

Le tableau ci-dessous décrit en détail les codes de retour de base retournés par les services PNB:

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause	Remarque
OK		Requête	Toutes les lignes sont traitées sans erreur	Le serveur PNB peut renseigner le champ “returnMessage” pour donner plus de détails sur le traitement
OK		Ligne	La ligne de la requête est traitée sans erreur	Le serveur PNB peut renseigner le champ “returnMessage” pour donner plus de détails sur le traitement
WARNING	Some <nom de service> lines are returned with error	Requête	Quelques lignes sont traitées avec erreur
WARNING	All <nom de service> lines are returned with error	Requête	Toutes lignes sont traitées avec erreur	Ce code peut avoir un autre message d'erreur selon d'autres cas d'utilisation
ERROR	Internal error	Requête, Ligne	Une erreur technique est survenue coté PNB
ERROR	Unknown error occurred while calling <nom de la plateforme de distribution> service	Requête, Ligne	Une erreur inconnue est survenue coté plateforme de distribution	Cette erreur se produit lorsque la plateforme de distribution envoi un code d'erreur non reconnu par le serveur PNB
INVALID_ARGUMENTS	Spécifique selon le cas d’erreur	Requête, Ligne	Les paramètres de la requête ne respectent pas le XSD Les paramètres de la requête ne sont pas valides Les paramètres obligatoires ne sont pas présents dans la requêtes
AUTHENTICATION_ERROR	Bad credentials	Requête	Les informations d’authentification de l’utilisateur sont erronées
ACCES_DENIED	Authorization failure	Requête, Ligne	L’utilisateur n’a pas le droit d’accès au service PNB	Ce code peut avoir un autre message d'erreur selon d'autres cas d'utilisation
NOT_IMPLEMENTED	Spécifique selon le cas d’utilisation	Requête, Ligne	Le service demandé n’est pas implémenté

Service passer une commande : sendOrder

Le service sendOrder permet aux revendeurs d'acheter des offres de livre numérique pour le compte d'une collectivité.

Le revendeur ne peut commander qu'un seul exemplaire d'une offre par commande, la quantité est limitée à 1.

Si la commande est créée avec succès; le serveur PNB ne retourne pas l'URL(s) d'accès aux ressources. L'URL d'accès à une ressource n'est donné qu'au moment d'un emprunt ou d'une consultation.

Authentification

Les paramètres utilisés pour authentifier le service sendOrder sont:

glnReseller : identifiant du revendeur fourni par Dilicom,
passwordReseller : mot de passe du revendeur fourni par Dilicom.

glnReseller	Identifiant du revendeur	Obligatoire, numérique, 13 caractères
passwordReseller	Mot de passe du revendeur	Obligatoire, alphanumérique, max 25 caractères
glnColl	Gln collectivité	Obligatoire, numérique, 13 caractères
glnContractor	Gln du prestatataire	Facultatif jusqu'au 30 juin puis Obligatoire, numérique, 13 caractères
glnDelivery	Gln du “Livré à” dans le cas ou le glnReseller est un grossiste	Facultatif jusqu'au 30 juin puis Obligatoire, numérique, 13 caractères
orderId	Identifiant de la commande, (ou référence commande) provenant du système du revendeur. Ce paramètre doit être unique pour un glnReseller	Obligatoire, alphanumérique, max 16 caractères
orderIdColl	Identifiant de la commande, (ou référence commande) provenant du système de la collectivité	Obligatoire, alphanumérique, max 16 caractères
resellerCountry	Pays du revendeur	Obligatoire, ISO 3166-1 (liste 91 dans Onix)
collCountry	Pays de la collectivité	Obligatoire, ISO 3166-1 (liste 91 dans Onix)
orderRequestLine[]	Descriptif des lignes de commandes en entrée	Obligatoire, Tableau d’orderRequestLine

ean13	L'ean de l'offre	Obligatoire, numérique, 13 caractères
glnDistributor	Gln distributeur	Obligatoire, numérique, 13 caractères
unitPrice	Prix unitaire TTC utilisé par le revendeur. Exprimé en centimes. Entier non négatif. 1250 = 12,50	Obligatoire, nombre entier
unitPriceExcludingTax	Prix unitaire HT utilisé par le revendeur. Exprimé en centimes. Entier non négatif. 1250 = 12,50	Obligatoire, nombre entier
taxRate	Taux de taxe utilisé entre le revendeur et la collectivité. Entier non négatif. 20% = 2000	Conditionnel : Obligatoire dans le cadre des échanges avec Numilog, optionnel avec les autres plateformes, nombre entier, Max 5 caractères
quantity	La quantité de livre à commander	Obligatoire, nombre entier. La valeur par défaut est égale à 1. (la quantité est limitée à 1)
currency	Devise utilisée pour le prix.	Obligatoire, ISO 4217(Liste 96 Onix)
dmdDate	Date de début DMD	Obligatoire, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)
lineReference	Référence de la ligne de commande créée par le revendeur	Optionnel, alphanumérique, max 16 caractères
lineReferenceColl	Référence de la ligne de commande créée par la collectivité	Optionnel, alphanumérique, max 16 caractères

requestId	Identifiant de la requête	Optionnel, alphanumérique
orderId	Référence de la commande	Obligatoire, alphanumérique, max 16 caractères
orderResponseLine[]	Descriptif des lignes de commande en sortie	Obligatoire, Tableau d’orderResponseLine
returnStatus	L'état de traitement de la requête	Obligatoire, chaine de caractères. cf Codes de retour de base
returnMessage	Message d'erreur si la requête n'a pas été traitée correctement	Optionnel, chaine de caractères. cf Codes de retour de base

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
DUPLICATED	<glnReseller> : Order with referenceCommande <orderId> already exists	Requête	La référence de la commande existe déjà dans la base
DUPLICATED	The ean <ean13> is duplicated for glnDistributeur < glnDistributor >	Ligne	Le client a commandé plusieurs fois le même livre numérique
DUPLICATED	Order with referenceCommande <orderId> already exists	Ligne	La référence de la commande existe déjà dans la base de la plateforme de distribution
UNKNOWN_GLN	glnColl : <glnColl> is not referenced in the Customer Relationship Management	Requête	L’utilisateur avec le GLN « glnColl » n’existe pas dans la base du FUEL
UNKNOWN_GLN	Unsupported GlnDistributeur	Ligne	Le « glnDistributor » ne présente pas un GLN d’une plateforme de distribution connu par PNB
INVALID_ARGUMENTS	glnColl : <glnColl> is not a local authority	Requête	L’utilisateur avec le GLN « glnColl » n’est pas un utilisateur de type « collectivité »
INVALID_ARGUMENTS	glnDelivery : <glnDelivery> glnDelivery is invalid : unknown GLN	Requête	Le GLN « glnDelivery » n’est pas conforme
INVALID_ARGUMENTS	glnContractor: <glnContractor> glnContractor is invalid : unknown GLN	Requête	Le GLN « glnContractor» n’est pas conforme
INVALID_ARGUMENTS	The parameter quantity is invalid. The quantity is limited to 1	Ligne	La quantité de livre à commander est différente à 1
NOT_FOUND	The EAN13 <ean13> does not exist for Distributor GLN < glnDistributor >	Ligne	L’EAN du livre numérique à commander n’existe pas
ACCES_DENIED	You are not allowed to call service from this GlnDistributeur, please contact DILICOM	Ligne	L’utilisateur avec le GLN « glnReseller» n’est pas abonné à une plateforme de distribution ou l’organisation ID n’est pas trouvée coté plateforme de distribution
ACCES_DENIED	<glnColl> is not set to order for <gln Distributor>, please contact DILICOM	Ligne	La collectivité n’est pas paramétrée chez un distributeur
PRODUCT_CANNOT_BE_SOLD	The product can not be sold	Ligne	Le livre numérique ne peut pas être vendu
INVALID_PRICE	Invalid price	Ligne	Le prix TTC renseigné par l’utilisateur n’est pas valide
INVALID_ARGUMENTS	unitPriceWithoutTax is invalid : cannot be higher than unitPrice	Ligne	Le prix HT renseigné par l’utilisateur n’est pas valide
NOT_IMPLEMENTED	Service sendOrder not yet implemented for distributor : <distributeur>	Ligne	Le service demandé n’est pas implémenté
ERROR	Line rejected by <distributeur>	Ligne	Certains distributeurs peuvent gérer les commandes multi-lignes et avoir des erreurs à la ligne. Cette erreur se produit lorsqu’une commande contient une ou plusieurs lignes en erreur envoyées à un distributeur qui ne gère pas le détail des erreurs à la ligne. Dans ce cas le distributeur rejette toutes les lignes de la commande.

orderLineId	Identifiant de la ligne commande transmis par PNB	Obligatoire, numérique, 24 caractères
returnStatus	L'état de traitement de la ligne de requête	Obligatoire, chaine de caractères. cf Codes de retour
returnMessage	Message d'erreur si la ligne de requête n'a pas été traitée correctement	Optionnel, chaine de caractères. cf Codes de retour

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
NOT_FOUND	< glnReseller > : Order with referenceCommande '< orderId >' is not found	Requête	La référence de la commande à annuler n’existe pas dans la base
NOT_FOUND	The orderLineId < orderLineId > does not exist	Requête	La référence de la ligne de commande à annuler n’existe pas
CANCELLED		Ligne	la ligne de commande est bien annulée ou la ligne de commande n’a pas été passée chez le distributeur (c.-à-d. une ligne de commande avec returnStatus différent de OK)
NOT_IMPLEMENTED	Service CancelOrder not yet implemented for distributor : <distributeur>	Ligne	Le service demandé n’est pas implémenté

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
OK	The EAN13 <ean13> does not exist for Distributor GLN < glnDistributor >	Ligne	La notice identifiée par : <ean13> et <glnDistributor> n’existe pas dans la base PNB
OK	Notification type 05: This product is removed	Ligne	La notice est supprimée
OK	ProductAvailability 01: This product has been CANCELLED	Ligne	La notice n’est pas disponible. Code ProductAvailability = 01
OK	ProductAvailability 10: This product is not yet available	Ligne	La notice n’est pas disponible. Code ProductAvailability = 10
OK	ProductAvailability 30: This product is temporarily unavailable	Ligne	La notice n’est pas disponible. Code ProductAvailability = 30
OK	ProductAvailability 40: This product is not available	Ligne	La notice n’est pas disponible. Code ProductAvailability = 40
OK	ProductAvailability 46: This withdrawn from sale	Ligne	La notice n’est pas disponible. Code ProductAvailability = 46
OK	ProductAvailability 45: This product is unmarketable separately	Ligne	La notice n’est pas disponible. Code ProductAvailability = 45
UNKNOWN_GLN	Unsupported GlnDistributeur	Ligne	Le « glnDistributor » ne présente pas un GLN d’une plateforme de distribution connu par PNB
INVALID_PRICE	Invalid price	Ligne	Le prix fourni par l’utilisateur n’est pas valide
PRODUCT_CANNOT_BE_SOLD	The product can not be sold	Ligne	Le livre numérique ne peut pas être vendu
ACCES_DENIED	You are not allowed to call service from this GlnDistributeur, please contact DILICOM.	Ligne	L’utilisateur avec le GLN « glnReseller» n’est pas abonné à une plateforme de distribution ou l’organisation ID n’est pas trouvée coté plateforme de distribution

glnReseller	Identifiant du revendeur ou de la collectivité	Obligatoire, numérique, 13 caractères
passwordReseller	Mot de passe du revendeur ou de la collectivité	Obligatoire, alphanumérique, max 25 caractères
glnContractor	Gln du prestatataire	Facultatif jusqu'au 30 juin puis Obligatoire, numérique, 13 caractères
sinceDate	Date à partir de laquelle le client demande des mises à jour des notices	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm). La date ne doit pas être âgée de plus de 8 jours
lastConnection	Paramètre indiquant par sa présence la récupération des mises à jour depuis le dernier appel au service	Optionnel, chaîne vide (non null)

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
DATE_TOO_OLD	The date can't be older than 8 days	Requête	La date fournie est âgée de plus de 8 jours
ACCES_DENIED	Only 5 last connection requests are allowed within the previous 24 hours	Requête	Le client demande depuis la dernière connexion et il a déjà effectué cinq appels au service dans les dernières 24 heures
ACCES_DENIED	Not available for the moment, please contact DILICOM. Catalog can be provided by FTP	Requête	Le client demande depuis la dernière connexion mais c’est la première fois qu'il fait appel au service. C'est une demande d'initialisation de catalogue PNB que le client doit demander; cette demande n'est pas disponible en web service. cf Initialisation de catalogue PNB

glnColl	Identifiant de la collectivité	Obligatoire, numérique, 13 caractères
passwordColl	Mot de passe de la collectivité	Obligatoire, alphanumérique, max 25 caractères
glnContractor	Gln du prestatataire	Facultatif jusqu'au 30 juin puis Obligatoire, numérique, 13 caractères
sinceDate	Date à partir de laquelle les commandes ont passées	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)
orderIdColl	Référence commande provenant du système de la collectivité	Optionnel, alphanumérique, max 16 caractères
returnLinesWithError	Permet de choisir de recevoir ou pas les lignes de commande en erreur dans la réponse	Optionnel, Boolean. Si le champ returnLinesWithError n'est pas présent dans la requête alors la valeur par défaut vaut “false”

orderLineId	Référence de la ligne de commande générée par PNB	Obligatoire, alphanumérique, max 24 caractères
ean13	L'ean de l'offre	Obligatoire, numérique, 13 caractères
quantity	La quantité commandée	Obligatoire, nombre entier
beginDate	Date de début d'utilisation	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)
endDate	Date de fin prévue.	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)
endOfferDate	Date de fin. Ce champ est renseigné si l'offre achetée est expirée	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)
NUS1	Nombre d'utilisateurs simultanés possible à la date de suivi pour l’emprunt	Optionnel, nombre entier
NUS2	Nombre d'utilisateurs simultanés possible à la date de suivi pour la consultation	Optionnel, nombre entier
NTA	Nombre d'accès restants à la date de suivi	Optionnel, nombre entier
returnStatus	Si la ligne n'a pas été passée chez le distributeur alors le serveur PNB envoi le statut d'erreur généré lors du traitement de la ligne de commande. (cf Codes de retour sendOrder ); sinon cf ( Codes de retour)	Obligatoire, chaine de caractères.
returnMessage	Si la ligne n'a pas été passée chez le distributeur alors le serveur PNB envoi le message d'erreur généré lors du traitement de la ligne de commande (cf Codes de retour sendOrder); sinon cf Codes de retour	Optionnel, chaine de caractères.

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
NOT_IMPLEMENTED	Service getLoanStatus not yet implemented for distributor : <nom de la plateforme de distribution>	Ligne	La ligne de commande a été bien traitée ( ligne avec un statut OK ) et le service getLoanStatus n’est pas implémenté coté plateforme de distribution
WARNING	Unknown error occurred while calling getLoanStatus <nom de la plateforme de distribution> service platform.	Ligne	La ligne de commande a été bien traitée ( ligne avec un statut OK ) et une erreur est survenue lors de l'appel de service getLoanStatus de la plateforme de distribution

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
INVALID_ARGUMENTS	Ip range is not valid (size > 1000 ips) [<ips>].	Requête	La plage d’adresses IP dépasse 1000
INVALID_ARGUMENTS	Ip range is not valid [<ips>].	Requête	La plage d’adresses IP n’est pas valide
OK	Warn : < ips > already declared.	Requête	L’adresse IP est déjà présente dans la base
WARNING	Unknown error occurred while calling <nom de la plateforme de distribution> service platform	Requête	Une erreur est survenue côté plateforme de distribution

url	URL d'accès à la ressource empruntée	Obligatoire, chaine de caractères
format	Format de la ressource empruntée	Optionnel, chaine de caractères
formatDescription	Description rapide du format de la ressource empruntée. Par exemple : pdf, epub,…	Obligatoire, chaine de caractères
ean13	L'ean13 de la ressource empruntée	Obligatoire, alphanumérique, max 13 caractères
mimeType	Mime Type de la ressource empruntée. Par exemple: application/epub+zip	Optionnel, chaine de caractères

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
INVALID_ARGUMENTS	invalid expiration date	Requête	La date de fin de prêt n'est pas valide
INVALID_ARGUMENTS	The parameter loanEndDate is invalid. The loan duration is over maximum autorized limit	Requête	La durée du prêt est plus grande que le maximum autorisé
NOT_FOUND	The orderLineId <orderLineId> does not exist	Requête	La collectivité n’a pas passé de commande avec la référence de ligne de commande «orderLineId »
NOT_FOUND	<glnColl> : The ean <ean13> is not a part of orderLine '<orderLineId>'!	Requête	La collectivité a fourni un EAN qui ne correspond pas à l’EAN associe à la ligne de commande « orderLineId »
DUPLICATED	<glnColl>: Loan with id '< loanId >' already exists	Requête	Est considéré comme doublon un prêt ayant un loanid déjà utilisé dans une demande de prêt valide pour une collectivité donnée. Si l’ensemble des données glnColl, orderLineId, loanId, ean13, accessMedium, localization et loanEndDate de la requête est identique à une demande de prêt déjà passée dans l’heure, alors, la requête n’est pas considérée comme un doublon, mais retourne les informations de la réponse au prêt initial.
ACCES_DENIED	<glnColl>: The ip adress '<ipAddress> is not declared in PNB and localization IN_SITU.	Requête	La collectivité n’a pas déclarée l’adresse IP
ACCES_DENIED	<glnColl>: The ip adress is null and localization IN_SITU.	Requête	La collectivité demande d’effectuer un prêt de type IN_SITU sans fournir l’adresse IP
NOT_IMPLEMENTED	Service loanBook not yet implemented for distributor : <GLN distributeur>	Requête	Le service demandé n’est pas implémenté pour le distributeur
NOT_IMPLEMENTED	Service loanBook in streaming mode is not implemented for distributor : <distributor name>	Requête	Le service d’emprunt en mode streaming n’est pas implémenté chez le distributeur
PRODUCT_CANNOT_BE_LOAN	The product cannot be loan	Requête	La ressource demandée ne peut pas être empruntée parce que Le lien n'est pas valide ou la ressource est déjà prêtée ou l’état de la référence de la ligne de commande vaut une valeur différente de « OK »
MAX_LOAN_QUANTITY_REACHED	The loan number limit is reached.	Requête	La ressource demandée ne peut pas être empruntée car la limite du nombre de prêts est atteinte
LOAN_DURATION_EXPIRED	The loan duration is expired.	Requête	La durée de prêt a expiré
MAX_SIMULTANEOUS_LOAN_REACHED	The maximum number of simultaneous downloads loans is reached.	Requête	Le nombre maximal de prêts simultanés de telechargement a été atteint.
MAX_SIMULTANEOUS_LOAN_REACHED	The maximum number of on-site consultation is reached.	Requête	Le nombre maximal de consultations sur site a été atteint.
MAX_SIMULTANEOUS_LOAN_REACHED	The maximum number of off-site consultation is reached.	Requête	Le nombre maximal de consultations hors site a été atteint.

url	URL d'accès à la ressource	Obligatoire, chaine de caractères
format	Format de la ressource	Optionnel, chaine de caractères
formatDescription	Description rapide du format de la ressource. Par exemple : pdf, epub,…	Obligatoire, chaine de caractères
ean13	L'ean13 de la ressource	Obligatoire, alphanumérique, max 13 caractères
mimeType	Mime Type de la ressource. Par exemple: application/epub+zip	Optionnel, chaine de caractères

orderLineId	Référence de la ligne de commande générée par PNB	Obligatoire, alphanumérique, max 35 caractères
loanId	Identifiant de prêt	Obligatoire, alphanumérique, max 24 caractères
ean13	L' ean de l'offre	Obligatoire, numérique, 13 caractères
returnDate	Date de fin de prêt	Obligatoire, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
DATE_TOO_OLD	The date can't be older than 60 days	Requête	La date fournie est âgée de plus de 60 jours
OK	No ended loans founds for coll : <glnColl>	Requête	Il n’existe pas des prêts terminés de manière anticipée

glnDistributor	Identifiant de distributeur	Optionnel, numérique, 13 caractères
passwordDistributor	Mot de passe de distributeur	Optionnel, alphanumérique, max 25 caractères
orderLineId	Référence de la ligne de commande générée par PNB	Obligatoire, alphanumérique, max 35 caractères
loanId	Identifiant de prêt	Obligatoire, alphanumérique, max 24 caractères
date	Date de fin de prêt	Optionnel, ISO Date 8601 (yyyy-mm-ddThh:mm:ssTZD (TZD[Time Zone designator]: Z or +hh:mm or -hh:mm)

Code (returnStatus)	Message (returnMessage)	Niveau de l'erreur dans la requête	Cause
NOT_FOUND	No Loan having a line with orderLineId '<orderLineId>' and a loanId '<loanId>' is found	Requête	Mettre fin à un prêt qui n’existe pas
NOT_FOUND	The orderLineId <orderLineId> does not exist	Requête	Mettre fin à un prêt associé à une ligne de commande qui n’existe pas dans la base des commandes
ACCES_DENIED	The loan with orderlineId '<orderLineId>' and loanId '<loanId>' is already ended	Requête	Mettre fin à un prêt qui est déjà terminé