Guia API Syscom Woocommerce

Guia actualizada de apoyo al técnico y administrador de nuestro PLUGIN SYSCOM-WC ; te recomiendo que sigas cada paso y lo compares con tu instalación real para el correcto funcionamiento. Este conector FUNCIONA MUY BIEN EN HOSTING VPS-MOJOMEXICO, y hemos comprobado que otros “servidores hosting de terceros ” no tienen o no conocen las necesidades reales de una Conexión Avanzada como esta. 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 WordPress son desde 4.x hasta la ultima version 5.x y Woocommerce desde 3.x y 4.x y no tenemos duda que siga vigente nuestro conexión sin errores ni conflictos en el futuro para tu tranquilidad. Sromo / Tecnico Master Desarrollador Mojomexico.

Hemos creado ésta Guia de Configuración del conector SYSCOM-Woocommerce catalogo y promociones del Mayorista de computación para que te sea más fácil usar nuestro producto; en todos los productos Mojomexico que adquieras siempre vas a contar con estas guías mas el soporte ilimitado via ticket.

Aqui vas a notar que todo el catalogo queda Insertado en la tienda Woocommerce de forma profesional y exácta y donde puedes agruparlo de esta forma en tu tienda WC : teclado, monitor, mouse, gabinete, memoria, disco duro…) o lo que a ti mas te convenga.

Nuestro codigo toma toda la información que el proveedor Mayorista puede ofrecerte y aprovechamos éste potencia asi podras notar en cada articulo la Descripción corta y larga, Ficha Técnica de cada producto, Imágenes, Precio Normal convertido a tu Moneda, Inventario al Dia, etc.

Cuando usas nuestros Programas de Conexion WEbServices como en este producto “Conexion SYSCOM” vas a contar con la LIBERTAD de usar las PASARELAS DE PAGO MOJOMEXICO o de otras marcas siempre y cuando sean compatibles con Woocommerce4; asi no tienes que depender de un tercero para vender; o si requieres que Mojomexico Administre toda la operación de tu tienda con ésta fácilidad también te lo podemos ofrecer solo envianos tus ideas por mail y seguramente encontraremos la mejor solucion para ti .

Puedes PROBAR ANTES DE COMPRAR aqui mismo en esta TIENDA WC DEMO que hemos preparado, solo ingresa HAZ TU REGISTRO en este sitio y espera unos minutos a recibir tu activacion asi podrás USAR Y PROBAR este conector en vivo sin limitacion alguna.

Iniciamos con la guía de Configuración:

Qué vas a encontra aqui?

Nosotros te entregamos la versión personalizada de tu Conexión previamente LICENCIADA (te la enviamos por ZIP en un periodo de 24 horas despues de tu compra solo requerimos algunos paramentros que debes enviarnos todas estas instrucciones se detallan en tu pedido). Asi podrás instalar fácil y en forma de PLUGIN WORDPRESS (debes contar con NIVEL ADMINISTRADOR en tu WordPress para todas las acciones que vamos a describir); solo visita la zona Admin –PLUGINS como se muestra en la imagen a continuación, en caso de que YA tengas una instalacion previa de nuestro conector, entonces BORRA por completo y vuelve a instalar como Nuevo.

Se carga de forma Normal como cualquier Plugin de WordPress

Queda Agregado de forma normal como todos nuestros desarrollos de conectores para Woocommerce

PASO 2

Requieres activar tu 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 continuacion; 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 mantendra activo el servicio. Es probable que ésta acción ya se encuentre activa por eventos de otro plugin o porque el equipo de Mojomexico ya hizo estos pasos por ti si solicitaste apoyo para la instalacion, de ser asi, yano tienes nada que cambiar, solo revisa que esté tal y como se indica aqui y evita cambiar.

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 CVA-MOJOMEXICO, en la casilla “descripcion” escribe “conexion cva 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 CVA-MOJOMEXICO ; 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 4

Ahora nos pasamos a la zona de Woocoomerce – Productos — Categorias para configurar previamente los elementos que vas a requerir antes de cualquier actualizacion.

En esta zona es donde DEBES ACTIVAR TUS CATEGORIAS que vas a usar para SEGMENTAR EL CATALOGO WC en tu TIENDA.

