Table des matières

API Principale : SOAP (xml)

URL WSDL

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

Authentification

<xxxxRequest>
	<glnReseller>3026900001000</glnReseller>
	<passwordReseller>3x59ftmdmdEds</passwordReseller>
	...
</xxxxRequest>

Gestion des erreurs et codes de retour

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

Vérification des disponibilités : checkAvailability()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:CheckAvailabilityRequest>
	<def:glnReseller>3026900001000</def:glnReseller>
	<def:passwordReseller>3x59ftmdmpc85sdEds</def:passwordReseller>
       <def:glnContractor>0000000000000</def:glnContractor>
        <def:country>FR</def:country>
	<def:checkAvailabilityLine>
		<def:ean13>9791093983004</def:ean13>
		<def:glnDistributor>3012410001000</def:glnDistributor>
		<def:unitPrice>399</def:unitPrice>
	</def:checkAvailabilityLine>
	<def:checkAvailabilityLine>
		<def:ean13>9791093594712</def:ean13>
		<def:glnDistributor>3012410002007</def:glnDistributor>
                <def:unitPrice>799</def:unitPrice>
                <def:unitPriceExcludingTax>450</def:unitPriceExcludingTax> 
                <def:currency>EUR</def:currency>
	</def:checkAvailabilityLine>
     </def:CheckAvailabilityRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <CheckAvailabilityResponse xmlns="http://hub.dilicom.net/definitions/">
         <checkAvailabilityResponseLine>
            <ean13>9791093594712</ean13>
            <glnDistributor>3012410002007</glnDistributor>
            <checkAvailabilityReturnValue>AVAILABLE</checkAvailabilityReturnValue>
            <returnStatus>OK</returnStatus>
         </checkAvailabilityResponseLine>
         <checkAvailabilityResponseLine>
            <ean13>9791093983004</ean13>
            <glnDistributor>3012410001000</glnDistributor>
            <checkAvailabilityReturnValue>AVAILABLE</checkAvailabilityReturnValue>
            <returnStatus>OK</returnStatus>
         </checkAvailabilityResponseLine>
         <returnStatus>OK</returnStatus>
      </CheckAvailabilityResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Passage de commandes : sendOrder()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:SendOrderRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:orderId>ORDER0001</def:orderId>
         <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>000000000000</def:glnContractor>
         <def:customerId>test0001</def:customerId>
 
         <def:finalBookOwner>
            <def:identifier>ident0002</def:identifier>
            <def:civility>M</def:civility>            
            <def:firstName>TestFirstName</def:firstName>
            <def:lastName>TestLastName</def:lastName>
            <def:email>test@unknown.com</def:email>
            <def:country>FR</def:country>
            <def:postalCode>92000</def:postalCode>
            <def:city>NANTERRE</def:city>
         </def:finalBookOwner>
 
         <def:orderRequestLine>
                    <def:ean13>9791093594712</def:ean13>
	            <def:glnDistributor>3012410002007</def:glnDistributor>
	            <def:unitPrice>799</def:unitPrice>
	            <def:unitPriceExcludingTax>450</def:unitPriceExcludingTax> 
	            <def:currency>EUR</def:currency>
	            <def:quantity>1</def:quantity>
	            <def:lineReference>testRefLine1</def:lineReference>
         </def:orderRequestLine>
 
           <def:orderRequestLine>
	            <def:ean13>9791093983004</def:ean13>
	            <def:glnDistributor>3012410001000</def:glnDistributor>
	            <def:unitPrice>99</def:unitPrice>
	            <def:quantity>1</def:quantity>
	            <def:lineReference>testRefLine1</def:lineReference>
	            <def:specialCode>testSpecialCode</def:specialCode>            
         </def:orderRequestLine>
 
      </def:SendOrderRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <SendOrderResponse xmlns="http://hub.dilicom.net/definitions/">
            <orderId>ORDER0001</orderId>
            <orderLine>
            <ean13>9791093594712</ean13>
            <glnDistributor>3012410002007</glnDistributor>
            <orderLineId>26094</orderLineId>
            <lineReference>testRefLine1</lineReference>
            <currency>EUR</currency>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093594712-3012410002007/26094-20742-N94Q2N95PRKKWF8Y95DT04IIA9TSEZKG.do</url>
               <format>E101</format>
               <formatDescription>EPUB</formatDescription>
               <ean13>9791093594712</ean13>
               <mimetype>application/epub+zip</mimetype>
            </link>
            <returnStatus>OK</returnStatus>
         </orderLine>
         <orderLine>
            <ean13>9791093983004</ean13>
            <glnDistributor>3012410001000</glnDistributor>
            <orderLineId>26095</orderLineId>
            <lineReference>testRefLine1</lineReference>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17393-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E105</format>
               <formatDescription>HTML</formatDescription>
               <ean13>3612220747466</ean13>
               <mimetype>text/html</mimetype>
            </link>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17394-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E127</format>
               <formatDescription>Mobipocket</formatDescription>
               <ean13>3612220747442</ean13>
               <mimetype>application/x-mobipocket-ebook</mimetype>
            </link>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17395-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E101</format>
               <formatDescription>EPUB</formatDescription>
               <ean13>3612220747459</ean13>
               <mimetype>application/epub+zip</mimetype>
            </link>
            <returnStatus>OK</returnStatus>
         </orderLine>
 
         <returnStatus>OK</returnStatus>
      </SendOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Annulation d'une commande : cancelOrder()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:CancelOrderRequest>
 
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmpc85sdEds</def:passwordReseller>
         <def:glnContractor>0000000000000</def:glnContractor>
         <def:orderId>ORDER0001</def:orderId>
         <def:reason>test</def:reason>
         <def:cancelOrderLine>
            <def:ean13>9791093983004</def:ean13>
            <def:glnDistributor>3012410001000</def:glnDistributor>
         </def:cancelOrderLine>
      </def:CancelOrderRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <CancelOrderResponse xmlns="http://hub.dilicom.net/definitions/">
         <orderId>ORDER0001</orderId>
         <cancelOrderResponseLine>
            <ean13>9791093983004</ean13>
            <glnDistributor>3012410001000</glnDistributor>
            <returnStatus>CANCELLED</returnStatus>
         </cancelOrderResponseLine>
         <returnStatus>OK</returnStatus>
      </CancelOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Récupération des détails d'une commande : getOrderDetails()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetOrderDetailRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmpc85sdEds</def:passwordReseller>
         <def:glnContractor>0000000000000</def:glnContractor>
      </def:GetOrderDetailRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetOrderDetailResponse xmlns="http://hub.dilicom.net/definitions/">
         <orderId>ORDER0001</orderId>
         <orderLine>
            <ean13>9791093594712</ean13>
            <glnDistributor>3012410002007</glnDistributor>
            <orderLineId>26094</orderLineId>
            <lineReference>testRefLine1</lineReference>
            <currency>EUR</currency>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093594712-3012410002007/26094-20742-N94Q2N95PRKKWF8Y95DT04IIA9TSEZKG.do</url>
               <format>E101</format>
               <formatDescription>EPUB</formatDescription>
               <ean13>9791093594712</ean13>
               <mimetype>application/epub+zip</mimetype>
            </link>
            <returnStatus>OK</returnStatus>
         </orderLine>
         <orderLine>
            <ean13>9791093983004</ean13>
            <glnDistributor>3012410001000</glnDistributor>
            <orderLineId>26095</orderLineId>
            <lineReference>testRefLine1</lineReference>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17393-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E105</format>
               <formatDescription>HTML</formatDescription>
               <ean13>3612220747466</ean13>
               <mimetype>text/html</mimetype>
            </link>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17394-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E127</format>
               <formatDescription>Mobipocket</formatDescription>
               <ean13>3612220747442</ean13>
               <mimetype>application/x-mobipocket-ebook</mimetype>
            </link>
            <link>
               <url>https://hub-dilicom.centprod.com/v3//link/3026900001000/ORDER0001/9791093983004-3012410001000/26095-17395-5D5SXBND79ZRSWVQNM13LRPMX9L6KEW4.do</url>
               <format>E101</format>
               <formatDescription>EPUB</formatDescription>
               <ean13>3612220747459</ean13>
               <mimetype>application/epub+zip</mimetype>
            </link>
            <returnStatus>OK</returnStatus>
         </orderLine>
 
         <returnStatus>OK</returnStatus>
      </GetOrderDetailResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Obtention des version numériques associé à des ean physiques : getDigitalVersions()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetDigitalVersionsRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnContractor>0000000000000</def:glnContractor>
         <def:physicalEan>9782092524374</def:physicalEan>
         <def:physicalEan>9782212120035</def:physicalEan>
      </def:GetDigitalVersionsRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetDigitalVersionsResponse xmlns="http://hub.dilicom.net/definitions/">
         <physicalVersion>
            <physicalEan>9782092524374</physicalEan>
            <digitalVersion>
               <ean13>9782092528068</ean13>
               <glnDistributor>3012410003004</glnDistributor>
            </digitalVersion>
         </physicalVersion>
         <physicalVersion>
            <physicalEan>9782212120035</physicalEan>
            <noDigitalVersion/>
         </physicalVersion>
         <returnStatus>OK</returnStatus>
      </GetDigitalVersionsResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Récupération des notices : getNotices()

