Errores Comunes

Los siguientes son los errores más comunes que los clientes pueden encontrarse al interactuar con la API de Mekano:

El Cliente No Tiene Una IP Fija

Algunos clientes pueden saltarse el requerimiento de la IP fija y proveer a Mekano con una IP dinámica. Ésta puede funcionar adecuadamente por un tiempo, pero dejará de hacerlo eventualmente, cuando su dirección cambie y la API de Mekano ya no pueda encontrar el servidor correcto.

El cliente debe comunicarse con su proveedor de internet y pedir una dirección IP fija, preferiblemente versión 4.

El Cliente Tiene Una IP Fija Versión 6

Aunque Mekano soporta direcciones IP versión 6, este soporte aún no es estable, por lo que puede provocar fallos inesperados. Se espera poder estabilizar el soporte de la versión 6 en el futuro. Por el momento, es mejor utilizar direcciones versión 4 siempre que sea posible.

El Cliente No Tiene Abierto El Puerto 3050

Esto ocurre cuando el cliente no ha abierto el puerto 3050 de su red al internet público. Aunque esto pueda incurrir en riesgos, es necesario para el funcionamiento de la API de Mekano, debido a que esta tiene que comunicarse directamente con la base de datos del cliente para consultar y/o manipular sus datos.

Se recomienda al cliente buscar la asesoría de un técnico para configurar su red de la forma más segura posible.

El Cliente No Tiene Encendido El Computador Del Servidor

Para el funcionamiento de la API de Mekano, el sistema en el que corre la base de datos de Mekano debe estar encendido y conectado a la red. Es a este equipo al que se debe dirigir el tráfico entrante hacia el puerto 3050.

Se Confundió El Endpoint De La API

Una sutileza clave de la API de Mekano es la diferencia entre los endpoints para consultar datos y los endpoints para insertar o modificar datos.

El endpoint para consultar datos se ve de esta forma:

http://144.202.47.24/{Intancia_Cliente}/RestServerIsapi.dll/api/v1/TApoloRestInterface/executequery

Nótese que su segmento final es executequery.

En cambio, el endpoint para insertar o modificar datos se ve de esta otra forma:

http://144.202.47.24/{instancia_cliente}/RestServerIsapi.dll/api/v1/TApoloRestInterface/execute

Con su segmento final siendo execute.

Se Ingresó La Clave De Operación Errónea

Todas las APIs de Mekano comparten los mismos dos endpoints. Para diferencias entre cada operación, el cuerpo de la petición debe llevar un campo llamado CLAVE que debe contener el nombre asignado a la operación que se busca. Por ejemplo:

{
  "CLAVE": "Get_Terceros",
  "CODIGO": "810000494"
}

Este cuerpo le dirá a la API de Mekano que desea realizar la operación Get_Terceros.

El nombre de cada operación puede consultarse en cada entrada de la Documentación de APIs para clientes.

No Se Extrajeron Los Datos Adecuadamente

En las operaciones para consultar datos, éstos vienen dentro de un campo llamado data en el cuero de la respuesta. Por ejemplo:

{
  "cod_error": 0,
  "data": [
    {
      "CODIGO": "810000494",
      "NATURALEZA": "J",
      "CODIGO2": null,
      ...
    }
  ]
}

Se debe prestar mucha atención a los ejemplos de la documentación para extraer los datos correctamente.