Guía de Integración de Trusted Shops

Transcripción

1 Guía de Integración de Trusted Shops Sello de Calidad de Trusted Shops con protección al comprador EXCELLENCE Versión 2.2 es-es 2015 Trusted Shops GmbH

2 Contenido 1. El Sello de calidad de Trusted Shops con Protección del comprador Protección del comprador de Trusted Shops Servicio web de Trusted Shops para completar una Protección del comprador Tratamiento de errores Integración de la Protección del comprador en el Front-end de la tienda El Distintivo de confianza con la Tarjeta de confianza de Trusted Shops Servicio al cliente Trusted Shops GmbH 2

3 1. El Sello de calidad de Trusted Shops con Protección del comprador 1.1 Protección del comprador de Trusted Shops Funcionamiento La opción para completar la Protección del comprador de Trusted Shops se muestra en la caja de la Protección del comprador cuando se selecciona el método de pago. La Protección del comprador puede ser activada o desactivada en la tienda por el comprador con la casilla de confirmación. Si el cliente de Trusted Shops ha seleccionado la Protección del comprador, esta se agregará al pedido como si fuera un producto. La casilla de confimación está seleccionada por defecto, esto se aplica incluso si el cliente abandona la página y vuelve más tarde, por ej. cuando añade nuevos productos a la cesta de la compra. Dependiendo del valor de la cesta de la compra (p.ej. precio de los productos y gastos de envío), se mostrará el producto de Protección del comprador de Trusted Shops que mejor se adapte. Se adecuará el producto más pequeño de Trusted Shops que asegure la compra en su totalidad (p.ej., para una compra de 600 euros, el producto de "Protección del comprador de Trusted Shops será de hasta euros"). En la página con la vista general del pedido, se incluirá el producto de Protección del comprador junto con los productos solicitados, incluyendo los gastos de envío, en el precio final. Una vez se haya confirmado el pedido, se accederá al Servicio web de Protección del comprador de Trusted Shops con el método Solicitud de protección V2() con los parámetros correspondientes. En un breve periodo de tiempo la activación Conseguir estado de solicitud () comprueba si Trusted Shops ha aceptado la garantía. La garantía será reservada en el sistema de Trusted Shops y el cliente será notificado por correo electrónico. Las garantías completadas pueden verse en el inicio de sesión de la tienda bajo El propietario de la tienda debe asegurarse de que todas las solicitudes para la Protección del comprador sean recibidas correctamente a través de la interfaz y que las garantías se completen también correctamente Proceso esquemático en la tienda La Protección del comprador de Trusted Shops se ofrece a la salida, junto con la selección del método de pago. Figura 1: Representación esquemática de la Protección del comprador Excellence de Trusted Shops 2015 Trusted Shops GmbH 3

4 1.1.3 Proceso técnico Figura 2: Proceso técnico de la Protección del comprador Excellence de Trusted Shops Características y cálculo de los productos de Protección del comprador La Protección del comprador de Trusted Shops se completa incluyendo en la Cesta de la compra un producto de Protección del comprador durante el proceso de pedido. La designación de los productos de Protección al comprador contienen, respectivamente, el valor máximo y el plazo de duración del aseguramiento. El producto TS080501_500_30_EUR se refiere, por ejemplo, a una Protección del comprador de hasta 500 euros con un plazo de garantía de 30 días. Por favor, guarde los siguientes productos de Protección del comprador de Trusted Shops en la tienda siempre que no se le hayan comunicado otros productos. ID del Producto de Trusted Shops (tsproductid) TS080501_500_30_EUR TS080501_1500_30_EUR TS080501_2500_30_EUR TS080501_5000_30_EUR TS080501_10000_30_EUR TS080501_20000_30_EUR Precio neto 0,82353 EUR 2,47059 EUR 4,11765 EUR 8,23530 EUR 16,47060 EUR 32,94120 EUR Para los productos de Protección del comprador se aplica: Los productos de Protección del comprador de Trusted Shops se almacenan en la tienda o en la base de datos, sin embargo, no se muestran en el catálogo general de productos de la tienda. Los productos de Protección del comprador sólo pueden reservarse a la salida. Los productos de Protección del comprador están disponibles de forma ilimitada. Se puede incluir un máximo de un producto de Protección del comprador en la Cesta de la compra. Los productos de Protección del comprador siempre se guardan con su precio neto Trusted Shops GmbH 4

