You are on page 1of 46

1/46

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

PRESENTACION DE PROCESOS ....................................................................................... 6


2.1 2.2

3 4

CATALOGO DE WEB SERVICES ..................................................................................... 10 CONVENCIONES UTILIZADAS......................................................................................... 12


4.1 4.2 GESTION DE ERRORES ........................................................................................................... 12 RESULTADOS DE PAGINACION .............................................................................................. 12

GESTION DE CATALOGO ............................................................................................... 13


5.1 METODO GETCATALOGSUMMARY ........................................................................................ 13 5.1.1 Parmetros ............................................................................................................................ 13 5.1.2 Ejemplos............................................................................................................................... 13 5.1.3 Filtros de resultados posibles ..................................................................................................... 17

GESTION DE PEDIDOS ................................................................................................... 19


6.1 METODOS DE CREACION DE PEDIDOS (CREATEORDER)....................................................... 19 6.1.1 Parmetros ............................................................................................................................ 19 6.1.2 Ejemplos............................................................................................................................... 20 6.2 MTODO PARA CONFIRMAR EL PEDIDO CONFIRMORDER ................................................................... 22 6.2.1 Parmetros ............................................................................................................................ 22 6.2.2 Ejemplos............................................................................................................................... 22 6.3 METODO DE CREAR Y CONFIRMAR PEDIDO (CREATEANDCONFIRM) ................................... 23 6.3.1 Parmetros ............................................................................................................................ 23 6.3.2 Ejemplos............................................................................................................................... 24 6.3.3 Valores de error ..................................................................................................................... 25 6.4 MTODO PARA CANCELAR PEDIDOS LNEAS DE PEDIDO (CANCELORDER) ....................... 27 6.4.1 Parmetros ............................................................................................................................ 27 6.4.2 Ejemplos............................................................................................................................... 27 6.5 PEDIDOS Y ESTADOS DE PROSESOS DE SINCRONIZACION ..................................................... 29 6.5.1 Estado del pedido ................................................................................................................... 29 6.5.2 Estado de la linea de pedido ...................................................................................................... 29

GESTION DE SERVICIOS AL CLIENTE ............................................................................. 31


7.1 METODOS DE EXPORTACION (EXPORTDATA) ....................................................................... 31

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

Los distintos flujos se puede representar de la siguiente manera :

Billing

Publisher Publisher Publisher Distributor


Orders verification

e-Platform

Metadata Database
Metadata

Publisher
Ebooks (Metadata and files)

e-Distribution system

Distribution order

Retailer website

Order

Publisher
Statistics

ebooks Digital Warehouse

Download link Customer services

E-book download

Figura 1 : Flujo de Distribucin de contenidos digitales.

V2.0

CONFIDENTIAL

4/46

1.2

Objetivo del documento

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

<Product> <RecordReference>9788493780494</RecordReference> <NotificationType>05</NotificationType> <ProductIdentifier> <ProductIDType>03</ProductIDType> <IDValue>9788493780494</IDValue> </ProductIdentifier> </Product>

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.

SOAP, basado en tecnologa Web Service no es optimo para este caso.

V2.0

CONFIDENTIAL

9/46

Metadatos ONIX_IN Fichero Epub

Publisher Group

Catlogo Productos ONIX_OUT

Retailer

ePlataforma
Fichero Excel

Publisher

Fichero Epub

ePlataforma se proporciona por Libranda

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

Figura 3 : ePlataforma proceso de acceso.

3 Catlogo de Web services


La lista de servicios web para implementar en la interfaz de la tienda contiene los siguientes mtodos:

V2.0

CONFIDENTIAL

11/46

Web Services - Retailer

Role

Catalog management Operations


getCatalogSummary Para obtener la lista del productos ean13 disponible para una tienda especifica.

Orders management Operation


createOrder confirmOrder createAndConfirmOrder cancelOrder Para poder enviar un nuevo pedido desde la WEB del tienda. Para confirmar un pedido previamente enviado desde la tienda. Para enviar y confirmar un pedido al mismo tiempo. Para cancelar totalmente un pedido sumistrado al sistema,sino ha sido descargado por cliente.

