manual de la configuración y uso del módulo de asm para prestashop

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
([email protected])
Para el contacto comercial: 91 327 28 80 [email protected]
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.