Esto lo puedes notarlo en nuestra DEMO , asi puedes ver que usamos “monitores o memorias o disco duro, etc” para agrupar las distintas paquete de grupos que CVA organiza en su catalogo.

Cuando estas iniciando por primera vez una tienda Wooommerce y aun no haz agregado ningun producto, es importante que ACTIVES UNO POR LO MENOS,dando de alta primero una CATEGORIA PADRE por eje: prueba, y un articulo prueba o test , salvar. 

Ya podemos poner a trabajar tu nuevo conector SYSCON:

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: MOJOMEXICO SYSCOM, CVA, y todas las versiones de plugin que hayas contratado  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-

RECUERDA que la información que nuestra conexion integra, DEPENDE TOTALMENTE de los PERMISOS Y RECURSOS de cada Provedor en este caso SYSCOM, por lo que en caso de presentarse algun error en pantalla al procesar aguna accion o no se complete la accion esperada, es importante que NOS COPIES LA IMAGEN de la pantalla con el error, y es preferible que incluyas el URL para que podamos apoyarte de forma mas precisa y rápida. Algunos eventos marcar error de TOKEN.. en éste caso no es un error de codigo sino de permisos y vigencia que el provedor ha revocado o a vencido. cualquier que sea la razon, te sugerimos que consultes con el depto de soporte de syscom para que ellos te confirmen cual es la causa y juntos podamos apoyarte de forma mas precisa para el exito del uso de esta conexion.

Cuentas con una Zona de Instrucciones y ayuda en linea insertado en tu conexion.

Podrás notar submenús que van a activar todas las actualizaciones en un Clic de los articulos con el resultado inmediato, no requiere mayor accion de tu parte , porque todo lo hacemos por ti de forma fácil y sencilla.

NO OLVIDES GENERAR TU RESPALDO DE TU CATALOGO Y TIENDA PREVIO A CUALQUIER NUEVA ACCION para evitar perdida ; las acciones que aqui se van a aplicar son directas a la BASE DE DATOS y solo mediante tu respaldo podrás restablecer todo al estado antes de aplicar este programa.

Cuando ha procesado una actualización ,. vas a notar que los productos quedan grabados en la tienda Woocommerce cada uno clasificado con su CATEGORIA , asi como su imagen actual que se toma directo de la DATA descargada del sistema ERP de cada MAYORISTA.

DATA: muchos datos extras como fichas tecnicas PDF, videos, etc que el provedor Mayorista Ofrece , NO se enuentran disponibles para ser integrados por la API o solo puedes integrar de forma manual. para ésto es importante que REVISES Y LEAS LA GUIA SYSCOM API Documentacion del Desarrollador, para que ahi puedas comparar y conocer el tipo de informacion que está autorizada para descarga, y si en algun momento al integrarse a la TIENDA WOOCOMMERCE falta informacion o requieres de alguna forma especial, no dudes en comentarlo DENTRO DE TU TICKET, agregando de forma amplia y de ser posible con imagenes la forma en como te gustaria tenerla disponible dentro de WP WOOCOMMERCE.

 

ALTA DE CATALOGO SYSCOM POR GRUPOS COMPLETOS:

GRUPOS:

Es la primera accion de esta conexion y es ahi donde podras llamar por GRUPOS COMPLETOS todos los Articulos para ser activados por primera vez en la tienda Woocommerce, por ejemplo: “Grupo Sguridad…” 

MARCAS:

Syscom ofrece poder segmentar la integracion POR MARCA, pero esto es lo que ofrece la documentacion. Nosotros hemos hecho pruebas y lo que realmente funciona es usando “todos…” porque en muchas combinaciones por Grupo-Marca el personal de soporte Syscom nos ha comentado que puede ser que NO se incluyan todos asi que lo mejor es dejar esta opcion como “todos..”

PORCENTAJE: Es el Porcentaje de GANANCIA QUE TU VAS A APLICAR a cada articulo del GRUPO-MARCA que estás activando, tomando como BASE el precio ESPECIAL de Distribuidor, o tu vas a poder escoger qué precio deseas USAR en el cálculo de tu PRECIO FINAL EN TIENDA. La regla de cálculo se te muestra en el BOTON INSTRUCCIONES O AYUDA que encuentras en el mismo formulario.

PAGINAS:

