Contacto

Requisitos Integraciones

A. Requerimientos técnicos para integración con ERP y otros sistemas productivos: 

 

  1. Descripción General

La plataforma RTIAP, alojada en AWS, permite la integración con servicios externos para la consulta y almacenamiento de información basada en números de folio. A continuación, se describen las especificaciones que el cliente deberá cumplir para una integración exitosa con RTIAP.

 

  1. Requisitos del Servicio Externo del Cliente

El cliente deberá proveer un servicio web accesible públicamente en internet, que permita realizar consultas por número de folio y responda con un conjunto de propiedades o campos asociados a ese folio.

 

2.1. Endpoint del Servicio

  • El endpoint deberá estar protegido mediante un método de autenticación (por ejemplo, token o API Key) para asegurar el acceso.
  • La URL y los parámetros de autenticación deberán ser provistos a nuestro equipo.

2.2. Formato de la Respuesta

  • La respuesta debe ser en formato JSON.
  • Cada respuesta deberá contener un conjunto de campos con sus valores correspondientes, que representen la información asociada al número de folio consultado.

 

Ejemplo de estructura JSON esperada:

{

  «folio»: «123456789»,

  «fechaEmision»: «2024-11-14»,

  «especie»: “cerezas”,

  «variedad»: «bloom»,

  «lote»: 345

  «cajas»: 92

  “calibre”: “medio”

  “exportadora”: “Exportadora ACME”

  “embalaje”: “BK2344”

}

 

  1. Campos a Almacenar en RTIAP

El cliente deberá especificar claramente cuáles de los campos de la respuesta deben almacenarse en la plataforma RTIAP. Estos campos se identificarán y mapearán en RTIAP para su almacenamiento y uso posterior.

 

  1. Pruebas y Validación

Antes de pasar a producción, se deberá realizar un proceso de pruebas en un entorno de desarrollo para asegurar la correcta integración y que la respuesta del servicio cumpla con las especificaciones acordadas.

 

  1. Contacto Técnico

Para cualquier duda técnica, el equipo de RTIAP estará disponible para coordinar los detalles de la integración y resolver cualquier inconveniente.

B. Requerimientos técnicos para integración con sistema termometría existente:

Para la integración de la plataforma RTIAP con el SCADA o Sistema de Atmósfera Controlada existente el cliente deberá solicitar al proveedor, la habilitación de la conexión vía web services para extraer los datos, así como la tabla de direcciones para obtener la información de los sensores de temperatura y variables de control que se requiera monitorear.

 

IMPORTANTE

  1. Respecto de los costos:

  • Ciertas integraciones podrían tener -o no- un costo asociado por parte del proveedor de origen (Main, Isolcell, Softwares Productivos, etc.), lo que dependerá exclusivamente de la relación sostenida con el cliente y los respectivos acuerdos comerciales pactados.

  • Será responsabilidad del cliente asumir dicho costo.

  • Será responsabilidad del cliente también realizar todas las gestiones que le sean posible para una alcanzar una correcta coordinación y entrega de datos por parte del proveedor, de acuerdo con los requerimientos técnicos solicitados por RTIAP.

 

  1. Respecto del funcionamiento:

  • RTIAP no será responsable de fallas en la infraestructura o software de terceros a los que RTIAP se integró (sensores disponibles del cliente, sistemas de termometría, SCADAs, softwares productivos y similares).

  • La correcta recopilación y visualización de datos por parte de RTIAP queda supeditado al buen funcionamiento de dicha infraestructura y sistema.

  • El Cliente declara que conoce y acepta las condiciones de la infraestructura presente o remanente en sus instalaciones, sean estas propias o de proveedores anteriores, por lo que está al tanto que la correcta recopilación y visualización de datos por parte de la Plataforma Cloud RTIAP queda supeditado al buen funcionamiento de dichas infraestructuras, sistemas y software.

3. Especificación de Integración entre RTIAP Cloud y Equipos de Terceros mediante Modbus TCP

  1. Introducción

Este documento describe los lineamientos técnicos necesarios para integrar equipos de terceros (PLC, SCADA, controladores, HMI, sensores inteligentes, etc.) con el ecosistema RTIAP, utilizando el protocolo Modbus TCP como medio de comunicación.

