Professional Documents
Culture Documents
TABLA DE CONTENIDOS
1 INTRODUCCION .................................................................................................................... 3
1.1 1.2 1.3 PRESENTACION ........................................................................................................................ 3 OBJETIVO DEL DOCUMENTO ................................................................................................... 4 PARAMETROS DE CONEXION : ................................................................................................. 5 FASES DEL PROCESO ................................................................................................................ 6 CONECTORES ......................................................................................................................... 10
3 4
V2.0
CONFIDENTIAL
2/46
7.1.1 Parmetros ............................................................................................................................ 31 7.1.2 Ejemplos............................................................................................................................... 31 7.1.3 Filtros .................................................................................................................................. 35 7.2 METODO GETLINK ................................................................................................................ 36 7.2.1 Parmetros ............................................................................................................................ 36 7.2.2 Ejemplos............................................................................................................................... 36 7.3 METODO GETORDER ............................................................................................................ 38 7.3.1 Parmetros ............................................................................................................................ 38 7.3.2 Ejemplos............................................................................................................................... 38 7.4 METODO GETORDEREVENT ................................................................................................. 40 7.4.1 Parmetros ............................................................................................................................ 40 7.4.2 Ejemplos............................................................................................................................... 41 7.5 METODO GETORDERSTATUS ................................................................................................ 44 7.5.1 Parmetros ............................................................................................................................ 44 7.5.2 Ejemplos............................................................................................................................... 44
V2.0
CONFIDENTIAL
3/46
1 Introduccin
1.1 Presentacin Libranda e-plataforma es una aplicacin orientada a servicios. Permite los procesos de flujos necesarios para la distribucin digital con los distribuidores, editores y minoristas (tiendas online). El e-plataforma es un prctico conector entre los minoristas y distribuidores, a fin de: Asegurar la distribucin de contenido digital de o diferentes tipos de contenidos (ebooks, web site, CDROM) o diferentes tipos de proteccin (watermarking, DRM ACS4) Gestiona los flujos de pedidos Da informacin de cmo gestionar el sevicio al cliente Proporciona retroalimentacin para asegurar relaciones con el cliente Proporciona los datos necesarios para gestionar las facturas
Billing
e-Platform
Metadata Database
Metadata
Publisher
Ebooks (Metadata and files)
e-Distribution system
Distribution order
Retailer website
Order
Publisher
Statistics
E-book download
V2.0
CONFIDENTIAL
4/46
1.2
El presente documento describe los servicios web utilizados por los retailers (e-libreras) para acceder a la e-plataforma. Estos servicios permiten: Tienda - gestionar el catlogo: o Obtener ndice de catlogo Gestionar los pedidos: o Crear pedido o Confirmar pedido o Crear y confirmar pedido Cancelar Pedido: o Cancelar pedido (cancelOrder) Gestionar servicio al cliente : o Exportar datos (exportOrderData) o Recuperar link descarga libro digital o Obtener rdenes de un cliente o Recuperar eventos de una orden o Recuperar estado de una orden El presente documento enumera para cada categora de servicio: detalle de los mtodos clases involucradas para cada uno para cada clase se indican los objetos a parametrizar y los cdigos de error posibles. Clases implcitas para cada uno
V2.0
CONFIDENTIAL
5/46
1.3 Parmetros de Conexin : e-plataforma proporciona acecibilidad al web service con los siguientes parmetros : . Name of the service OrderService2 WSDL http://acs4.zumbuk.com/dwhws/OrderService2?wsdl
Use cancelOrder confirmOrder createAndConfirmOrder createOrder exportData getCatalogSummary getLink getOrder getOrderStatus getOrderEvent
OrderService
http://acs4.zumbuk.com/dwhws/OrderService?wsdl
Para cumplir con los objetivos, el API se ofrece en forma de web service. Basado en estndars (SOAP, WSDL, HTTP, XML), el web service deja al cliente la eleccin del tipo de aplicacin (Windows, navegador, sistema mvil), la eleccin de la plataforma (Windows, Linux, Unix, etctera), la eleccin del lenguaje de programacin (C + + +, Java, C #, Visual Basic, etc), y la eleccin del entorno(Microsoft, NET, ASP, JSP, J2EE, etc.) El cliente tambin puede elegir entre las herramientas de desarrollo comercial y incluso se puede utilizar software "OpenSource". Todas las eleciones tecnolgicas tienen que ser compatibles con: HTTP1.1 (para el transporte de protocolo). SOAP 1.1 (protocolo de intercambio de datos) o Ver http://www.w3.org/TR/SOAP/ WSDL 1.1 (para la descripcin de los servicios) o Ver http://www.w3.org/TR/wsdl REST o Ver. http://www.ics.uci.edu/ ~ Fielding / pubs / tesis / top.htm
V2.0
CONFIDENTIAL
6/46
2
2.1
Presentacin de procesos
Fases del proceso
El proceso de distribucin se puede dividir en 3 fases: Fase n 1: Crear el catlogo de productos en la base de datos de la tienda. usando el mtodo de web service : o Para ello la tienda utiliza un mtodo del WebService : getCatalog que proporciona una lista de EAN13 disponibles para el retailer concreto usando el mtodo ONIX FTP : o Una tienda tiene que recuperar la lista de productos que puede pedir. Tambin necesita metadatos asociados (ttulo, ean13 ...). Para una nica tienda, todos los datos estn disponibles en un catlogo XML utilizando el formalismo de metadatos ONIX. La publicacin de los archivos de metadatos ONIX implica que : El minorista tiene un rea de trabajo en un archivo dedicado del servidor . o El archivo del servidor es gestionado por el administrador e-plataforma e-plataforma crea cuentas FTPES para las tiendas e-plataforma declara las cuentas de la tienda con el back-office El administrador de e-plataforma verifica que el directorio asociado es accesible solo por la tienda.
e-plataforma, a travs de FTPES provee la actualizacin Onix del catlogo. El protocolo considera : - Generacin de archivos ONIX completos - Consumo de los archivos ONIX por la tienda Creacion de archivo ONIX: El servidor e-plataforma genera peridicamente catlogo de archivos ONIX para cada punto de venta. El proceso es el siguiente:
V2.0
CONFIDENTIAL
7/46
Catlogo completo ONIX: e-plataforma - servicios genera una vez al mes (cada dia 10) a las 00 :00 horas. El archivo ONIX contiene todos las metadatos Onix para todos los productos de la tienda. Nombre de archivo : <outlet-name>-<fecha_hora>.onix Ejemplo: outlet228-20100228_101811.onix Catlogo diferencial ONIX: e-plateforme servicios genera a diario un archivo ONIX Dif. El archivo contiene metadatos ONIX para cada producto modificado entre [<date_time_from>;] <date_time_to> <outlet-name> de salida. Nombre del archivo: <outlet-name> - <date_time_from> - <date_time_to>. Onix Ejemplo: outlet228-20100227_101511-20100228_101811.onix Cuando no hay productos que hayan sido creados / borrados / modificados el archivo ONIX es un archivo vaco (tamao en bytes = 0).
Periodicidad: El catlogo completo ONIX se genera una vez al mes (cada dia 10) a las 01 :00 horas. El catlogo diferencial ONIX se genera diariamente a las 01 :00. Siempre que un nuevo catlogo completo ONIX se genera, los diferenciales y completos anteriores se suprimen. El back office permite la generacin de catlogos ONIX. Siempre que un nuevo catlogo completo ONIX se genera, los diferenciales y completos anteriores se suprimen. Obtener el catlogo ONIX: El directorio por defecto FTPES contiene los catlogos para cada retailer: Catlogo completo ONIX de metadatos: para todos los puntos de venta del retailer. Catlogo Dif. ONIX de metadatos: para todos los puntos de venta del retailer. Para cada obtencin del fichero, el proceso es el siguiente: El retailer se conecta al servidor FTPES con las credenciales proporcionadas. El retailer selecciona el catlogo ONIX para importar o para una fecha dada t (i) el retailer DEBE leer primero el catlogo completo ONIX que tendr el formato:
V2.0
CONFIDENTIAL
8/46
nombre de punto de venta 20100228_101811.onix y todos los catlogos diferenciales creados entre [t (i) - t (n)] que tendrn este formato: nombre de punto de venta 20100228_101811+20100227_101511.onix En caso de error, el administrador del sistema del punto de venta debe contactar con Libranda para resolver el problema.
Cuando un articulo dj de estar disponible para su venta, Libranda enviare un mensaje con NotificationType>05 y el codigo ean Todos los productos que vienen NotificationType>05 tienen que ser borrados de la base de datos del canal
NOTA: La primera vez que la tienda on-line descarga el catlogo, la cantidad de datos puede ser muy grande; hay que utilizar una tecnologa optimizada para la transferencia de archivos grandes.
V2.0
CONFIDENTIAL
9/46
Publisher Group
Retailer
ePlataforma
Fichero Excel
Publisher
Fichero Epub
Figura 2 : Flujos ONIX Fase n 2: rdenes de gestin de la distribucin Para enviar una nueva orden, el retailer tiene dos opciones: o bien hacerlo en dos fases o bien hacerlo en una. Uso de una fase: el retailer enviar una peticin de distribucin a e-plataforma y confirmar al mismo tiempo, a travs del mtodo de servicio web createAndConfirm. En el intercambio de datos de pedidos de cliente, el sistema devolver enlace digital de descarga de contenidos (s), incluida en la solicitud, por la URL visible. Uso de dos fases: las tiendas on-line utilizarn dos mtodos de servicios web, createOrder y confirmOrder. La segunda confirma una orden creada anteriormente: despus de la confirmacin, el enlace (s) asociado(s) a la orden se activar. El otro mtodo, createAndConfirmOrder, presentar y confirmar un pedido, al mismo tiempo. Fase n 3: Servicios al cliente y gestin de las estadsticas de distribucin Despus de la distribucin de contenido digital, una tienda on-line puede utilizar otros mtodos que le permitan hacer frente a los servicios al cliente (obtener una lista de pedidos en funcin de
V2.0
CONFIDENTIAL
10/46
un ID de cliente, historial de descargas, posibilidad de regenerar enlace de descarga (s) de un orden especfico, etc) . 2.2 Conectores
Para poder interconectar con la e-plataforma, cada retailer dispone de dos parmetros especificos Un gencode (identificador de la e-librera) Una contrasea (password)
Esta combinacin nica proporcionada por Libranda le permite identificarse a travs de un acceso seguro HTTPS. Este acceso permite a la e-librera gestionar diversos puntos de venta (en caso de disponer de varios sitios web), en funcin de un filtro de identificacin outletName. Los servicios que se utilizan son webservices, REST o SOAP.
Retailer
Gencode / Password
Outlet A outletName
Outlet D outletName
Outlet B outletName
Outlet C outletName
V2.0
CONFIDENTIAL
11/46
Role
V2.0
CONFIDENTIAL
12/46
4
4.1
Convenciones utilizadas
Gestin de errores
La herramienta de generacin de cdigo utilizado por wsdl puede tener limitaciones. Por esta razn, el poder completo del wsdl no se ha utilizado. Los valores de retorno de tipo xxxResponse cumplen con el siguiente modelo: Si se produjo un error, solo se informa el campo errorField. Si no hay errores, el campo errorField no est informado y se informa el resto de campos segn el mtodo llamado
Error Xxx
4.2
Resultados de Paginacin Cuando una llamada al webservice puede proporcionar una gran cantidad de resultados, es necesario numerar las pginas de los datos de la devolucin. El usuario precisar el nmero de resultados a devolver, y el ndice del primer resultado. o El servicio indicar, en la parte superior los registros devueltos, el total de resultados disponibles, y el ndice del primer resultado enviado. - Ejemplo: En la consulta de pedidos efectuados por un punto de venta, se obtienen 10.942 resultados. o La paginacin se hace en tramos de 100 pedidos. Sern necesarias 55 llamadas para recuperar todos los resultados. o 1 llamada: resultados 0 to 99 o el usuario especifica index = 0, count = 100 - El servicio devuelve adems de los registros index = 0, count = 100 Total = 5471 o ensima llamada: resultados de (n-1) x 100 a nx 100 o el usuario especifica index = (n-1) x 100, count = 100 - El servicio devuelve adems de los registros index = (n-1) x 100, count = 100 Total = 5471 o Llamada 55: resultados de 5400 a 5471 o el usuario indica index = 5400, count = 100 - El servicio enva adems de los registros index = 5400, count = 71 Total = 5471
V2.0
CONFIDENTIAL
13/46
5 Gestin de Catlogo
5.1 5.1.1 Mtodo GetCatalogSummary Parmetros
Este mtodo permite a una tienda recuperar su catlogo de e-plataforma con el fin de importar datos en su propia base de datos. Por lo tanto, se obtendr la lista de todos los productos digitales disponibles para una tienda.. Este mtodo devuelve un objeto tipo CatalogSummaryResponse. Parameters Mandatory Yes Yes Yes No No No No No Comment Identificador nico de la e-librera - [String, 20] Contrasea de la e-librera - [String, 32] Identificacin de un punto de venta de la e-librera - [String, 50] Para filtrar los productos digitales por el EAN13 Para filtrar los productos fisicos por el EAN13 Para incluir solo los productos modificados desde una fecha. Para iniciar ndice de los productos para recuperar Para indicar el numero de productor a recuperar CatalogSummaryResponse para el punto de venta Lista de productos disponibles
gencode password outletName ean13 physicalEan13 fromDate startIndex count Return value
5.1.2 5.1.2.1 Ejemplos
Para recuperar el resumen del catlogo, sin ningn parmetro de filtro, utilice la siguiente peticin: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getCatalogSummary> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> </dwh:getCatalogSummary> </soapenv:Body>
V2.0
CONFIDENTIAL
14/46
La respuesta a una peticin anterior es: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:getCatalogSummaryResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <count>10</count> <products> <authorFirstName/> <authorLastName/> <collectionId>7506</collectionId> <collectionName>MmoBac - Fiches de rvision</collectionName> <coverUrl>http://www.yodawork.com/images/BORDASPARASCOLAIRE/pf/9782047600740R3.gif</coverUrl> <ean13>9782047600740</ean13> <imprintId>GLN-BORDAS</imprintId> <imprintName>BORDAS-PARASCOLAIRE</imprintName> <languageCode>fre</languageCode> <name>MEMOBAC FICHES DE REVISION SVT TERMINALE S</name> <onix><![CDATA[<ONIXMessage release="3.0" xmlns="http://www.editeur.org/onix/3.0/reference"><Header><Sender><SenderIdentifier> <SenderIDType>06</SenderIDType><IDTypeName>GLN eplateforme</IDTypeName><IDValue>eplataformaID</IDValue></SenderIdentifier><SenderName>eplataforma</SenderName></Sender><MessageNumber>2010051120</MessageNumber><S entDateTime>20100511T202717</SentDateTime><DefaultLanguageOfText>fre</DefaultLa nguageOfText></Header><Product><RecordReference>9782047600740</RecordReference ><NotificationType>02</NotificationType><ProductIdentifier><ProductIDType>01</Prod uctIDType><IDTypeName>Code Interforum</IDTypeName><IDValue>760074</IDValue></ProductIdentifier><ProductId entifier><ProductIDType>03</ProductIDType><IDValue>9782047600740</IDValue></P roductIdentifier><DescriptiveDetail><ProductComposition>00</ProductComposition><Pro ductForm>ED</ProductForm><Collection><CollectionType>10</CollectionType><Collect ionIdentifier><CollectionIDType>01</CollectionIDType><IDValue>7506</IDValue></Co llectionIdentifier><TitleDetail><TitleType>01</TitleType><TitleElement><TitleElementLev el>02</TitleElementLevel><TitleText>MmoBac - Fiches de rvision</TitleText></TitleElement></TitleDetail></Collection><TitleDetail><TitleType> 01</TitleType><TitleElement><TitleElementLevel>01</TitleElementLevel><TitleText textcase="01">MEMOBAC FICHES DE REVISION SVT TERMINALE S</TitleText></TitleElement></TitleDetail><Language><LanguageRole>01</LanguageRol e><LanguageCode>fre</LanguageCode></Language><Audience><AudienceCodeType>01 </AudienceCodeType><AudienceCodeValue>01</AudienceCodeValue></Audience></Des criptiveDetail><CollateralDetail><SupportingResource><ResourceContentType>01</Resourc
V2.0
CONFIDENTIAL
15/46
eContentType><ContentAudience>00</ContentAudience><ResourceMode>03</ResourceM ode><ResourceVersion><ResourceForm>01</ResourceForm><ResourceVersionFeature>< ResourceVersionFeatureType>01</ResourceVersionFeatureType><FeatureValue>D502</Fea tureValue></ResourceVersionFeature><ResourceLink>http://www.yodawork.com/images/B ORDASPARASCOLAIRE/pf/9782047600740R3.gif</ResourceLink></ResourceVersion></Supporti ngResource><SupportingResource><ResourceContentType>01</ResourceContentType><Co ntentAudience>00</ContentAudience><ResourceMode>03</ResourceMode><ResourceVers ion><ResourceForm>01</ResourceForm><ResourceVersionFeature><ResourceVersionFeat ureType>01</ResourceVersionFeatureType><FeatureValue>D502</FeatureValue></Resour ceVersionFeature><ResourceLink>http://www.yodawork.com/images/BORDASPARASCOLAIRE/gf/9782047600740R3.gif</ResourceLink></ResourceVersion></Supporti ngResource></CollateralDetail><PublishingDetail><Imprint><ImprintIdentifier><ImprintI DType>06</ImprintIDType><IDValue>GLNBORDAS</IDValue></ImprintIdentifier><ImprintName>BORDASPARASCOLAIRE</ImprintName></Imprint><Publisher><PublishingRole>01</Publishing Role><PublisherName>BORDAS</PublisherName></Publisher><CityOfPublication>Paris </CityOfPublication><CountryOfPublication>FR</CountryOfPublication><PublishingStatus >04</PublishingStatus><PublishingDate><PublishingDateRole>01</PublishingDateRole>< DateFormat>00</DateFormat><Date>00021130</Date></PublishingDate><SalesRights> <SalesRightsType>01</SalesRightsType><Territory><RegionsIncluded>WORLD</RegionsI ncluded><CountriesExcluded>MX</CountriesExcluded></Territory></SalesRights></Publ ishingDetail><RelatedMaterial><RelatedProduct><ProductRelationCode>13</ProductRelatio nCode><ProductIdentifier><ProductIDType>03</ProductIDType><IDValue>97820473094 83</IDValue></ProductIdentifier></RelatedProduct><RelatedProduct><ProductRelationC ode>01</ProductRelationCode><ProductIdentifier><ProductIDType>03</ProductIDType> <IDValue>9782047600757</IDValue></ProductIdentifier></RelatedProduct><RelatedProd uct><ProductRelationCode>01</ProductRelationCode><ProductIdentifier><ProductIDType >03</ProductIDType><IDValue>9782047600764</IDValue></ProductIdentifier></Relate dProduct><RelatedProduct><ProductRelationCode>01</ProductRelationCode><ProductIde ntifier><ProductIDType>03</ProductIDType><IDValue>9782047600771</IDValue></Pr oductIdentifier></RelatedProduct><RelatedProduct><ProductRelationCode>01</ProductRe lationCode><ProductIdentifier><ProductIDType>03</ProductIDType><IDValue>9782047 600788</IDValue></ProductIdentifier></RelatedProduct><RelatedProduct><ProductRelati onCode>01</ProductRelationCode><ProductIdentifier><ProductIDType>03</ProductIDT ype><IDValue>9782047600795</IDValue></ProductIdentifier></RelatedProduct><Relate dProduct><ProductRelationCode>01</ProductRelationCode><ProductIdentifier><ProductI DType>03</ProductIDType><IDValue>9782047600801</IDValue></ProductIdentifier>< /RelatedProduct><RelatedProduct><ProductRelationCode>01</ProductRelationCode><Pro ductIdentifier><ProductIDType>03</ProductIDType><IDValue>9782047600818</IDValue ></ProductIdentifier></RelatedProduct><RelatedProduct><ProductRelationCode>01</Pro ductRelationCode><ProductIdentifier><ProductIDType>03</ProductIDType><IDValue>97 82047600825</IDValue></ProductIdentifier></RelatedProduct><RelatedProduct><Product RelationCode>01</ProductRelationCode><ProductIdentifier><ProductIDType>03</Produc tIDType><IDValue>9782047600832</IDValue></ProductIdentifier></RelatedProduct><R elatedProduct><ProductRelationCode>01</ProductRelationCode><ProductIdentifier><Prod uctIDType>03</ProductIDType><IDValue>9782047600849</IDValue></ProductIdentifier ></RelatedProduct><RelatedProduct><ProductRelationCode>01</ProductRelationCode><
V2.0
CONFIDENTIAL
16/46
ProductIdentifier><ProductIDType>03</ProductIDType><IDValue>9782047600856</IDV alue></ProductIdentifier></RelatedProduct></RelatedMaterial><ProductSupply><SupplyD etail><Supplier><SupplierRole>06</SupplierRole><SupplierIdentifier><SupplierIDType>06 </SupplierIDType><IDValue>GLN_ID_INTERFORUM</IDValue></SupplierIdentifier> <SupplierName>Interforum</SupplierName></Supplier><ProductAvailability>20</Product Availability><SupplyDate><SupplyDateRole>08</SupplyDateRole><DateFormat>00</Date Format><Date>00021130</Date></SupplyDate><Price><PriceType>03</PriceType><Pri ceAmount>3,34</PriceAmount><CurrencyCode>EUR</CurrencyCode></Price><Price>< PriceType>04</PriceType><PriceAmount>4</PriceAmount><CurrencyCode>EUR</Curre ncyCode></Price></SupplyDetail></ProductSupply></Product></ONIXMessage>]]></o nix> <physicalEan13>9782047309483</physicalEan13> <priceAmount>3,34</priceAmount> <priceCurrency>EUR</priceCurrency> <publisherId/> <publisherName>BORDAS-PARASCOLAIRE</publisherName> <subname/> </products> <products> <authorFirstName/> <authorLastName>Favan</authorLastName> <collectionId/> <collectionName/> <coverUrl/> <ean13>9782917144930</ean13> <imprintId/> <imprintName/> <languageCode/> <name>Le tueur intime</name> <onix/> <physicalEan13/> <priceAmount/> <priceCurrency/> <publisherId/> <publisherName>Les Nouveaux Auteurs</publisherName> <subname/> </products> <products> <authorFirstName/> <authorLastName>Depreux</authorLastName> <collectionId/> <collectionName/> <coverUrl/> <ean13>9782917144947</ean13> <imprintId/> <imprintName/> <languageCode/> <name>Les meurtriers de Dieu</name>
V2.0
CONFIDENTIAL
17/46
<onix/> <physicalEan13/> <priceAmount/> <priceCurrency/> <publisherId/> <publisherName>Les Nouveaux Auteurs</publisherName> <subname/> </products> <startIndex>0</startIndex> <total>10</total> </return> </ns2:getCatalogSummaryResponse> </soap:Body> </soap:Envelope> 5.1.3 5.1.3.1 Filtros de resultados posibles Por el ean13 de productos digitales
La tienda puede utilizar el parmetro opcional <ean13/> para recuperar slo los productos elegidos. Para ello, utilice la siguiente solicitud para recuperar el resumen del catlogo: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getCatalogSummary> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Zero or more repetitions:--> <ean13>9782917144930</ean13> <ean13>9782917144947</ean13> </dwh:getCatalogSummary> </soapenv:Body> </soapenv:Envelope> 5.1.3.2 Por el ean13 de los productos fisicos
La tienda puede utilizar el parmetro opcional <physicalEan13/> para recuperar slo los productos digitales que estn asociados a los productos fsicos especificado. Para ello, utilice la siguiente peticin a modo de ejemplo:
V2.0
CONFIDENTIAL
18/46
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getCatalogSummary> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Zero or more repetitions:--> <physicalEan13>9780002345678</physicalEan13> </dwh:getCatalogSummary> </soapenv:Body> </soapenv:Envelope> 5.1.3.3 Por actualizaciones
Para obtener actualizaciones slo que fueron cometidos desde una fecha determinada, una tienda puede utilizar el parmetro opcional <fromDate/> para recuperar slo los productos digitales que se hayan modificado desde una fecha (fromDate). Para ello, utilice la siguiente solicitud de ejemplo: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getCatalogSummary> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <fromDate>01/06/2010</fromDate> </dwh:getCatalogSummary> </soapenv:Body> </soapenv:Envelope>
V2.0
CONFIDENTIAL
19/46
6 Gestin de Pedidos
6.1 6.1.1 Mtodos de creacion de pedidos (CreateOrder) Parmetros
Despus que un cliente final haya validado su pedido, la web de la tienda enva una solicitud utilizando el CreateOrder del WebServise. Este mtodo permite determinar a la Web de la tienda un pedido para un cliente preciso, de los contenidos digitales disponibles para una tienda en particular. Devuelve un objeto de tipo CreateOrderResponse. Parameters Mandatory Yes Yes No No No No No Yes Yes No No Yes Yes Yes No Comment Identificador nico de la e-librera - [String, 20] Contrasea de la e-librera - [String, 32] Direccion de E-mail del cliente Nombre del Cliente Apellido del cliente ID del cliente Prefijo del cliente Identificador de pedido Identificador de producto Precio del producto Cantidad solicitada, en caso de producto digital, debe tener el valor '1 ' Cantidad solicitada, en caso de producto digital, debe tener el valor '1 ' Identificador del punto de venta/tienda - [String, 50] Identificador del pago Validez de la fecha de pedido Si se establece 'true', el pedido est activado pero no seran tenidos en cuenta por el sistema Tipo de Objeto CreateOrderResponse Lista de productos digitales (download link(s) ) pedidos por un cliente
gencode password customerEmail customerFirstName customerName id prefix orderId ean13 productPrice quantity quantity outletName validityDate verifyOnly Return value
authorizationNumber Yes
V2.0
CONFIDENTIAL
20/46
6.1.2 6.1.2.1
Para crear un pedido , los Parmetros basicos son los siguientes: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:createOrder> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <order> <!--Optional:--> <customer> </customer> <!--Optional:--> <orderId>TEST002</orderId> <!--Zero or more repetitions:--> <orderLines> <!--Optional:--> <ean13>9782917144947</ean13> <productPrice>2332</productPrice> <quantity>1</quantity> </orderLines> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <payment> <!--Optional:--> <authorizationNumber>PAYMENT-xxxxx</authorizationNumber> </payment> <!--Optional:--> <validityDate>2010-05-31T10:55:29Z</validityDate> </order> <verifyOnly>?</verifyOnly> </dwh:createOrder> </soapenv:Body> </soapenv:Envelope>
V2.0
CONFIDENTIAL
21/46
6.1.2.2
Respuesta createOrderResponse
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <orderId>TEST002</orderId> <status>INITIALIZING</status> </return> </ns2:createOrderResponse> </soap:Body> </soap:Envelope> 6.1.2.3 Solicitud para verificar un pedido
Para verificar un pedido, establecer el parmetro VERIFYONLY como verdadero. El WebService slo comprueba si el pedido es vlido, pero no guarda el pedido en el sistema. Para comprobar un pedido, utilice los parmetros siguientes como ejemplo: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:createOrder> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <order> <!--Optional:--> <customer> </customer> <!--Optional:--> <orderId>TEST002</orderId> <!--Zero or more repetitions:--> <orderLines> <!--Optional:--> <ean13>9782917144947</ean13> <productPrice>2332</productPrice> <quantity>1</quantity> </orderLines> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <payment>
V2.0
CONFIDENTIAL
22/46
<!--Optional:--> <authorizationNumber>PAYMENT-xxxxx</authorizationNumber> </payment> <!--Optional:--> <validityDate>2010-05-31T10:55:29Z</validityDate> </order> <verifyOnly>true</verifyOnly> </dwh:createOrder> </soapenv:Body> </soapenv:Envelope> 6.2 6.2.1 Mtodo para confirmar el pedido ConfirmOrder Parmetros
Este Mtodo confirma un pedido ya que hace posible que todos los download links de un pedido visibles para el cliente final. Devuelve un objeto de tipo ConfirmOrderResponse. Parameters Mandatory Yes Yes Yes Comment Identificador nico de la e-librera - [String, 20] Contrasea de la e-librera - [String, 32] Identificador de pedidos - [String, 36] Objeto tipo ConfirmOrderResponse - Lista de enlaces a descargas de los productos solicitados por el cliente 6.2.2 6.2.2.1 Ejemplos Solicitud de Mtodo de confirmacion de pedido (confirmOrder)
Para confirmar un pedido (confirmOrder) , los Parmetros basicos son los siguientes: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:confirmOrder> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <orderId>TEST002</orderId> </dwh:confirmOrder> </soapenv:Body> </soapenv:Envelope>
V2.0 CONFIDENTIAL
23/46
6.2.2.2 Respuesta de la confirmacion de pedido (confirmOrder) El Web Service devuelve todos los detalles del pedido: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:confirmOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <orderId>TEST002</orderId> <orderLines> <downloadUrl>http://fulfillment.sejerdownload.customers.artful.net/telechargement/?id=120f de7e-6d92-11df-99a9-005056836438</downloadUrl> <ean13>9782917144947</ean13> <status>PREPARED</status> <title>Les meurtriers de Dieu</title> </orderLines> <status>OPEN</status> </return> </ns2:confirmOrderResponse> </soap:Body> </soap:Envelope> 6.3 6.3.1 Mtodo de crear y confirmar pedido (CreateAndConfirm) Parmetros Parameters Mandatory Yes Yes No No No No No Yes Yes No Yes Yes Comment Identificador nico de la e-librera - [String, 20] Contrasea de la e-librera - [String, 32] Direccion de E-mail del cliente Nombre del Cliente Apellido del cliente ID del cliente Prefijo del cliente Identificador de pedido Identificador de producto Precio del producto Cantidad solicitada, en caso de producto digital, debe tener el valor '1 ' Identificador del punto de venta/tienda - [String, 50] Identificador del pago
gencode password customerEmail customerFirstName customerName id prefix orderId ean13 productPrice quantity outletName
authorizationNumber Yes
V2.0
CONFIDENTIAL
24/46
Yes
6.3.2 6.3.2.1
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:createAndConfirmOrder> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <order> <!--Optional:--> <customer> <!--Optional:--> <customerEmail>afrances@hotmail.fr</customerEmail> <!--Optional:--> <customerFirstName>Aline</customerFirstName> <!--Optional:--> <customerName>FRANCES</customerName> <!--Optional:--> <id>?</id> <!--Optional:--> <prefix>MLE</prefix> </customer> <!--Optional:--> <orderId>TEST001</orderId> <!--Zero or more repetitions:--> <orderLines> <!--Optional:--> <ean13>9782917144930</ean13> <productPrice>0</productPrice> <quantity>1</quantity> </orderLines> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <payment> <!--Optional:--> <authorizationNumber>PAYMENT-XXXX</authorizationNumber>
V2.0 CONFIDENTIAL
25/46
NOTA= Aunque los datos del grupo customer no son obligatorios y ademas LIbranda recomienda no ponerlos, es necesario que el grupo como tal (customer) sea enviado en la llamada.
6.3.2.2 Respuesta de crear y confirmar Pedido (createAndConfirmOrder) <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createAndConfirmOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <orderId>TEST001</orderId> <orderLines> <downloadUrl>http://fulfillment.sejerdownload.customers.artful.net/telechargement/?id=67af0 5fe-6d91-11df-99a9-005056836438</downloadUrl> <ean13>9782917144930</ean13> <status>PREPARED</status> <title>Le tueur intime</title> </orderLines> <status>OPEN</status> </return> </ns2:createAndConfirmOrderResponse> </soap:Body> </soap:Envelope> 6.3.3 Valores de error Los valores de error son los siguientes:
error
Error codes. Los valores disponibles son : ERROR_INTERNAL : internal error = contacte con su soporte tcnico ERROR_NO_GENCODE : El Gencode no ha sido citado = indicar el Gencode que ha sido comunicada a usted ERROR_NO_PASSWORD : El password no ha sido citado indicar el password que ha sido comunicada a usted ERROR_AUTHENTICATION_FAILED : El Gencode y/or el
V2.0
CONFIDENTIAL
26/46
Password no es o no son validos = contacte con su soporte tcnico . ERROR_INVALID_GENCODE : El gencode es invalido t= indica que el gencode ha sido comunicado . ERROR_INVALID_OUTLET : La tienda especificada no es reconozida en el sistema . = Es necesario especidifcar el nombre de la tienda que le ha sido enviada. ERROR_INVALID_ORDER_ID :El numero de pedido es obligatorio = es necesario indicar el numero de pedido de la tienda. ERROR_NO_DRM_FOR_OUTLET: no se ha definido ningn DRM para el punto de venta= contacte con su soporte tcnico. ERROR_INTERNAL_CREATE_PARTY: error interno= contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_OI: error interno =contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_P: error interno= contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_OR: error interno= contacte con su soporte tcnico ERROR_NO_DRM_FOR_OUTLET: no se ha definido ningn DRM para el punto de venta = contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY: error interno= contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_OI: error interno= contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_P: error interno =contacte con su soporte tcnico ERROR_INTERNAL_CREATE_PARTY_OR: error interno= contacte con su soporte tcnico.
orderId orderLines
String varchar (36) - Identificador nico para el pedido entre un cliente determinado y punto de venta Las lneas de pedido de los productos de control. Una lnea de pedido por EAN13
V2.0
CONFIDENTIAL
27/46
status
6.4 6.4.1
Este mtodo permite cancelar una orden y hacer que todos los enlaces de descarga de un pedido no estn a a disposicin del cliente final. Ofrece un tipo de objeto CancelOrderResponse. Parameters Mandatory Yes Yes Yes Comment Unique retailer identifier - [String, 20] Retailers password to validate his access to information system - [String, 32] Unique identifier of the retailers order - [String, 36] CancelOrderResponse return object type List of all data about the order
6.4.2 6.4.2.1
Para utilizar el mtodo de cancelar un pedido utilice la siguiente solicitud como ejemplo: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:cancelOrder> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Optional:--> <orderId>TEST002</orderId> </dwh:confirmOrder> </soapenv:Body> </soapenv:Envelope> 6.4.2.2 Mtodo de respuesta para cancelar un pedido(cancelOrder) La WebService devuelve todos los datos del pedido
V2.0
CONFIDENTIAL
28/46
V2.0
CONFIDENTIAL
29/46
6.5 6.5.1
El estado del pedido depende de su ciclo de vida el cual puede ser representado de la siguiente manera:
INITIALIZED
Confirmation of the order to the retailer
CANCELED
An order which was canceled is therefore considered by the system as if it never existed, even if its number cannot be reused
OPENED
CLOSE
An order for which all the deliveries have been made is closed
Figura 4 : Estados disponibles para el pedido completo Los diferentes estatus del pedido son los siguientes: Status INITIALIZED OPENED CANCELED CLOSED 6.5.2 Comment El pedido ha sido recivido y aceptado por el sistema El pedido ha sido confirmado por la tienda. El pedido ha sido cancelado por la tienda El peidod entero ha sido enviado con excito
V2.0
CONFIDENTIAL
30/46
Los diferentes estados disponibles para una linea de pedido son los siguientes: Status ORDERED PREPARED CANCELED Comments la lnea de pedido esta en el sistema la lnea de pedido esta lista para ser entregada la lnea de pedido ha sido cancelada
V2.0
CONFIDENTIAL
31/46
Este mtodo permite a la tienda obtener los datos de todos sus pedidos. Devuelve un objeto de tipo exportResponse . Parameters Mandatory Yes Yes No No No No No No No No No No Multiplicity One and only one One and only one Zero or many Zero or many Zero or many Zero or many Zero or many Zero or One Zero or One Zero or many Zero or One Zero or One Comments Identificador nico de la e-librera [String, 20] Contrasea de la e-librera que le permite el acceso a los servicios web - [String, 32] Identificacin de un punto de venta de la e-librera - [String, 50] Identificador de producto digital Identificador de producto fisico Ident.Orden nico del Canal-[String, 36] ID identificador Incluir solo los productors que han sido modificado desde una fecha (fromDate) Incluir solo los productors que han sido modificado hasta una fecha (toDate) Campo Para iniciar ndice de los productos a recuperar Indica el numero de productos a recuperar
gencode password outletName ean13 physicalEan13 orderID userID fromDate toDate field startIndex count
7.1.2 7.1.2.1
V2.0
CONFIDENTIAL
32/46
<!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Zero or more repetitions:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Zero or more repetitions:--> <ean13>?</ean13> <!--Zero or more repetitions:--> <physicalEan13>?</physicalEan13> <!--Zero or more repetitions:--> <userId>?</userId> <!--Optional:--> <fromDate>25/05/2010</fromDate> <!--Optional:--> <toDate>02/06/2010</toDate> <!--Zero or more repetitions:--> <field>?</field> <!--Optional:--> <startIndex>?</startIndex> <!--Optional:--> <count>?</count> </dwh:exportData> </soapenv:Body> </soapenv:Envelope> 7.1.2.2 Respuesta de la exportacion de datos (exportData)
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:exportDataResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <count>10</count> <orderData> <customer> <adobeId/> <customer> <customerEmailAddress>lboucheikha@sejer.com</customerEmailAddress> <customerFaxAddress/> <customerFirstName>Jean-Luc</customerFirstName> <customerId>customerId</customerId> <customerMobileAddress/> <customerName>Canela</customerName> <customerPhoneAddress/> <customerPostalAddress/> <customerPrefix>customerPrefix</customerPrefix> </customer>
V2.0
CONFIDENTIAL
33/46
<userDomain>Ebookstore</userDomain> </customer> <delivery> <deliveryDate>2010-06-01T18:05:43.095+02:00</deliveryDate> <deliveryType>DOWNLOAD</deliveryType> <downloadUrl>http://fulfillment.sejerdownload.customers.artful.net/telechargement/?id=0254 4fc6-52e2-11df-99a9-005056836438</downloadUrl> <downloadsMax>3</downloadsMax> <drm>DRM Nouveaux Auteurs</drm> <expectedDeliveryDate>2010-06-01T18:05:43.046+02:00</expectedDeliveryDate> <status>PREPARED</status> </delivery> <events> <date>2010-04-28T18:22:17+02:00</date> <message>02544fc6-52e2-11df-99a9-005056836438</message> <type>DespatchEvent</type> </events> <id>02544fc6-52e2-11df-99a9-005056836438</id> <order> <date>2010-04-28T18:20:50+02:00</date> <id>024e498c-52e2-11df-99a9-005056836438</id> <outletId>64ff5af6-8321-102d-9b0a-001ec9d0d7da</outletId> <outletName>EBOOKSTORE-TEST</outletName> <vendorReference>2004202010-4577</vendorReference> </order> <product> <authorFirstName/> <authorLastName>Favan</authorLastName> <collectionId/> <collectionName/> <coverUrl/> <ean13>9782917144930</ean13> <imprintId/> <imprintName/> <languageCode/> <name>Le tueur intime</name> <onix/> <priceCurrency/> <publisherId/> <publisherName>Les Nouveaux Auteurs</publisherName> <subname/> <widgetUrl/> </product> </orderData> <orderData> <customer> <adobeId/>
V2.0
CONFIDENTIAL
34/46
<customer> <customerEmailAddress>afrances@hotmail.fr</customerEmailAddress> <customerFaxAddress/> <customerFirstName>Aline</customerFirstName> <customerId>customerId</customerId> <customerMobileAddress/> <customerName>FRANCES</customerName> <customerPhoneAddress/> <customerPostalAddress/> <customerPrefix>customerPrefix</customerPrefix> </customer> <userDomain>Ebookstore</userDomain> </customer> <delivery> <deliveryDate>2010-06-01T18:05:43.098+02:00</deliveryDate> <deliveryType>DOWNLOAD</deliveryType> <downloadUrl>http://fulfillment.sejerdownload.customers.artful.net/telechargement/?id=120f de7e-6d92-11df-99a9-005056836438</downloadUrl> <downloadsMax>3</downloadsMax> <drm>DRM Nouveaux Auteurs</drm> <expectedDeliveryDate>2010-06-01T18:05:43.053+02:00</expectedDeliveryDate> <status>PREPARED</status> </delivery> <events> <date>2010-06-01T17:38:45+02:00</date> <message>120fde7e-6d92-11df-99a9-005056836438</message> <type>DespatchEvent</type> </events> <id>120fde7e-6d92-11df-99a9-005056836438</id> <order> <date>2010-06-01T17:26:38+02:00</date> <id>120e87d6-6d92-11df-99a9-005056836438</id> <outletId>64ff5af6-8321-102d-9b0a-001ec9d0d7da</outletId> <outletName>EBOOKSTORE-TEST</outletName> <vendorReference>TEST002</vendorReference> </order> <product> <authorFirstName/> <authorLastName>Depreux</authorLastName> <collectionId/> <collectionName/> <coverUrl/> <ean13>9782917144947</ean13> <imprintId/> <imprintName/> <languageCode/> <name>Les meurtriers de Dieu</name>
V2.0
CONFIDENTIAL
35/46
<onix/> <priceCurrency/> <publisherId/> <publisherName>Les Nouveaux Auteurs</publisherName> <subname/> <widgetUrl/> </product> </orderData> <startIndex>0</startIndex> <total>10</total> </return> </ns2:exportDataResponse> </soap:Body> </soap:Envelope> 7.1.3 7.1.3.1 Filtros Solicitud de parmetros bsicos para obtener una lista de todos los productos pedidos en un mes.
Para obtener la lista de todos los productos pedidos pedidos en un mes , use los siguientes Parmetros como ejemplo: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:exportData> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Zero or more repetitions:--> <outletName>EBOOKSTORE-TEST</outletName> <fromDate>01/05/2010</fromDate> <!--Optional:--> <toDate>01/06/2010</toDate> </dwh:exportData> </soapenv:Body> </soapenv:Envelope> 7.1.3.2 Solicitud de Parmetros basicos para obtener una lista de todos los Download Links de una tienda especificamente.
V2.0
CONFIDENTIAL
36/46
<soapenv:Body> <dwh:exportData> <!--Optional:--> <gencode>EBOOKSTORE</gencode> <!--Optional:--> <password>ORVnM7eqAf</password> <!--Zero or more repetitions:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Zero or more repetitions:--> <userId>AFR</userId> <field>USER_LINKS</field> <!--Optional:--> </dwh:exportData> </soapenv:Body> </soapenv:Envelope> 7.2 7.2.1 Mtodo getLink Parmetros
Esta funcin permite reuperar los enlaces de descarga para los productos digitales pedidos por el cliente. Devuelve un objeto tipo getLinkResponse. Parameters Mandatory Yes Yes Yes Yes No No Multiplicity One and only one One and only one One and only one One and only one Zero or many Zero or many Comments Identificador unico del canal - [String, 20] Contrasea del canal - [String, 32] Identificador del punto de venta [String, 50] Identificador del pedido - [String, 36] No utilizar No utilizar
V2.0
CONFIDENTIAL
37/46
<!--Optional:--> <password> ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <orderId>7361234566</orderId> </dwh:getLink> </soapenv:Body> </soapenv:Envelope> 7.2.2.2 Respuesta del Mtodo getLink <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:getLinkResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <count>1</count> <orders> <links> <ean13>9788429764628</ean13> <orderLineId>f725818c-9031-11df-81e9-0050569f2853</orderLineId> <status>DELIVERED</status> <title>La nit de les papallones</title> <url>http://acs4.zumbuk.com/download/?id=f123458c-9031-11df-81e90050569f2853</url> </links> <links> <ean13>9788499180687</ean13> <orderLineId>f7259942-9031-11df-81e9-0050569f2853</orderLineId> <status>DELIVERED</status> <title>El anticuario</title> <url>http://acs4.zumbuk.com/download/?id=f6789042-9031-11df-81e90050569f2853</url> </links> <links> <ean13>9788492695973</ean13> <orderLineId>f725c5ac-9031-11df-81e9-0050569f2853</orderLineId> <status>DELIVERED</status> <title>EL CLUB DE LOS VIERNES</title> <url>http://acs4.zumbuk.com/download/?id=f6789ac-9031-11df-81e90050569f2853</url> </links> <orderId>7361234566</orderId> </orders> <startIndex>0</startIndex> <total>1</total> </return>
V2.0
CONFIDENTIAL
38/46
Esta funcin permite recuperar los pedidos realizado por un Outlet entre fechas. Devuelve un objeto tipo getOrderResponse. Parameters Mandatory Yes Yes Yes No No No No Multiplicity One and only one One and only one One and only one Zero or One Zero or One Zero or One Zero or many Comments Identificador unico del canal - [String, 20] Contrasea del canal - [String, 32] Identificador del punto de venta [String, 50] Fecha Inicio para la bsqueda deseada. Fecha Inicio para la bsqueda deseada. Indice de primer resultado Vease el Capitulo 4, Seccin 4.2 Numero de resgitros a devolver Vease el Capitulo 4, Seccin 4.2 7.3.2 7.3.2.1 Ejemplos Solicitud al Mtodo getOrder
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getOrder> <!--Optional:--> <gencode> EBOOKSTORE</gencode> <!--Optional:--> <password> ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <beginDate>?</beginDate> <!--Optional:--> <endDate>?</endDate>
V2.0 CONFIDENTIAL
39/46
<startIndex>?</startIndex> <count>?</count> </dwh:getLink> </soapenv:Body> </soapenv:Envelope> 7.3.2.6 Respuesta del Mtodo getOrder <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:getOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <count>10</count> <orders> <customerId/> <orderId>14246_3</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-19T18:48:14+02:00</receivedDate> </orders> <orders> <customerId/> <orderId>14246_2</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-16T16:06:16+02:00</receivedDate> </orders> <orders> <customerId>?</customerId> <orderId>123455vcxz</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-16T13:28:37+02:00</receivedDate> </orders> <orders> <customerId>1</customerId> <orderId>12345vcxz</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-16T13:28:06+02:00</receivedDate> </orders> <orders> <customerId/> <orderId>14246_1</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-16T12:36:29+02:00</receivedDate> </orders>
V2.0
CONFIDENTIAL
40/46
<orders> <customerId>300</customerId> <orderId>14246</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-16T12:03:59+02:00</receivedDate> </orders> <orders> <customerId>?</customerId> <orderId>14453_rafa1</orderId> <orderStatus>OPEN</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-07T16:30:01+02:00</receivedDate> </orders> <orders> <customerId>?</customerId> <orderId>14453_rafa</orderId> <orderStatus>OPEN</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-06T11:18:06+02:00</receivedDate> </orders> <orders> <customerId>?</customerId> <orderId>14453</orderId> <orderStatus>OPEN</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-07-05T16:32:10+02:00</receivedDate> </orders> <orders> <customerId>?</customerId> <orderId>AD302</orderId> <orderStatus>INITIALIZING</orderStatus> <outletName>EBOOKSTORE-TEST</outletName> <receivedDate>2010-06-30T18:15:40+02:00</receivedDate> </orders> <startIndex>0</startIndex> <total>13</total> </return> </ns2:getOrderResponse> </soap:Body> </soap:Envelope> 7.4 7.4.1 Mtodo getOrderEvent Parmetros
Esta funcin proporciona una lista de sucesos relacionados los productos de un pedido. Devuelve un objeto tipo getOrderEventResponse.
V2.0 CONFIDENTIAL
41/46
Parameters
Multiplicity One and only one One and only one One and only one One and only one
Comments Identificador unico del canal - [String, 20] Contrasea del canal - [String, 32] Identificador del punto de venta [String, 50] Identificador del pedido - [String, 36]
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh: getOrderEvent> <!--Optional:--> <gencode> EBOOKSTORE</gencode> <!--Optional:--> <password> ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <orderId>7361234566</orderId> </dwh: getOrderEvent> </soapenv:Body> </soapenv:Envelope> 7.4.2.2 Respuesta del Mtodo getLink <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:getOrderEventResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <events> <dateTime>2010-07-15T18:59:04+02:00</dateTime> <ean13>9788484608844</ean13> <orderLineId>f725dc90-9031-11df-81e9-0050569f2853</orderLineId> <type>acs4-fulfillment</type> </events> <events> <ean13/>
V2.0
CONFIDENTIAL
42/46
<orderLineId/> <type/> </events> <events> <dateTime>2010-07-15T18:58:59+02:00</dateTime> <ean13>9788484608844</ean13> <orderLineId>f725dc90-9031-11df-81e9-0050569f2853</orderLineId> <type>download-start</type> </events> <events> <dateTime>2010-07-15T18:58:43+02:00</dateTime> <ean13>9788492695973</ean13> <orderLineId>f725c5ac-9031-11df-81e9-0050569f2853</orderLineId> <type>acs4-fulfillment</type> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <dateTime>2010-07-15T18:58:37+02:00</dateTime> <ean13>9788492695973</ean13> <orderLineId>f725c5ac-9031-11df-81e9-0050569f2853</orderLineId> <type>download-start</type> </events> <events> <dateTime>2010-07-15T18:58:16+02:00</dateTime> <ean13>9788420498850</ean13> <orderLineId>f725af9a-9031-11df-81e9-0050569f2853</orderLineId> <type>acs4-fulfillment</type> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <dateTime>2010-07-15T18:58:10+02:00</dateTime> <ean13>9788420498850</ean13> <orderLineId>f725af9a-9031-11df-81e9-0050569f2853</orderLineId> <type>download-start</type> </events> <events> <dateTime>2010-07-15T18:57:39+02:00</dateTime> <ean13>9788499180687</ean13> <orderLineId>f7259942-9031-11df-81e9-0050569f2853</orderLineId> <type>acs4-fulfillment</type>
V2.0
CONFIDENTIAL
43/46
</events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <dateTime>2010-07-15T18:57:34+02:00</dateTime> <ean13>9788499180687</ean13> <orderLineId>f7259942-9031-11df-81e9-0050569f2853</orderLineId> <type>download-start</type> </events> <events> <dateTime>2010-07-15T18:57:21+02:00</dateTime> <ean13>9788429764628</ean13> <orderLineId>f725818c-9031-11df-81e9-0050569f2853</orderLineId> <type>acs4-fulfillment</type> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <dateTime>2010-07-15T18:57:04+02:00</dateTime> <ean13>9788429764628</ean13> <orderLineId>f725818c-9031-11df-81e9-0050569f2853</orderLineId> <type>download-start</type> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <ean13/> <orderLineId/> <type/> </events> <events> <ean13/> <orderLineId/> <type/>
V2.0
CONFIDENTIAL
44/46
</events> <events> <ean13/> <orderLineId/> <type/> </events> </return> </ns2:getOrderEventResponse> </soap:Body> </soap:Envelope>
7.5
Mtodo getOrderStatus
Esta funcin proporciona el estado actual del pedido. Devuelve un objeto tipo getOrderStatusResponse. 7.5.1 Parmetros Mandatory Yes Yes Yes Yes Multiplicity One and only one One and only one One and only one One and only one Comments Identificador unico del canal - [String, 20] Contrasea del canal - [String, 32] Identificador del punto de venta [String, 50] Identificador del pedido - [String, 36]
Parameters
7.5.2.1 Solicitud al Mtodo getOrderEvent <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh: getOrderStatus>
V2.0
CONFIDENTIAL
45/46
<!--Optional:--> <gencode> EBOOKSTORE</gencode> <!--Optional:--> <password> ORVnM7eqAf</password> <!--Optional:--> <outletName>EBOOKSTORE-TEST</outletName> <!--Optional:--> <orderId>7361234566</orderId> </dwh: getOrderStatus> </soapenv:Body> </soapenv:Envelope> 7.5.2.2 Respuesta del Mtodo getOrderStatus <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:getOrderStatusResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <status> <orderId/> <orderLines> <ean13>9788429764628</ean13> <orderLineId>5753f916-845d-11df-843f-0050569f7229</orderLineId> <status>PREPARED</status> <title>La nit de les papallones</title> </orderLines> </status> </return> </ns2:getOrderStatusResponse> </soap:Body> </soap:Envelope> Los diferentes estados de la lnea de pedido son los siguientes:
V2.0
CONFIDENTIAL
46/46
V2.0
CONFIDENTIAL