Es la unica  forma en como Syscom permite descargar más de 60 articulos, y pueden ser tantas paginas como ellos lo determinen, pero en las guia de desarrollo Syscom no aclara hasta cuantas paginas puede tener cada Grupo, asi que la unica opcion es que PRUEBES empezando de la pagina 1 hasta N… en los comentarios de ayuda de soporte syscom, nos han dicho que hay grupos y marcas con más de 400 paginas… sin aclarar cuales son, pero tu puedes preguntar directo a tu provedor y compartirnos la informacion para efectos de hacer mas eficiente esta forma de trabajo.

importante:

Recuerda contar con el alta previa de tus “categorias Productos WC” ya que para este paso vas a requerir El ID# de cada categoria WC ; si asi ya fue hecho, entonces van a ser mostrados esto en automatico en esta zona de actualizacion por Grupos.

SYSCOM TIPO DE CAMBIO DEL DIA:

Cuentas con un VERIFICADOR DIARIO DE TIPO DE VALOR PESO-DOLAR que aplica Syscom por lo que podrás con seguridad dar el Precio exacto.

mapa de acciones del conector:

Las acciones que puedes realizar por cada uno de las opciones se listan a continuacion; cada una de ellas fue realizada con estricto control de SEGURIDAD por lo que NO existe ningun riesgo de falla o daño a la base de datos ni que se re-escriban los articulos (a menos que la base de datos ya contenga errores por esto se te recomienda que antes de ejecutar estos proceso tengas a la mano tu respando y la seguridad de que tu base de datos esté sana, puedes comprobar el estado de tu WP-WC con algunos Plugins extras que el mismo WC Market provee incluso gratis).

 

garantia de cero errores en los procesos de actualización y resultados

Puedes repetir las acciones de ALTA , ACTUALIZACION Y PROMOCIONES las veces que sean necesarios SIN NINGN RIESGO de que se rescriba lo anterior (nos referimos a la zona de nombre, descripcion larga y descripcion corta). Asi que vas a notar que cuando ejecutas por ejemplo “alta por grupos” que ya habias activado unos dias antes, podrás notar que el nuevo resultado puede ser “ya activo” y significa que el SKU – articulo ya existe en tu catalogo WC, pero tambien bas a notar otro mensaje “creamos nuevo…” en el mismo proceso lo que significa que se dio de alta un nuevo producto que talvez NO tenia existencias en tu consulta pasada pero que ahora ya tiene y por eso lo ves activando ahora.

Tambien en otros procesos hemos agregado marcas que te indican cuando un producto fue actualizado como el la imagen a continuacion:

CONSULTA DINAMICA DE ARTICULOS POR MARCA-GRUPO:

Para hacer más rápida y agil la consulta de ARTICULOS-CVA hemos creado la opcion de poder SEGMENTAR POR GRUPO-MARCA ,lo que te permite encontrar POR REGION DE ALMACEN como lo marca el proveedor asi:

NUEVOS CAMPOS EN TU ZONA PRODUCTO-EDICION-INVENTARIO:

Nuestro desarrollo te AGREGA NUEVOS DATOS interesantes que te van a permitir tomar las mejores decisiones en cada proceso de alta y actualización

Estos datos se INTEGRAN DESPUES DE REALIZAR TU PRIMERA ACTUALIZACION (no en el alta por primera vez), por lo que solo ajecutar el mismo proceso de Alta-Actualiazcion para contar siempre con éstos datos del dia.

promociones por ARTICULO

Syscom por ahora no integra una forma de agregar las promociones, pero en cuanto sea posible dicho evento será agregado a la API WOO MOJOMEXICO y te  sera actualizado a tu version ya que todo el año estamos haciendo actualizaciones y mejoras al PLUGIN con el mejor proposito de que sea mas eficiente y util para nuestros clientes.

Pero un ejemplo  en donde si se pueden agregar las promociones es en CVA API,  el resultado va a mostrar en la tienda asi:

 

Despues de Procesar los primeros productos, vas a notar en el catalogo woo-productos:

Cuando haz actualizado articulos CVA SIN EXISTENCIAS, en automático WooCommerce te indica en ROJO “sin existencias” (detalle del producto) y si en tu Configuracion Global de la tiendaWC haz indicaro que NO se muestren productos SIN existencias, entonces en tu zona FRONT(lo que tus clientes pueden ver) no se van a presentar estos productos a menos que tu decidas lo contrario..depende de ti.

