PNB (Prêt Numérique en Bibliothèque) est un ensemble de services destinés à faciliter les interconnexions entre les revendeurs, les collectivités et les distributeurs dans le cadre du prêt de ressources numériques.

PNB met à disposition des utilisateurs :

• une API (Application Programming Interface) composée de web services en SOAP et en REST ;
• des services utilisant le protocole FTP pour la remise de certaines informations.

Les principaux acteurs du système sont :

• les distributeurs :
  1. disposent d'un cadre normalisé de description des offres de livres numériques des éditeurs aux collectivités,
  2. assurent la distribution de livres numériques en gérant les modalités d'accès définis par les éditeurs.

• les revendeurs:
  1. présentent les offres numériques des éditeurs aux collectivités ;
  2. transmettent les commandes aux plateformes de distribution.

• les collectivités :
  1. commandent les livres numériques auprès des revendeurs de leur choix ;
  2. présentent les informations sur les livres numériques achetés ;
  3. prêtent les livres numériques en s'appuyant sur les services des distributeurs.

• PNB :
  1. facilite les transactions entre les collectivités, les revendeurs et les distributeurs
  2. enregistre les droits acquis lors des achats et enregistre toutes les transactions gérées par le système.

Dilicom met à disposition des clients les deux plateformes suivantes:

• une plateforme de production : qui est accessible via l'adresse https://pnb-dilicom.centprod.com
• une plateforme de test : qui permet aux clients d'effectuer leurs développements et leurs tests. Elle permet aussi de valider les mises à jour du PNB avant le passage en production. La plateforme de test est accessible via l'adresse https://pnb-test.centprod.com.

L'utilisation de ces plateformes nécessitent des identifiants de connexion. Ces identifiants peuvent être obtenus auprès du service clients de DILICOM à l'adresse : service-clients@dilicom.fr

Les plateformes de distribution partenaires sont :

• EDEN (GLN 3012410002007) - Plateforme opérationnelle en test et en production
• IMMATERIEL (GLN 3012410001000) - Plateforme opérationnelle en test et en production
• L'HARMATHEQUE - Raccordement restant à effectuer
• NUMILOG (GLN 3663608000017) - Plateforme opérationnelle en test et en production
• LES EDITEURS QUEBECOIS - Discussion en cours
• TEA (GLN 3019008147409) - Raccordement en cours

Pour plus d'information sur les détails des offres par distributeur, Merci de consulter la page description des offres des distributeurs.

Les Web services PNB sont disponibles en deux versions :

• Version SOAP : utilise une couche normalisée SOAP pour transférer les données. Chaque interrogation (mais également chaque réponse) sera construite en XML.

• Version REST : donne accès aux mêmes fonctionnalités que le Web service SOAP. Cependant celui-ci utilise, suivant le principe REST, de simples requêtes Http et renvoie les réponses sous forme de simples objets JSON.

Pour connaître la dernière version en cours et l'adresse des services cliquer ici

Les services PNB sont regroupés par thème comme suit :

• La gestion des commandes PNB regroupe les services suivants:
  1. la transmission de commandes (voir service sendOrder) ,
  2. l’annulation de commandes (voir service cancelOrder),
  3. l’obtention du détail des commandes collectivités passées par les revendeurs (voir service getOrders),
  4. la vérification de la disponibilité d’une offre (voir service checkAvailability).

• La gestion des catalogues PNB met à disposition les métadonnées liées aux offres PNB (voir services : getOffers, getOffersForDistributor, diffusion de catalogue PNB par FTP) .

• La gestion des prêts regroupe les services suivants :
  1. l’emprunt d’un livre numérique (voir service loanBook),
  2. la consultation d’un livre (voir service consultBook),
  3. l’obtention de l’état actuel des compteurs de prêts et des dates d'utilisation associés à chaque ligne de commande d'une commande (voir service getLoanStatus ),
  4. la fin d'un prêt (voir service endLoan),
  5. l’obtention de la liste des retours anticipés (voir service getEndedLoans).

• La gestion des adresses IP regroupe les services suivantes :
  1. la déclaration d’une adresse IP (voir service declareIp).

Les services PNB destinés aux revendeurs sont les suivants:

• Transmettre une commande (sendOrder)
• Annuler une commande (cancelOrder)
• Vérifier la disponibilité d’un livre (checkAvailability)
• Récupérer les métadonnées (getOffers)
• Récupérer les métadonnées d'un distributeur donné (getOffersForDistributor)

Les services PNB destinés aux collectivités sont les suivants:

• Récupérer les métadonnées (getOffers)
• Récupérer les métadonnées d'un distributeur donné (getOffersForDistributor)
• Obtenir le détail des commandes transmises par les revendeurs (getOrders)
• Déclarer une adresse IP (declareIp)
• Emprunter un livre (loanBook)
• Consulter un livre (consultBook)
• Obtenir l’état d’un prêt (getLoanStatus)
• Obtenir la liste de retour des prêts (getEndedLoans)

Les services PNB destinés aux distributeurs sont les suivants:

• Terminer un prêt (endLoan)