Guia Api MyHandyBuy Woocommerce
Guia actualizada de apoyo al técnico para el administrador de tiendas Worpdress Woocommerce, Shopify, Magento y Prestashop ; te recomiendo que sigas cada paso y lo compares con tu instalación real para el correcto funcionamiento. Consulta al final los “casos de fallas y las causas y soluciones que pueden presentarse” para que puedas operar sin problema este conector; las versiones probadas y en perfecto funcioanmiento de cada Motor de Tienda Web son las mas recientes, y en cada seccion te esta guia se detallan por cada una.
Sromo / Tecnico Master Desarrollador Mojomexico.
primer paso: Descarga tu PLUGIN ZIP
Sigue las instrucciones de descarga de nuestra zona de descargas el Plugin de nuestro Conector para la versión de tu tienda como te hemos enviado; este PLUGIN está protegido y listo para ser instalado en tu tienda WC, PS, Magento y Shopify; no es necesario Desempacar, o corres el riesgo de dañarlo.
QUE CONTIENE ESTE PLUGIN ZIP?
El codigo de Software necesario para la INTEGRACION PROVEEDORES (MARKETPLACE) desde cada versión-motor de tienda web (woocommerce , prestashop, magento, shopify) con la tienda Woocommerce MYHANDYBUY para integrar LAS ORDENES DE PEDIDO PROCESADAS con el software (tienda web) de PROVEEDOR integrando al Cliente / Nuevo Cliente, identificando los Productos Vendidos y Generando la Nueva Orden Procesada.
INDICE GENERAL:
Solo haz clic en la MARCA de tu TIENDA para Configurar tu Conexión.
- GUIA DE CONFIGURACION PARA WORDPRESS WOOCOMMERCE :
- GUIA DE CONFIGURACION TIENDAS PRESTASHOP
- GUIA DE CONFIGURACION TIENDAS MAGENTO
- GUIA DE CONFIGURACIÓN SHOPIFY
Instalacion Plugin en woocommerce:
Como SUPER ADMIN (WORDPRESS (BACKADMIN) en la SECCION PLUGIN– NUEVO— AGREGAR ahi carga tu archivo ZIP como se muestra en la siguiente imagen.
paso 2:
Activación del servicio REST-API natural de Woocommerce:
Nuestro programa tiene la especialidad de CONSUMIR LOS RECURSOS AVANZADOS que WordPress y Woocommerce han diseñado para darle más potencia a tu TIENDA y que ésta se pueda comunicar, integrar y propagar con otros “mercados como en este caso, y para muchos otros mercados como amazon-market, pch mayorista, sae-conexionweb etc “.
Este recurso se activa de forma fácil sin el minimo conocimiento técnico y te lo explicamos a continuación; solo abre la zona ADMIN — WOOCOMMERCE -AJUSTES-AVANZADO como se ve en esta foto:
Si es la primera vez que lo usas, debes hacer clic en boton API-HEREDADA, solo necesitas hacerlo una vez y se mantendrá activo el servicio.
Despues dar clic al boton de ACTIVAR, ya podrás continuar en la casilla REST-API es ahi donde podrás crear por primera vez tu conexion MYHANDYBUY-MOJOMEXICO, en la casilla “descripcion” escribe “conexion handybuy mojomexico” , y en la casilla siguiente “Permisos” ajustalo a “permiso leer-escribir” ; ya puedes dar clic a Guardar.. y en automático Woocommerce va a generar 2 LLAVES: CONSUMER-KEY Y CONSUMER-SECRET y las va a presentar como en la foto:
Sólo COPIA estas llaves en algun lugar aparte porque las vas a necesitar para configurar tu conector en LA SIGUIENTE SECCION PASO3 ; en caso de que la pierdas, puedes crear una nueva sin problema solo recuerda que debes actualizar de nuevo estas llaves y mantener el servicio activo (como ya lo haz configurado).
PASO 3
- Ahora a continuacion en esta seccion Woocommerce puedes notar EN LA TAB INTEGRACION: Woocommerce –> Ajustes –> Integracion –> MOJOMARKETPLACE CONEXION MOJOMEXICO API (se nota claramente el submenu en esta zona). Ahi vamos a rellenar los datos que faltan con la informacion que haz generado. La casilla “LICENCIA MOJOMEXICO” es el dato que nosotros te enviamos ya creado en la entrega de tu plugin despues de tu compra.
- URL TIENDA WC:aqui debes insertar tu URL actual DE TU TIENDA con subcarpeta dentro de tu Hositings, por eje:
- “http://midominio.com/tienda (la Subcarpeta dentro de tu hosting en que estan los programas WP en caso de que asi lo uses, NOTA QUE NO DEBES INCLUIR SLASH FINAL como en la foto.
- Llave API y SECRET .- son las llaves ApiKey y ApiSecret que haz creado previamente como se indico al inicio de esta guia.
- Status de Ordenes Recuperadas .- indica el estatus de las ordenes Entrantes al momento que se registren.
PASO 4
Enviar Notificación a Mojomexico:
Despues de la instalación de tu conector, ya habrás notado que EN LA COLUMNA IZQUIERDA-MENU-ADMIN general se presenta e una nueva PESTAÑA: MOJOMEXICOMRK con varios sub-menus internos.
Desde ese punto es donde vas a administrar toda la actualización y sincrnización de Productos de forma muy sencilla y amigable-
ENVIAR NOTIFICACION DE INSTALACION A MOJOMEXICO:
En esta seccion de usa el submenu ENVIAR NOTIFICACION para que nuestro sistema pueda recibir tu notificación de llaves a y datos de tu tienda y podamos agregarte como PROVEEDOR AUTORIZADO para recibir la conexión desde la tienda MYHANDYBUY de los Pedidos de tus Productos.
Recomendaciones de Seguridad:
Hacer un Respaldo de Seguridad de la Base de Datos y el Sistema:
Al momento que nos notifican sus credenciales, pueden pasar hasta 12 horas antes de procesar la primera prueba, en este tiempo podrás hacer el respaldo necesario de tu Sistema WordPress Woocommerce y la Base de Datos; conserva este respaldo fuera de todo para que en caso necesario puedas restablecer tu tienda sin riesgo ni perdida.
confirmar correcto funcionamiento en su tienda de PERMALINK en WordPress:
Los servicios RESTPAPI DE WOOCOMMERCE requieren que se establezcan las zonas PERMALINK (ENLACES PERMAMENTES) de una forma CUSTOMIZABLE (PERSONAL) a las necesidades de conexion.
Es por esto que pedimos que sino lo haz hecho hasta ahora, apliques la siguiente modificación como se muestra en a foto (PANEL ADMIN — AJUSTES — PERMALINK O ENLAVES PERMANENTES segun el idioma de tu tienda).
REQUERIMIENTOS MINIMOS DE CONFIGURACION DE WORDPRESS Y WOOCOMMERCE:
1.- Para este consumo de SERVICIOS RESTAPI WOOCOMMERCE es preferible contar en tu SERVICIO HOSTING con la siguiente configuración:
Haber instalado la VERSION JMAS RECIENTE DE WOOCOMMERCE (4.X)
2.- En caso de estar usando algun sistema de Firewall Hosting, será necesario que agregues la IP de MYHANDYBUY para que acepta las peticiones consulta y escritura esta conexion requiere.
3.- Es probable que tu servicio SSL instalado para tu Dominio te esté bloqueando las acciones de REQUEST API, por lo que debes modificar o deshabilitar para hacer pruebas, si esto soluciona el problema, solo debes agregar a la LISTA BLANCA de tu servicio tu IP o Dominio o URL completo.
eventos de trasmisión de datos que se ralizan en este proceso:
desde la tienda HANDYBUY (HB) cada orden se ENVIA solo las ordenes que tienen la marca PAGADAS (COMPLETED o PROCESED) .
Antes de entregar esta información a cada Proveedor, se verifica que:
1.- EL CLIENTE, sino existe (por email) entonces se crea nuevo creado de forma automatica; se verifica el ID-Cliente (nuevo Cliente) en este proceso.
2.- Asi igual para CADA ITEM VENDIDO se envio una PETICION para conocer el ID-PRODUCTO dentro del catalogo WOOCOMMERCE por lo que deben COINCIDIR POR SKU en AMBOS PUNTOS DENTRO DEL CATALOGO .
3.- Cuando ya se tienen confirmados se envia la petición como NUEVA ORDEN que incluye tanto los datos del Cliente como los Productos Vendidos y sus cantidades, la forma de pago y envio.
forma de reportar cualquier falla al depto tecnico mojomexico:
Se te recomienda que en caso de que se presente algun error en alguno de los procesos, primero lo revises EN:
Woocommerce — Estado — Registro
y NOS COPIES LA PANTALLA DE REPORTE DE ERROR (como en la foto) y nos lo envies via mail a ” soporte@mojomexico.com.mx” anexando el detalle del proceso que estabas ejecutando. Nosotros te responderemos en el minimo tiempo posible las 24 horas todo el año-