como podrás notar ya puedes ahorrar cientos de horas en este proceso y con nuestro conector lo haces en minutos. Esto es uno de muchos beneficios de nuestro conector y que ahora puedes adquirir a precio de promocion directo en nuestra tienda web , solo sigue los botones que te llevan a nuestra tienda.

Ayuda en Linea y por Ticket 24horas todo el año

Siempre cuentas con el Apoyo,por los Botones de Ayuda que hemos creado y por nuestro moderno sistema de TICKET MOJOMEXICO que funciona las 24 horas todo el año. Solo ubica los botones en tu mismo panel como se muestra aqui

Causas de Posibles fallas, errores de configuracion y soluciones:

Posibles errores que hemos detectado al intentar usar el conector, aqui la lista:

Error al Intentar ABRIR Consulta y Actualizacion como en la Imagen:

Causa: ERROR DEL SERVICIO PHP Y HOSTING por falta y Bloqueo del recurso LIBXML, este es un servicio PHP que debe estar activo y SIN bloqueo de ejecución, tambien debes revisar en tu Configuracion PHP Hosting que NO tengas bloque en URL-EXTERNAS , o solo marcalas como “url permitida …” todas las relacionadas con Mojomexico y APIExelnorte.

Error en “URL Producto..”, EJECUTA PERO NO GRABA (NI CREA NUEVOS NI ACTUALIZA EXISTENCIAS):

este error depende directamente de tu configuración WOOCOMMERCE y podrás corregir siguiendo las indicaciones de Soluciones Woocommerce.

DEBES VERIFICAR que tu CONFIGURACION SEA CORRECTA lo mas proximo al las pantallas que aqui te presentamos , porque de ésto depende el correcto funcionamiento del servicio MOJOAPI-HTTCLIENT, aqui te muestro los 2 ejemplos (parte superior y parte inferior de la misma seccion).

FATAL ERROR HTTPCLIENT: ste es el error que se puede Presentar y como a aqui ya expuse, la solución son los ajustes a PERMALINK (enlaces permanentes) de tu sistema WordPress.

Error por Falta de Certificado SSL en el Dominio o Certificado Invalido o requieres instalar el Plugin SSL para WordPress que te ofrece gratis los plugins WP.

Una causa comun de error al intentar usar por primera vez nuestro conector puede ser por BLOQUEO DEL SERVICIO REST-API WP – WOOCOMMERCE que puede ser provocado por algun PLUGIN WP instalado como Firewall, Cache, Sentinel etc , bloqueo en tu Configuracion Htaccess Local etc.

Los errores que tenemos identificados y pueden presentarse son:“—No podemos listar los recursos restapi—- HttpClient–“) o este otro “CRITICAL Uncaught Error: Call to a member function get….() function…”, ó “… tu Certificado SSL no es valido o el dominio no tiene un certificado instalado…”

en estos casos, ALGUN PLUGIN QUE ESTA BLOQUEANDO el uso de RESTAPI; tambien hemos recibido reportes que la falla puede ser tu Plantilla y sus Acciones especiales; en todo caso te recomendamos hacer pruebas DESHABILITANDO TODOS los plugins que consideres que pueden estar afectando y hacer pruebas hasta que puedas resolver. Recuerda BORRAR EL CACHE en cada prueba para que las acciones de correccion sean reales.

En la mayoria de los casos estas fallas las provoca tu SERVICIO WEB HOSTING actual y aqui te anexamos el LINK de la DUCUMENTACION WOOCOMMERCE que menciona las causas y posibles soluciones:

ahi se describe algunas soluciones posibles a este error : Los servicios WEBServiceAPI hoy en día son mas comunes de lo que te imaginas porque hasta cuando usas UNA APP MOBIL (para Apple o Android) muchas de éstas requieren aprovechar ésta tecnologia asi como las Tiendas web Profesionales Magento y otras marcas; pero muchas veces Los Proveedores Hosting NO LO SABEN O LO TIENEN BLOQUEADO para sus propios fines comerciales; en cualquiera de los casos, si no encuentras la solucion en tu proveedor actual, nosotros te recomendamos que cambies a un de nuestros Planes HOSTING VPS Profesional Mojomexico especializado en Tiendas Web Profesionales, como en ESTA DEMO, que ahora esta funcionando para mayor muestra no crees?.

