Guía de Integración ASAP Magento

ASAP
Integraciones
Ecommerce – Plugin de Magento
Versión Beta 0.1.0

Introducción

El plugin de Magento es una aplicación de ASAP que añade la funcionalidad de realizar tareas básicas de creación y seguimiento de órdenes desde la plataforma de Magento.

Esta guía fue redactada como un paso a paso para realizar el proceso de instalación, configuración del plugin y realizar los ajustes de envío asociados, lista de pedidos y creación de órdenes a partir de los estándares y esquemas establecidos por la plataforma
de Magento.

Limitaciones y Alcance

Este plugin no abarca configuraciones esenciales del flujo de proceso y/o comunicación asociados a la plataforma de Magento, como los métodos de pago, así como, toda aquella configuración relacionada al look and feel o diseño de la plataforma.

El plugin es open source, el código de fuente está disponible, por lo tanto el cliente puede ajustarlo de acuerdo a los requerimientos personalizados.

 

Requerimientos Técnicos

Geocoding API de googlemaps; el plugin de ASAP se apoya con el geocoding api de google maps para ubicar la latitud y longitud de los puntos de delivery de los clientes que hacen compras desde el shop.

Será necesario que configurar una cuenta en google maps, habilite el Geocoding API, asocie el ip del dominio o del servidor que aloja la página de Magento y genere el KEY, el cual será usado en el proceso de configuración del plugin.

El plugin integra el ASAP api ecommerce , útil para la gestión de órdenes generadas por terceros o partners que se integren con ASAP.

Accesos Rápidos

1. Instalación

2. Configuración

3. Estado de Orden

4. Método de Envío 

5. Configuración de Correo

6. Configuración Plantilla de Correo

 

1. Instalación

  1. Descomprima el archivo ASAP_1.0.0.zip en una carpeta; verá el folder app.
  2. Subir el folder app en la instalación de Magento; se sobrescribirá la carpeta app con la carpeta de la aplicación del módulo ASAP_1.0.0.
  3. Ahora para verificar que haya subido archivos correctamente. Debería ir al directorio app/code y debería ver el directorio AsapShipping .
  4. Inicie sesión en SSH usando el usuario root y vaya a su instalación de Magento desde allí.
  5. Después de ir a la instalación de Magento desde la terminal SSH, ejecute el comando php bin/magento setup: upgrade . Este comando puede variar según el sistema operativo de su servidor.
    Para algunos comandos del sistema pueden aplicarse de uno de los siguientes:
    sudo bin/magento setup:upgrade sudo bin/magento-cli setup:upgrade sudo php bin/magento setup:upgrade
  6. Ahora ejecute el comando php bin/magento cache:clean . Recuerde que el comando php bin/magento inicial puede cambiar según el sistema operativo de su servidor.
  7. Si el módulo está instalado correctamente, puede iniciar sesión en el administrador y desde la sección Store > Setting debería ver la pestaña ASAP SHIPPING SETTINGS
  8. Ver video

 

2. Configuración

Después de la instalación del paquete ASAP_1.0.0 , seguir los siguientes pasos para la configuración del mismo desde la interfaz del administrador.

  1. Seleccionar la opción Stores.
  2. Configuración de envío ASAP.
  3. Llenar el formulario API and Messages, con los datos proporcionado por su account manager de ASAP, para los ambientes de test como de live.
  4. Especificar la clave API de Google Maps; solo debe tener restricciones para la IP o URL de su sitio web. Esta clave API de Google Maps es obligatoria para que este complemento funcione; si desea usar otro servicio, puede editar el código fuente.

    Google Maps API Key AIzaSyAmFHTQkjN4duc7jHZIWJGBGqlgtSNNr8Q

    ASAP API Token (Test): b34075039fbb320ca384c9fa405e69f6fb66874c

    ASAP API Shared Secret (Test): 9c22c479e8a59df7d7ef9b083d405cb461b42ee5

    ASAP API Key (Test): 8t8p4hPaqgiuYsCuhZJci9zJRVV6K4fJKFGDeuN7

  5. En las ubicaciones de recogida, debe especificar la dirección correcta y los valores de latitud y longitud. Importante señalar que cualquier configuración incorrecta aquí, puede provocar que los detalles de envío no se generen correctamente.

3. Estados de Orden

El plugin procesa los pedidos cuando el estado del pedido cambia su estado a Completado o Pedido enviado. Para ello debe realizar la siguiente configuración:

  1. Ir a la opción de Stores desde el menú de opciones.
  2. Seleccionar la opción Order Status.
  3. Presione la opción Assign Status to State.
  4. Desde Assign Status to State, seleccione Complete en Order Status y Pending
    en Order State.
  5.  Guardar Assign Status to State.
  6. Seleccione nuevamente la opción Assign Status to State, seleccione Complete en
    Order Status y Processing en Order State
  7. Guardar Assign Status to State.

4. Método de Envío

  1. Abrir las opciones de configuración de Stores.
  2. Desplegar las opciones de Sales.
  3. Seleccionar Delivery Methods
  4. Seleccionar ASAP Shipping; habilitar y aplicar a específicos países y seleccionar Panamá.
  5. Configurar Título, nombre del método, costo
  6. Guardar

5. Configuración de Correo

  1. Seleccione la opción Marketing, desde el menú de Opciones.
  2. Luego seleccione Email Templates.
  3. Seleccione Agregar nueva plantilla desde la parte superior.
  4. En Cargar plantilla predeterminada, seleccione Order Update y haga clic en Cargar
    plantilla.
  5. Asigne el nombre de la plantilla Solicitar actualización AsapShip . Reemplace el contenido de la plantilla con lo siguiente (sin comillas):
    correo_paso5

  6. Haga clic en Guardar plantilla en la parte superior derecha.

  7. Nuevamente, haga clic en Agregar nueva plantilla desde la parte superior y luego en Cargar plantilla predeterminada seleccione Order Update for guest y haga clic en Cargar plantilla.

  8. Ingrese el nombre de la plantilla Solicitar actualización de invitado de Asapship y en el contenido ingrese lo siguiente:
    correo_paso8

  9. Haga clic en Guardar plantilla en la parte superior derecha

    6. Configuración de las plantillas de correo electrónico

    Haga clic en Guardar plantilla en la parte superior derecha.

    1. Abrir opciones de Store desde el menú del Admin.
    2. Configuración
    3. Ventas
    4. Correos electrónicos de ventas
    5.  Comentarios de pedidos.
    6. Seleccione la plantilla que ha agregado en el paso anterior para Order comment email template y Order comment email template for Guest.  Es posible que deba desmarcar la casilla de verificación Use system default value a la derecha.
    7. Haga clic en Guardar configuración en la parte superior derecha.
    8. Cada vez que realice cambios en cualquier configuración, debe borrar la caché de
      Magento desde la opción de Sistema, Administración de caché y actualizando la
      caché invalidada.

Cómo generar una orden

  • +507 830.7013
  • info@asap507.com
  • Ciudad de Panamá, Panamá.

Company

Descargas

Solicita más información

Close Menu