5 A los productos de Protección del comprador se les agrega el tipo impositivo que está asignado al servicio en su totalidad. Si los productos están sujetos a un tipo impositivo uniforme, éste será determinante. En Cestas de la compra a las que se aplican diferentes tipos impositivos, recomendamos el tipo impositivo más alto. Los detalles deberán ser aclarados por parte de la tienda, de forma individual, con su asesor fiscal. El precio de los productos de Protección del comprador se mostrarán en la tienda de acuerdo con los precios de otros productos, es decir, como precio bruto en la tienda B2C y como precio neto en la tienda B2B. El valor de los productos de Protección del comprador de Trusted Shops aumenta la cantidad total de una factura de compra. La Protección del comprador de Trusted Shops será completada sólo en relación a los productos de la tienda y a los servicios de transporte asociados, la Protección del comprador no se asegura a sí misma. Los posibles descuentos no se aplicarán a los productos de Protección del comprador. En el siguiente ejemplo, el valor total de la factura es de 195,97 euros; la Protección del comprador de Trusted Shops se solicita por un importe de 195,00 euros: Ejemplo de cálculo (18% IVA includio): Producto 1 Producto 2 Descuento del método de pago 5% Gastos de envío Protección del comprador de Trusted Shops hasta 500 euros Total EUR EUR EUR 5.00 EUR 0.97 EUR EUR Administración de los certificados de Trusted Shop Un certificado de Trusted Shops se identifica por una clave alfanumérica de 33 caracteres de largo, la ID de Trusted Shops (TS-ID). La ID de Trusted Shops se comunica al propietario de la tienda después de efectuar el registro con Trusted Shops. Una ID de Trusted Shops sólo es válida, exlusivamente, para una URL de la tienda en un sólo idioma. Si dentro del sistema de la tienda se administrasen varias tiendas online o varias versiones de la tienda en otros idiomas, a cada una de ellas deberá asignarsele su propia ID de Trusted Shops. Para cada certificado de Trusted Shops se otorgará también un inicio de sesión del Servicio web (WSLogin), con el cual se solicita una Protección del comprador. 1.2 Servicio web de Trusted Shops para completar una Protección del comprador Este Servicio web para el Front-end de la tienda cuenta con dos métodos para la conclusión y la comprobación de la Protección del comprador. Se puede acceder al Servicio web para la conclusión de una Protección del comprador a través de las siguientes URLs de Trusted Shops. URI del Servicio web del entorno de comprobación ("Sandbox") URI del Servicio web del entorno productivo tservice?wsdl 2015 Trusted Shops GmbH 5

6 1.2.1 requestforprotectionv2() El método requestforprotectionv2() es la función central dentro del proceso de conclusión de la garantía de Protección del comprador. Los datos requeridos de la transacción de una compra se transmiten a Trusted Shops y el Servicio web genera una solicitud de Protección del comprador. Trusted Shops comprueba la validez formal de las solicitudes, las almacena y las procesa a intervalos regulares. Por favor, preste atención también a los avisos sobre el Tratamiento de errores, para asegurarse siempre de que cualquier solicitud de Protección del comprador ha sido recibida con éxito por la interfaz Designación y tipo de datos Definición WSDL: <message name="applicationrequestservice_requestforprotectionv2"> <part name="tsid" type="xsd:string"/> <part name="tsproductid" type="xsd:string"/> <part name="amount" type="xsd:decimal"/> <part name="currency" type="xsd:string"/> <part name="paymenttype" type="xsd:string"/> <part name="buyer " type="xsd:string"/> <part name="shopcustomerid" type="xsd:string"/> <part name="shoporderid" type="xsd:string"/> <part name="orderdate" type="xsd:datetime"/> <part name="shopsystemversion" type="xsd:string"/> <part name="wsuser" type="xsd:string"/> <part name="wspassword" type="xsd:string"/> </message> Parámetros Parámetros Descripción Comentario tsid tsproductid amount currency paymenttype buyer shopcustomerid ID de Trusted Shops para el certificado Código del producto de Protección del comprador Valor de la factura incluidos los gastos de envío Divisa de la compra, ISO 4217 de 3 dígitos Constante del método de pago Dirección de correo electrónico del comprador Número de cliente del comprador Obligatorio, es otorgado a cada certificado por parte de Trusted Shops. Cada idioma de la tienda y cada tienda por separado en una así llamada "Solución multitienda", necesitan su propio certificado Obligatorio, véase la tabla de Productos de Protección del comprador Obligatorio, formato con punto como caracter de separador decimal, dos decimales después del punto (p.ej ) Obligatorio, p.ej. Código ISO para el Euro = EUR Obligatorio, específico de Trusted Shops, véase la lista de métodos de pago disponibles Obligatorio Obligatorio, en caso de que no se haya facilitado introducir el valor "0" 2015 Trusted Shops GmbH 6