Tambien es importante que verifiques y tengas la seguridad de que tu plan hosting actual contenga estos requisitos tecnicos minimos en correcto funcionamiento:

1.- Es preferible usar Apache2 con PHP 7.3.x (recuerda que magento, prestashop y woocommerce fueron diseñados para funcionar en Apache2) , por lo que si usas apache2 con php7.3.x seguro tu conexion va a funcionar sin problema.

2.- Acceso SSH Composer (a nivel consola)- Mediante COMPOSER es probable que se resuelvan muchas acciones de BLOQUEO RESTAPI WC esto porque las ultimas versiones Woocommerce4 han sido diseñadas para el consumo de Composer como medio integral para esta version las futuras-

3.- Debes tener libertad de activar VARNISH en tu tienda para que los procesos de carga y actualizacion de catalogo no se interrupan o se rompan.

4.- Debes tener libertad de modificar Htaccess de tu zona de WP-WC

5.- 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 que No son errores del programa:

en esta ACTUALIZACION POR GRUPOS se muestran los resultados de los NUEVOS ARTICULOS (NUEVOS SKU) creados en WC-Productos y el GRAN TOTAL de articulos consultados (del GRUPO DISCOS DUROS) . Solo se activaron aqui en este ejemplo los que SI TIENEN INVENTARIO (mas de 1 producto).

POR OTRO LADO ALGUNAS FALLAS NO INDENTIFICADAS AUN:

En muchas pruebas que he hecho he podido detectar algunos eventos de alta, actualizacion normal o en promoción con ciertos DETALLES que pueden dejarte “sin aparente resultado… por lo que podrias pensar” que es una falla del programa; la realidad es que puede ser falla provocada por CVA-Conexion , por Configuracion de PHP (por ejemplo en alta o actualizaciones por grupos son tantos que se ha presentado “max_memory_limit..” o algun otro similar, ésto se resuelve configurango PHP del servicio de tu hosting; tambien cuando haces una “actualizacion de memoria-grupo… pero en CVA está como MEMORIAS (en plural), por lo que consultar memoria (en singular) simplemente no presenta ningun resultado– por eso te recomiendo que Descargues el Catalogo-Excel de CVA y ahi podrás confirmar en la columna GRUPOS la demonimación exácta para asi trabajar sin problema.

También hago notar que he detectado este error que depende de WP y aun no detecto la causa del error: esto es en “Alta por Grupos …” el primer campo “LISTA DE CATEGORIAS WC… ” en donde deben presentarse TODAS las categorias con su ID, pero no es asi y solo se presetan las primeras 10 o menos que fueron dadas de alta… repito, es un caso que estoy revisando esperando resolver a conrto plazo.

forma de reportar cualquier falla al epto 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-

EL FUTURO ES USAR WOOCOOMERCE NETWORK y nosotros lo dominamos ahora te digo porqué:

En Mojomexico dominamos el uso de WP-Woocommerce Network y te lo instalamos en ésta solución y en otros conectores que hemos desarrollado por lo que POTENCIAMOS MAS tu producto. Nosotros siempre buscamos el máximo rendimiento de las tiendas WC o de otras marcas porque solo así podrá tu Negocio-Tienda ser Punta Lider sobre tu competencia.

En estos conectores DE MAYORISTAS con nuestra tecnologia NETWORK vas a poder tener CVA y PCH y –delNorte— y TODOS los CATALOGOS concentrados en un sólo WC, pero en el interior cada uno separado para su fácil administración—

Nuestros conectores NO solo se limitan a las acciones básicas sino que en tu compra y durante 6 meses posteriores estamos agregando GRATIS TODAS LAS ACTUALIZACIONES Y MEJORAS que vamos a ir sacando al ir mejorando el uso y operación de éstos conectores.

Por ejemplo en un futuro queremos incluir que desde WC puedas GENERAR TU PEDIDO EN AUTOMATICO con tu PROVEEDOR… cómo?

vamos a incluir que mediante un boton y de acuerdo a la compra (de tu cliente) en automático actives el Pedido-Distribución con tu Proveedor Mayorista, todo esto en Linea, con el minimo error y esfuerzo humano…

… tienes alguna sugerencia de mejora? algo especial que te gustaria incluir?… puedes pedirlo, porque nosotros SI dominamos el codigo y podemos crear lo que nos pidas.