Manual de Comunicación para el Sistema Agricultor de Owari SAS

Conexión del Servidor

Para conectar el servidor se requiere la URL del módulo a conectarse más el token de seguridad, la cual es diferente para cada usuario. A continuación, un ejemplo de conexión:

https://tu-módulo.owari.cloud/core/PANEL/API/api.php?TOKEN=Ypa-7Pl-Nd-F&MODULO=TIPOS_DE_ACTIVIDADES

Encontrarás las credenciales en el apartado del menú:

  • Menú > Herramientas > Api key

Respuesta del Servidor

El servidor enviará una respuesta JSON que puedes validar utilizando la variable ESTADO. A continuación, se describen las posibles respuestas:

Ejemplos de Respuesta

    {
        "ESTADO": false,
        "ERROR": "Tu conexión falló."
    }
                                    

Explicación: El token enviado no existe. Además, si el fallo ocurre más de 2 veces, la IP será bloqueada.

    {
        "ESTADO": false,
        "ERROR": "Tu conexión falló demasiadas veces."
    }
                                    

Explicación: La IP fue bloqueada debido a múltiples intentos fallidos. Deberás desbloquearla para intentar de nuevo.

    {
        "ESTADO": false,
        "ERROR": "No se encontró ningún módulo, tienes que escoger a qué módulo conectaras."
    }
                                    

Explicación: No se envió la variable MODULO, que selecciona el módulo a conectar.


    {
        "ESTADO": true,
        "ERROR": "",
        "DATA": {
            "titulos": {
                "t0": "Código",
                "t1": "Cultivo",
                "t2": "Lote",
                "t3": "Empleado",
                "t4": "Kg",
                "t5": "Fecha"
            },
            "datos": [
                {
                    "Código": "PESO-6",
                    "Cultivo": "CAFÉ",
                    "Lote": "02",
                    "Empleado": "SIMON QUINTERO",
                    "Kg": "630",
                    "Fecha": "2024-11-12"
                }
            ]
        }
    }
                                    

Explicación: El estado es true, indicando una conexión exitosa, y los datos se encuentran en la variable DATA.

Módulos para Consultar con sus Variables

KG

Consulta la lista de los kg almacenados en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

COMPRAS_Y_GASTOS

Consulta la lista de las compras y gastos en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

COMPRAS_Y_GASTOS_FUL

Consulta la lista de las compras y gastos almacenados con mayor cantidad de datos en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

ANTICIPOS_CRUZADOS

Consulta la lista de los anticipos cruzados almacenados en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

EXCEDENTES_CRUZADOS

Consulta la lista de los excedentes cruzados almacenados en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

CUENTAS_PAGADAS

Consulta la lista de las cuentas pagadas almacenadas en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

CUENTAS_PAGADAS_FUL

Consulta la lista de las cuentas pagadas almacenadas en el sistema con mayor cantidad de datos.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

CUENTAS_PAGADAS_FUL_AGRUPADO

Consulta la lista de las cuentas pagadas almacenadas en el sistema con mayor cantidad de datos y agrupados.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

VENTAS

Consulta la lista de las ventas almacenadas en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

GASTOS

Consulta la lista de los gastos almacenados en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

CUENTAS_POR_PAGAR

Consulta la lista de las cuentas por pagar almacenadas en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

EXCEDENTES

Esta variable consultará la lista de los anticipos que no pudieron ser cobrados y quedaron como excedentes para un próximo descuento para el empleado que están almacenadas en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

CONTRATOS

Esta variable consultará la lista de los contratos almacenados en el sistema.

Filtros disponibles:

  • IN y FI (2024-11-12 y 2024-12-12)
  • B (filtro de texto)

LOTES

Esta variable consultará la lista de los lotes almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

EMPLEADOS

Esta variable consultará la lista de los empleados almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

CLIENTES

Esta variable consultará la lista de los clientes almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

CULTIVOS

Esta variable consultará la lista de los cultivos almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

TIPOS_DE_INSUMOS

Esta variable consultará la lista de los tipos de insumos almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

TIPOS_DE_GASTOS

Esta variable consultará la lista de los tipos de gastos almacenados en el sistema.

Filtros disponibles:

  • B (filtro de texto)

TIPOS_DE_ACTIVIDADES

Esta variable consultará la lista de los tipos de actividades almacenadas en el sistema.

Filtros disponibles:

  • B (filtro de texto)