7 shoporderid orderdate shopsystemversion wsuser wspassword Número de pedido del comprador Fecha del pedido en la tienda online Versión del software y, en su caso, del módulo de Trusted Shops, p.ej., "topshop v2.1" Ususario del Servicio web Contraseña del Servicio web Obligatorio Obligatorio, formato: 31/10/2011T09:30:00 Obligatorio, cualquier string Obligatorio, es otorgado para cada certificado por separado por parte de Trusted Shops Obligatorio, es otorgado para cada certificado por separado por parte de Trusted Shops Valor devuelto Un valor positivo devuelto significa que la solicitud del Servicio web se ha procesado con éxito, el valor corresponde al número de la solicitud de Protección del comprador. Un valor negativo devuelto indica un error; el valor representa el Código de error Código de ejemplo (PHP) La siguiente sección describe un ejemplo de la llamada a la interfaz del comprador después de que el cliente haya completado el pedido. Un requisito previo es la extensión PHP 5 SOAP. Los pasajes marcados deberán adaptarse. Ejemplo de código PHP (por favor sustituya el texto marcado en amarillo): define("soap_error", -1); define("ts_server", "protection.trustedshops.com"); # Collect parameters for the webservice call # TS-ID received by Trusted Shops $tsid = "{TS-ID}"; # Defined by Trusted Shops, depends on order total amount $tsproductid = "TS080501_500_30_EUR"; $orderdate = date("y-m-d", time()). "T". date("h:i:s", time()); $shopsystemversion = "Shop 4.0 TS.01"; # Collect other parameters $decimalamount = (double) $amount; #... # Call TS protection webservice $ini = ini_set("soap.wsdl_cache_enabled", 1); try { $wsdlurl = " TS_SERVER. "/ts/protectionservices/applicationrequestservice?wsdl"; $client = new SoapClient($wsdlUrl); # Set return value for the case if a SOAP exception occurs $returnvalue = SOAP_ERROR; # call WS method $returnvalue = $client-> requestforprotectionv2 ($tsid, $tsproductid, (double)$amount, $currency, $paymenttype, $buyer , $shopcustomerid, $shoporderid, $orderdate, $shopsystemversion, $wsuser, $wspassword); } catch (SoapFault $fault) { $errortext = "SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault- >faultstring})"; echo $errortext; } 2015 Trusted Shops GmbH 7

8 # Check return value # Negative return value is an error code, positive value is the application number if ($returnvalue == SOAP_ERROR) { echo "SOAP error: $errortext"; } else if ($returnvalue < 0) { error_log "TS Webservice returns error code $returnvalue"; switch ($returnvalue) { case : echo "Cause: login failed or no valid shop found for tsid '$tsid'"; break;... } } else { echo "TS Webservice has successfully returned application number '$returnvalue'"; } Métodos de pago Al completarse la Protección del comprador de Trusted Shops, el método de pago seleccionado por el cliente se transmite a Trusted Shops. Los métodos de pago aceptados por Trusted Shops se designan de la siguiente manera. Por favor, organice los métodos de pago utilizados en la tienda según los métodos de pago de Trusted Shops. Code DIRECT_DEBIT CREDIT_CARD INVOICE CASH_ON_DELIVERY PREPAYMENT CHEQUE PAYBOX PAYPAL CASH_ON_PICKUP FINANCING LEASING T_PAY CLICKANDBUY GIROPAY GOOGLE_CHECKOUT SHOP_CARD DIRECT_E_BANKING ES Cargo / domiciliación bancaria Tarjeta de crédito Factura Reembolso Pago anticipado / transferencia Cheque de abono en cuenta Paybox PayPal Pago a la recogida Financiación Leasing T-Pay Click&Buy Giropay Google Checkout Tarjeta de pago de la tienda online SOFORT Banking 2015 Trusted Shops GmbH 8