Customer services management Operation


exportData getLink getOrder getOrderEvent getOrderStatus Para exportar datos de los pedidos: lista de pedidos, estatus y acciones asociadas a cada uno de los pedidos. Recupera la url de descarga de un pedido ya confirmado Obtiene una lista de las ordenes de un punto de venta Obtiene lista de eventos relativos a una orden Obtiene el estado de una orden

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

Cdigo de error - String Cdigo de error String

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

Mtodo para obtener getCatalogSummary

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

</soapenv:Envelope> 5.1.2.2 Respuesta del Mtodo de getCatalogSummary

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

Ejemplos Mtodo de solicitud para crear un pedido (createOrder)

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)

gencode password orderId


Return value

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

validityDate Return value

Yes

Validez de la fecha de pedido Objeto tipoCreateAndConfirmOrderResponse

6.3.2 6.3.2.1

Ejemplos Mtodo de Solicitud de crear y confirmar pedido. (createAndConfirmOrder)

<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

</payment> <!--Optional:--> <validityDate>2008-12-08T15:39:22.306+01:00</validityDate> </order> </dwh:createAndConfirmOrder> </soapenv:Body> </soapenv:Envelope>

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

Indicador de estado de tramitacin del pedido completo Vase la figura 4

Mtodo para cancelar pedidos lneas de pedido (CancelOrder) Parmetros

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

gencode password orderId


Return value

6.4.2 6.4.2.1

Ejemplos Mtodo de solicitud para cancelar un pedido (cancelOrder)

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

En el caso de ser satisfatoria la cancelacin (epub no descargado)


<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:cancelOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <order> <date>2010-07-21T20:29:24+02:00</date> <orderId>TEST002</orderId> <orderLine> <ean13>9788433932204</ean13> <status>CANCELLED</status> <title>book-test</title> </orderLine> <outletId/> <outletName>EBOOKSTORE-TEST</outletName> <vendorReference>TEST002</vendorReference> </order> </return> </ns2:confirmOrderResponse> </soap:Body> </soap:Envelope>

En el caso de NO poder cancelar la orden (epub descargado)


<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:cancelOrderResponse xmlns:ns2="http://dwh.sejer.com/"> <return> <order> <date>2010-07-21T20:29:24+02:00</date> <orderId>TEST002</orderId> <orderLine> <ean13>9788433932204</ean13> <status>DELIVERED</status> <title>book-test</title> </orderLine> <outletId/> <outletName>EBOOKSTORE-TEST</outletName> <vendorReference>TEST002</vendorReference> </order> </return> </ns2:confirmOrderResponse> </soap:Body> </soap:Envelope>

V2.0

CONFIDENTIAL

29/46

6.5 6.5.1

Pedidos y estados de prosesos de sincronizacin Estado del pedido

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

Estado de la linea de pedido

El ciclo de vida del pedido puede ser represenatdo de la siguiente manera:

Figura 5 : Estados disponibles para una linea de un pedido completo

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

DELIVERED La lnea de pedido ha sido entregada (El cliente ya tiene el pedido!!)

V2.0

CONFIDENTIAL

31/46

7 Gestin de Servicios al Cliente


7.1 7.1.1 Mtodos de Exportacion (Exportdata) Parmetros

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

Ejemplos Mtodo de Solicitud de exportacin de datos.(exportData)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:exportData>

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.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/>

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

gencode password outletName orderID startIndex count


7.2.2 7.2.2.1 Ejemplos

Solicitud a Mtodo getLink

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dwh="http://dwh.sejer.com/"> <soapenv:Header/> <soapenv:Body> <dwh:getLink> <!--Optional:--> <gencode> EBOOKSTORE</gencode>

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

</ns2:getLinkResponse> </soap:Body> </soap:Envelope> 7.3 7.3.1 Mtodo getOrder Parmetros

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

gencode password outletName beginDate endDate startIndex count

<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

Mandatory Yes Yes Yes Yes

gencode password outletName orderID


7.4.2 7.4.2.1 Ejemplos

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]

Solicitud a Mtodo getOrderEvent

<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

gencode password outletName orderID


7.5.2 Ejemplos

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

You might also like