18/12/2013 v2 MANUAL DE LA CONFIGURACIÓN Y USO DEL MÓDULO DE ASM PARA PRESTASHOP Contacto Para las dudas con la instalación: Integración de Clientes (iclientes.inf@asmred.es) Para el contacto comercial: 91 327 28 80 ecommerce@asmred.com Requisitos • • • • • • • • • Tener instalada la librería cURL de PHP para las llamadas webservice Tener los datos llenos en la configuración de la tienda al respecto del remitente (dirección, código postal y población). Si no es así, no se podrá insertar en ASM. Los datos rellenar están en Preferencias Contactos de la tienda No hace falta instalar a mano en la configuración de Prestashop ningún transportista así como ninguna tarifa y ninguna zona o país Versión del módulo testada desde la versión 1.4.x a la 1.6.x de Prestashop Los envíos mediante este módulo solamente se pueden realizar a España y Portugal Si se tiene la gestión de stock y almacenes activada (Preferencias Productos Inventario de productos ¿Habilitar las opciones avanzadas del inventario?) hay que activar los servicios de transporte para ese almacén (Existencias Almacenes Modificar Transportistas) y además, hay que indicar el almacén en cada producto de la tienda (Ficha del producto Almacenes). Si no se hace esto, los servicios de ASM no estarán visibles Si usa el módulo para los contrareembolsos “Pago Contrareembolso” de Maofree, debe saber que deberá cambiar una línea en un fichero del módulo ya que dicho módulo viene por defecto para que no se puedan seleccionar transportistas creados mediante un módulo. Deberá editar el fichero /modules/maofree_cashondeliveryfee/maofree_cashondelivery. php y sustituir esta línea $carriers = Carrier::getCarriers((int)($cookie->id_lang), true, false, false); por esta: $carriers = Carrier::getCarriers((int)($cookie->id_lang), true, false, false, NULL, ALL_CARRIERS); 18/12/2013 v2 Descarga del paquete de instalación Para proceder con la descarga del módulo debe dirigirse a http://www.asmecommerce.com/ (sección módulos de integración) y descargarse el paquete de instalación: Instalación del paquete • • Desde el backend de Prestashop: Módulos -> Añadir un módulo a partir de mi ordenador -> Seleccionar el fichero .zip descargado -> Clic en Subir este módulo Dentro de la opción Transportista y Logística -> Clic en el botón instalar • Configuración del módulo 18/12/2013 v2 A continuación se detalla las diferentes partes de la configuración del módulo: Aquí hay que poner el GUID que viene en el comentario. El GUID identifica un código de cliente en ASM. Por defecto, las pruebas deben realizarse con el GUID de pruebas. Al finalizar las pruebas el cliente deberá solicitar el GUID de producción a su agencia ASM y finalmente ponerlo en la configuración (sin las llaves {}) y guardar. En el apartado de URL WS hay que copiar el que viene por defecto en el comentario. Esto es la dirección donde internamente el módulo enviará la información de los pedidos del cliente a ASM Aquí se configura si se desea que haya envíos gratuitos y si es así, cual es el servicio gratuito y el importe mínimo (o número de artículos) para que así sea. En estas opciones se habilitan/deshabilitan los servicios que el cliente desea que estén ofertados a los compradores. 18/12/2013 v2 Aquí se configura el número de bultos que tendrá el pedido. Se puede hacer mediante un valor fijo o según el número de artículos que quepan en un bulto físico. Esta es la zona para el cálculo de la tarifa a los compradores. Puede ser mediante el peso total del envío o mediante el precio total del carrito. Esto se configura mediante dos ficheros csv que se encuentran en la ruta de instalación del módulo (...\prestashop\modules\asmcarrier\asm.tarifas.peso.csv y ...\prestashop\modules\asmcarrier\asm.tarifas.importe.csv). Estos ficheros se configuran mediante código de servicio, país, rango de código postal (de destinatario), precio/peso y precio final de la tarifa. Interpretación de la tarifa mediante ejemplo: Queremos que los envíos hacia la provincia de Barcelona, para el servicio ASM24 cuesten 5 euros si el precio del carrito es menor a 3 euros, 10 euros si el precio del carrito es mayor de 3 euros y menor a 5 euros y gratis a partir de 5 euros. Y para el servicio ECONOMY, el precio final para todos los destinos sea de 13 euros. Para esto tendremos que configurar la tarifa de la siguiente manera: 18/12/2013 v2 El valor 100000 es un valor muy alto donde nunca el precio de un pedido superará esa cifra. Esto se lee de la siguiente manera: • • • Precios pedido hasta 3€: 5€ de importe Precios pedido mayores que 3€ y menores o iguales a 5€: 10€ de importe Precios mayores de 5€ y menores o iguales a 100000€: 0€ Es importante respetar la fila que contiene el 999999. Es la manera de controlar cada rango y la manera, para el caso de tarifa por peso, de añadir el precio por kilo adicional a partir del peso indicado en la línea inmediatamente superior. También es importante saber que si hay algún destino que no se quiera realizar el envío, basta con no poner en el csv el rango de códigos postales correspondientes y que el separador de campos debe ser el punto y coma y el separador decimal debe ser un punto. En esta última parte se configuran el impuesto, el coste fijo y los costes de manipulación. Si en los valores finales de la tarifa implementada en el fichero csv, dichos valores van sin IVA en el recuadro tendréis que poner el % de impuesto tal y como se indica en el comentario. En cambio si vuestra tarifa ya incluye el impuesto, lo tendréis que dejar en blanco. El coste fijo por envío es por si no se quiere añadir ninguna tarifa y todos vuestros envíos, independientemente del destino, valen lo mismo. Dejar vacío si no es así. El módulo ofrece un coste de manipulación fijo o porcentual que se le aplicará a los clientes finales sobre el precio de la tarifa calculada. 18/12/2013 v2 Uso del módulo Para poder enviar la información del pedido a ASM, tiene que ocurrir: • El usuario hace un pedido en la tienda virtual y escoge un servicio de ASM. • En el backend, el administrador irá a pedidos y seleccionará el pedido. • Una vez seleccionado e internamente esté el bulto preparado, habrá que cambiarle el estado del pedido (por ejemplo, "Preparación en curso"). Cuando se producen pagos mediante TPV o PayPal, ese cambio es automático. PARA VERSIONES DE PRESTASHOP 1.5.x EN ADELANTE: • Cuando el pedido haya cambiado de estado, el administrador podrá imprimir la etiqueta desde la misma ficha del pedido: • Cuando se tenga la oportunidad de obtener la etiqueta, el módulo habrá cambiado el estado del pedido a enviado (Si el cambio no se realiza automáticamente, solo hará falta salir del pedido y volver a entrar: 18/12/2013 v2 • Si ocurre algún error con la comunicación hacia ASM, el módulo nos avisará: • Es importante que se contacte que la agencia ASM para avisarles de los nuevos pedidos o para que hagan una recogida diaria y así no tener que avisar más. VERSIONES DE PRESTASHOP INFERIORES A 1.5.X • Para versiones inferiores a 1.5 el envío a ASM no se puede realizar mediante el botón Generar etiqueta integrado en la ficha del pedido y se tiene que hacer desde Pedidos -> ASM • Ahí hay una lista de pedidos donde si pulsamos sobre el botón pdf enviará la información a ASM y podremos sacar la etiqueta. • Para estas versiones de prestashop el módulo no enviará correo electrónico ni actualizará automáticamente el estado del pedido. Se deberá realizar manualmente. Notas El módulo solo puede ofrecer un precio al usuario si este introduce una dirección de envío. Esto ocurre cuando el usuario se registra pero en muchos casos no hay registro. Cuando se da esto último el precio nunca será el correcto. Para solucionar esto, y que al usuario cuando añada al carrito, le salga el mismo precio que si estuviera haciendo el proceso de checkout, hay que seguir los siguientes pasos: • Hay que entrar en la ficha de los transportistas creados por el módulo (Transporte Transportistas) e indicar que la visibilidad sea solo para usuarios registrados: 18/12/2013 v2 • Crear un nuevo transportista (no importa el nombre) e indicar que la visibilidad es para usuarios visitantes e invitados: • Ponerle la tarifa a este nuevo transportista usando el interface de Prestashop De esta forma, cuando un visitante añada algo al carrito, le saldrá el precio correcto, y posteriormente cuando se registre y ponga una dirección de entrega, saldrá el precio definido por el módulo de ASM y el pedido se quedará guardado con el transportista correcto.