Interrogation du web service

Cas 1 – Initialisation du catalogue (service désactivé, le catalogue d'initialisation est fourni par FTP)

Attention : l'option initialization a été désactivée, merci de contacter Dilicom pour plus d’informations. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetNoticesRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>30269000010012</def:glnContractor>
	<def:initialization />
      </def:GetNoticesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Cas 2 – Récupération depuis un instant T

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetNoticesRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>30269000010012</def:glnContractor>
	<def:sinceDate>2010-05-21T08:00:00</def:sinceDate>
      </def:GetNoticesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Cas 3 – Récupération depuis la dernière connexion

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetNoticesRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>30269000010012</def:glnContractor>
	<def:lastConnection />
      </def:GetNoticesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du Web Service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetNoticesResponse>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010261052_876202924368763026683575329457724863245.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010241050_436369748931693308631487537702611586765.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010251051_1167095955394841390675854646324262157699.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010261050_800399867987676759575839083436876637486.xml</httpLink>
         </onixFileUrl>
         <returnStatus>OK</returnStatus>
      </GetNoticesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

L'exemple présente le cas où plusieurs fichiers sont renvoyés. Actuellement le web service renvoie toujours un seul lien, cependant il est possible qu'à terme il soit nécessaire de renvoyer plusieurs liens.

Si éventuellement il n’y avait aucune fiche à diffuser, on renvoie un message du type : 

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetNoticesResponse>
	<noNotice/>
	<returnStatus>OK</returnStatus>
      </GetNoticesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Récupération des notices : getNoticeForDistributor()

Interrogation du web service

Cas 1 – Initialisation du catalogue pour un distributeur (service désactivé, le catalogue d'initialisation est fourni par FTP)

Attention : l'option initialization a été désactivée, merci de contacter Dilicom pour plus d’informations. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetNoticesForDistributorRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnDistributor>3012410001008</def:glnDistributor>
          <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>30269000010012</def:glnContractor>
	<def:initialization />
      </def:GetNoticesForDistributorRequest>
   </soapenv:Body>
</soapenv:Envelope>

Cas 2 – Récupération depuis un instant T pour un distributeur

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetNoticesForDistributorRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmdEds</def:passwordReseller>
         <def:glnDistributor>3012410001008</def:glnDistributor>
         <def:glnGroup>0000000000000</def:glnGroup>
         <def:glnContractor>30269000010012</def:glnContractor>
	 <def:sinceDate>2010-05-21T08:00:00</def:sinceDate>
      </def:GetNoticesForDistributorRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du Web Service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetNoticesForDistributorResponse>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010261052_876202924368763026683575329457724863245.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010241050_436369748931693308631487537702611586765.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010251051_1167095955394841390675854646324262157699.xml</httpLink>
         </onixFileUrl>
         <onixFileUrl>
            <httpLink>http://hub.dilicom.net/notices_onix/diffusion_3025594195700_201010261050_800399867987676759575839083436876637486.xml</httpLink>
         </onixFileUrl>
         <returnStatus>OK</returnStatus>
      </GetNoticesForDistributorResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

L'exemple présente le cas où plusieurs fichiers sont renvoyés. Actuellement le web service renvoie toujours un seul lien, cependant il est possible qu'à terme il soit nécessaire de renvoyer plusieurs liens.

Si éventuellement il n’y avait aucune fiche à diffuser, on renvoie un message du type : 

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetNoticesForDistributorResponse>
	<noNotice/>
	<returnStatus>OK</returnStatus>
      </GetNoticesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Obtention de notices onix d'une liste d'ean/distributeur : getDetailNotices()

Interrogation du web service

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:def="http://hub.dilicom.net/definitions/">
   <soapenv:Header/>
   <soapenv:Body>
      <def:GetDetailNoticesRequest>
         <def:glnReseller>3026900001000</def:glnReseller>
         <def:passwordReseller>3x59ftmdmpc85sdEds</def:passwordReseller>
         <def:glnContractor>0000000000000</def:glnContractor>
         <def:notice>
            <def:ean13>9782092528068</def:ean13>
            <def:glnDistributor>3012410003004</def:glnDistributor>
         </def:notice>
         <def:notice>
            <def:ean13>9782092628068</def:ean13>
            <def:glnDistributor>3012410003004</def:glnDistributor>
         </def:notice>
      </def:GetDetailNoticesRequest>
   </soapenv:Body>
</soapenv:Envelope>

Réponse du web service

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <GetDetailNoticesResponse xmlns="http://hub.dilicom.net/definitions/">
         <detailNotice>
            <ean13>9782092528068</ean13>
            <glnDistributor>3012410003004</glnDistributor>
            <onixProduct><![CDATA[<ONIXMessage> ... </ONIXMessage>]]></onixProduct>
         </detailNotice>
         <detailNotice>
            <ean13>9782092628068</ean13>
            <glnDistributor>3012410003004</glnDistributor>
            <noNotice/>
         </detailNotice>
         <returnStatus>OK</returnStatus>
      </GetDetailNoticesResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Chargement de la notices d'un produit directement au format ONIX : getNotice()

Service non implémenté en SOAP.