9 MONEYBOOKERS DOTPAY PLATNOSCI PRZELEWY24 OTHER moneybookers.com Dotpay Płatności Przelewy24 Otro método de pago getrequeststate() Con el método getrequeststate() se realiza una consulta sobre el estado de una solicitud de garantía y, en caso de una reserva correcta, se devuelve el número de garantía. Un valor positivo devuelto de la requestforprotectionv2() significa que la solicitud de Protección del comprador se ha transmitido con éxito y que está en una cola de mensajes en Trusted Shops. Sin embargo, se reconocerán los errores semánticos (p.ej., un número de pedido incorrecto o duplicado) sólo durante la tramitación de la solicitud. Con la activación del método getrequeststate() se comprobará si las solicitudes de garantía solicitadas a través de requestforprotectionv2() han sido aceptadas por Trusted Shops, ya que sólo a una solicitud procesada correctamente le corresponde una garantía de Trusted Shops. Trusted Shops recomienda automatizar la activación a través de una tarea programada (Cronjob) con un intervalo de 10 minutos. Puesto que la solicitud de Protección del comprador hecha en la tienda y la confirmación a través de Trusted Shops tienen lugar con un intervalo de tiempo, se deberá llevar a cabo un Tratamiento de errores. Durante los tiempos muertos por parte de Trusted Shops y las excepciones SOAP, la garantía puede volver a importarse hasta tres días más tarde (con datos de transacciones reparados) Designación y tipo de datos Definición WSDL: <message name="applicationrequestservice_getrequeststate"> <part name="tsid" type="xsd:string"/> <part name="applicationid" type="xsd:long"/> </message> Parámetros Parámetros Descripción Comentario tsid applicationid ID de Trusted Shops para el certificado Número de solicitud de Protección del comprador Obligatorio, es otorgado a cada certificado por parte de Trusted Shops. Cada idioma de la tienda y cada tienda por separado en una así llamada "Solución multitienda", necesitan su propio certificado Obligatorio, valor devuelto de Solicitud de Protección V2 () Valor devuelto Un valor positivo devuelto significa que la solicitud del Servicio web se ha procesado con éxito, el valor corresponde al número de la garantía. Un valor negativo devuelto indica un error; el valor representa al Código de error Trusted Shops GmbH 9

10 1.3 Tratamiento de errores Realice un seguimiento durante la fase de integración y el uso productivo de los códigos de error y las excepciones SOAP para reconocer lo más pronto posible los errores de implementación o de configuración. En lo que respecta a posibles errores de excepción o a la indisponibilidad de la página web de Trusted Shops, un tratamiento de erores ofrece la seguridad de que todas las solicitudes de Protección del comprador se transmitan a Trusted Shops. El propietario de la tienda es responsable de asegurar que cada solicitud de Protección del comprador se transmita a Trusted Shops. Las solicitudes de Protección del comprador pueden repetirse con los datos corregidos en un plazo de tres días. El estado actual de una garantía se comprueba con ayuda del método getrequeststate(). Función Descripción Comentario Queue-Handling Registro cronológico Almacenamiento y procesamiento de la solicitud de garantía Registro de las solicitudes de garantía, los códigos de error, las excepciones SOAP, etc. Obligatorio, p.ej. con un reintento de, como máximo, 3 veces en un intervalo de 8 horas, tras esto la cancelación Obligatorio, p.ej. en forma de una lista de reservas de las garantías completadas en el Panel de control de la administración de la tienda Códigos de error Código Valor devuelto Causas NO_VALID_SHOP El Servicio web o la TS-ID no son válidos LIMIT_CANCELLED El límite de crédito de la tienda fue revocado por Trusted Shops DUPLICATE_ORDER_NUMBER Número de pedido usado varias veces UNSUPPORTED_TS_PRODUCT Producto de Protección del comprador no soportado INACTIVE_PAYMENT_TYPE Método de pago inactivo UNSUPPORTED_PAYMENT_TYPE Método de pago no soportado CURRENCY_MISMATCH La divisa del producto de Protección del comprador no coincide con la divisa de la Cesta de la compra UNSUPPORTED_CURRENCY La divisa no se acepta en esta tienda UNSUPPORTED_EXCHANGE_RATE El tipo de cambio no es compatible NOT_PERSISTENT_PAYMENT_TYPE El método de págo no es compatible NO_LIMIT No se dispone de límite de crédito para este certificado PAST_DELIVERY_DATE La fecha de entrega es una fecha pasada TOO_OLD_ORDER La garantía se ha solicitado para una compra que se efectuó hace más de 3 días _MALFORMED El formato de la dirección de correo electrónico 2015 Trusted Shops GmbH 10

