Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
hub_principal:examples_soap [2015/04/03 16:30] |
hub_principal:examples_soap [2018/04/23 11:22] (version actuelle) |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
+ | ====== API Principale : SOAP (xml) ====== | ||
+ | |||
+ | ===== URL WSDL ===== | ||
+ | Pour connaître la dernière version en cours et l'adresse des services [[hub_principal:start|cliquer ici ]] | ||
+ | |||
+ | ===== Authentification ===== | ||
+ | |||
+ | <code xml> | ||
+ | <xxxxRequest> | ||
+ | <glnReseller>3026900001000</glnReseller> | ||
+ | <passwordReseller>3x59ftmdmdEds</passwordReseller> | ||
+ | ... | ||
+ | </xxxxRequest> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | |||
+ | ===== Gestion des erreurs et codes de retour ===== | ||
+ | <code xml> | ||
+ | <xxxxResponse> | ||
+ | <returnStatus>AUTHENTICATION_ERROR</returnStatus> | ||
+ | <returnMessage>Bad login</returnMessage > | ||
+ | </xxxxResponse> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Vérification des disponibilités : checkAvailability() ===== | ||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== Passage de commandes : sendOrder() ===== | ||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== Annulation d'une commande : cancelOrder() ===== | ||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== Récupération des détails d'une commande : getOrderDetails() ===== | ||
+ | |||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ===== Obtention des version numériques associé à des ean physiques : getDigitalVersions() ===== | ||
+ | |||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== 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) === | ||
+ | <note important> | ||
+ | Attention : l'option initialization a été désactivée, merci de contacter Dilicom pour plus d’informations. | ||
+ | </note> | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | === Cas 2 – Récupération depuis un instant T === | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | === Cas 3 – Récupération depuis la dernière connexion === | ||
+ | <code xml> | ||
+ | <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> | ||
+ | |||
+ | </code> | ||
+ | |||
+ | ==== Réponse du Web Service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | <note important>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.</note> | ||
+ | |||
+ | Si éventuellement il n’y avait aucune fiche à diffuser, on renvoie un message du type : | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== 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) === | ||
+ | <note important> | ||
+ | Attention : l'option initialization a été désactivée, merci de contacter Dilicom pour plus d’informations. | ||
+ | </note> | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | === Cas 2 – Récupération depuis un instant T pour un distributeur === | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du Web Service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | <note important>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.</note> | ||
+ | |||
+ | Si éventuellement il n’y avait aucune fiche à diffuser, on renvoie un message du type : | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ===== Obtention de notices onix d'une liste d'ean/distributeur : getDetailNotices() ===== | ||
+ | |||
+ | ==== Interrogation du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ==== Réponse du web service ==== | ||
+ | <code xml> | ||
+ | <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> | ||
+ | </code> | ||
+ | |||
+ | ===== Chargement de la notices d'un produit directement au format ONIX : getNotice() ===== | ||
+ | <note important> Service non implémenté en SOAP. </note> | ||