La integración está diseñada para que el RTIAP Server Local realice consultas periódicas hacia los dispositivos para obtener datos de proceso y posteriormente enviarlos a RTIAP Cloud para su almacenamiento, visualización y análisis.

  1. Arquitectura General de Integración

La arquitectura propuesta consta de los siguientes elementos:

  1. Dispositivo de Terceros (PLC/SCADA/HMI/Controlador)

○ Expone variables a través del protocolo Modbus TCP.

○ Posee una dirección IP accesible en la red local.

  1. RTIAP Server Local

○ Cliente Modbus TCP.

○ Realiza consultas cíclicas a los dispositivos.

○ Procesa, escala y transforma los valores.

○ Envía los datos hacia RTIAP Cloud.

  1. RTIAP Cloud

○ Plataforma donde se almacenan, visualizan y analizan los datos.

○ Permite generar reportes, alarmas y dashboards.

  1. Requisitos para la Integración

Para integrar cualquier equipo mediante Modbus TCP, deben proporcionarse los siguientes datos:

3.1 Información de Conectividad

  • Dirección IP del dispositivo.

  • Puerto Modbus TCP (por defecto 502).

  • ID o dirección del esclavo (unit ID), si aplica.

3.2 Mapa de Memoria / Variables Modbus

Para cada variable a consultar, se debe proporcionar:

  • Tipo de registro Modbus:

○ Holding Register (4xxxx)

○ Input Register (3xxxx)

○ Coil (0xxxx)

○ Discrete Input (1xxxx)

  • Dirección del registro (offset real del equipo).

  • Tipo de dato:

○ Entero 16 bits (signed/unsigned)

○ Entero 32 bits (big endian / little endian / swapped)

○ Float 32 bits (IEEE 754)

○ Booleano

○ Otros formatos según disponibilidad.

  • Frecuencia de lectura deseada (ej: 1s, 2s, 5s, 10s, etc.).

3.3 Parámetros de Escalamiento y Unidades

Si la variable requiere ajuste o conversión:

  • Factor de escala.

  • Offset.

  • Unidad de medida (°C, bar, %, m3/h, etc.).

  • Rango válido esperado.

  1. Funcionamiento del RTIAP Server Local

El RTIAP Server Local cumple las siguientes funciones:

  1. Consulta periódica Modbus

○ Accede a los registros definidos en el mapa de memoria.

○ Ejecuta ciclos de lectura con la frecuencia establecida.

  1. Procesamiento de datos

○ Aplica escalamiento y conversión de unidades.

○ Verifica rangos válidos.

○ Aplica reglas de conversión para tipos de dato complejos.

  1. Publicación en RTIAP Cloud

○ Envía los datos mediante el protocolo seguro configurado.

○ Permite la disponibilidad inmediata para dashboards, alarmas y reportes.

  1. Consideraciones Adicionales

5.1 Compatibilidad

RTIAP es compatible con cualquier dispositivo que implemente Modbus TCP estándar, siempre que el proveedor entregue el mapa de memoria y especificaciones necesarias.

5.2 Seguridad y Red

 

  • El RTIAP Server Local debe tener acceso directo a los equipos.

  • Se recomienda segmentar la red industrial mediante VLAN o firewalls.

5.3 Pruebas de Validación

Previo a la puesta en marcha:

  • Verificar comunicación con herramientas como Modbus Poll o equivalentes.

  • Validar la coherencia de los registros.

  • Confirmar escalas y unidades proporcionadas por el fabricante.

  1. Información Necesaria por Parte del Cliente

Para completar la integración se debe entregar:

  1. Mapa de memoria completo del dispositivo.

  1. Descripción de cada variable.

  1. Tipo de dato y formato.

  1. Escalas y unidades.

  1. Frecuencia de lectura requerida.

  1. Información de red (IP, puerto, unit ID).

  1. Ejemplo de Registro Modbus

  1. Conclusión

Este documento establece los requisitos y lineamientos para integrar equipos de terceros mediante Modbus TCP con RTIAP Cloud. Al contar con la información completa del mapa de memoria y las características de los dispositivos, RTIAP puede garantizar una integración confiable, escalable y eficiente.