11 contiene errores ORDER_ID_EMPTY No se ha transmitido ningún número de pedido CUSTOMER_ID_EMPTY No se ha transmitido ningún número de cliente LIMIT_OVERFLOW _EMPTY WRONG_TS_PRODUCT Se ha sobrepasado el límite de crédito para este certificado No se ha transmitido ninguna dirección de correo electrónico Producto con protección del comprador no aplicable L ORDER_DATE_FUTURE La fecha del pedido es en el futuro INVALID_SECURITY_TOKEN Token de seguridad inválido SYSTEM_EXCEPTION Error en el sistema general, por favor póngase en contacto con Trusted Shops Excepciones SOAP comunes Durante la fase de implementación y de operación pueden producirse excepciones SOAP. Los errores de excepción comunes tienen las siguientes causas: Error Invalid number of payload elements: 12 Error code: env:server java.lang.numberformatexception Date value does not follow the format... String index out of range: 0 Causas Comprobar el número y el orden de los parámetros transmitidos Cantidad de dinero no válido Fecha no válida Fecha vacía Identificadores para los entornos de prueba Durante la fase de implementación, utilice los siguientes identificadores para cada idioma. Recibirá las identificaciones del entorno productivo con la activación por parte de la persona de contacto de Trusted Shops. Identificadores del Servicio web para el idioma ES: ID de Trusted Shops (tsid): Nombre de usuario (wsuser): Contraseña (wspassword): XE4B3DB09D28E89EE815C09C60CF6218F testexcellencepartneres test Integración de la Protección del comprador en el Front-end de la tienda Posición de la caja de la Protección del comprador de Trusted Shops La caja de la Protección del comprador de Trusted Shops se mostrará a la salida de forma visible durante la selección del método de pago Trusted Shops GmbH 11

12 1.4.2 Textos dentro de la caja de la Protección del comprador de Trusted Shops Figura 3: Ejemplo de una caja de la Protección del comprador Excellence En la caja de la Protección del comprador se utilizarán los siguientes textos para los respectivos idiomas de la tienda. La especificación del impuesto al valor añadido tiene lugar sin mención del tipo impositivo, es decir con el aditivo "IVA incluido" (p.ej. " IVA excluido " en la tienda B2B). Textos específicos para los paises con el idioma ES (por favor sustituya el texto marcado en amarillo): [ ] Protección del comprador de Trusted Shops (recomendar) Protección del comprador de hasta 500 EUR (0,98 EUR IVA includio) La garantía Trusted Shops incluida en la protección del comprador le asegura su compra online. Estoy de acuerdo con la transmisión y el almacenamiento de mi dirección de correo electrónico para la tramitación de la protección del comprador por parte de Trusted Shops. Condiciones de garantía para la protección del comprador Enlaces de la caja de la Protección del comprador El logotipo de Trusted Shops y los términos marcados se enlazarán, de forma independiente al idioma, de la siguiente manera. El parámetro shop_id corresponde a la ID de Trusted Shops del certificado. Utilice para los enlaces respectivamente este parámetro de enlaces target= _blank, que abre la página en una nueva ventana o pestaña del navegador. URL del enlace para el logotipo de Trusted Shops (por favor, sustituya el texto marcado en amarillo): URL del enlace "almacenamiento" (por favor, sustituya el texto marcado en amarillo): URL del enlace "Garantía de Trusted Shops", "Condiciones de la garantía" (por favor, sustituya el texto marcado en amarillo): Trusted Shops GmbH 12

13 1.5 El Distintivo de confianza con la Tarjeta de confianza de Trusted Shops Trusted Shops ha desarrollado una tecnología moderna y llamativa de integración con la cual los adheridos a Trusted Shops muestran desde el comienzo de forma clara su fiabilidad: el distintivo de confianza. La URL para la integración del distintivo de confianza es: Si desea implementar el sello de calidad de Trusted Shops en otros puntos dentro de la comunicación con sus clientes, está a su disposición el paquete de publicidad con distintos ejemplos de nuestro sello de confianza y sus formas de aplicación. Usted puede encontrar este paquete en nuestro centro de integración ( 2. Servicio al cliente Para preguntas sobre la integración del Sello de calidad de Trusted Shops con Protección del comprador o de la Valoración del vendedor, por favor, póngase en contacto con: Trusted Shops GmbH Servicio para asociados Correo electrónico: members@trustedshops.es 2015 Trusted Shops GmbH 13