API e integraciones: conectá balanzas, gateways y tu sistema

La sección de API e integraciones permite que otros programas (una balanza, un gateway, un sistema contable, una planilla o el sistema propio de tu empresa) lean o carguen datos de tu cabaña de forma controlada, sin que compartas tu usuario y contraseña. Es opcional: si no usás otros programas, no la necesitás.

Es un tema para el Propietario o el Administrador. Abrí el menú de tu cuenta y tocá API e integraciones (ícono ⌘). Se abre una ventana con cinco pestañas: Resumen, Claves API, Webhooks, Actividad y Documentación.

Dos ideas simples

• Una clave de API es como una llave que le das a otro programa. Cada llave tiene un nombre, permisos a tu medida (solo consultar, o también cargar) y se puede renovar o anular sin afectar a las demás.
• Un webhook es un aviso automático: en vez de que el otro programa consulte cada tanto, ProCampo.ar le avisa cuando pasa algo (por ejemplo, se carga un pesaje).

Qué podés lograr

• Conectar una balanza o un gateway para que los pesajes lleguen solos a la ficha de cada animal (ver también balanzas y bastones).
• Alimentar tu sistema contable o de gestión con los datos de ejemplares, pesajes y tareas.
• Compartir información con un asesor de forma controlada, dándole solo los permisos que necesita.

Crear una clave

1. Entrá a Claves API y completá Nombre (por ejemplo "Balanza del galpón" o "Sistema del asesor").
2. Fijá el Límite por minuto y, si querés, un Vencimiento opcional.
3. Tildá los Permisos: Consultar ejemplares, Crear ejemplares, Consultar pesajes, Registrar pesajes, Consultar tareas y Crear tareas. Dale a cada programa solo lo que necesita.
4. Tocá Crear clave. Copiala y guardala en el programa que la va a usar; al terminar tocá Ya la guardé.

Después podés Rotar (genera una clave nueva) o Revocar (la anula definitivamente). La lista muestra cada clave con sus permisos y su último uso.

Tip. Creá una clave distinta por cada programa. Si un día dejás de usar uno, revocás solo su clave y el resto sigue funcionando.

Configurar un webhook

1. En Webhooks completá Nombre, URL HTTPS (la dirección del programa que va a recibir los avisos) y una Descripción.
2. Elegí los Eventos de los que querés que te avise (ejemplares, pesajes y tareas, y también mantenimiento, personal, bienestar, genética, eventos ganaderos y documentos).
3. Tocá Crear webhook y configurá el otro programa con los datos que se muestran.

Cada webhook tiene Probar, Desactivar/Activar y Eliminar. En Actividad ves cada entrega con su estado (Pendiente, Reintentando, Entregado, Falló), podés tocar Reintentar y consultar la actividad de tus conexiones.

Documentación para quien programa

La pestaña Documentación reúne la información técnica y un ejemplo para quien realiza la integración. Si trabajás con un programador o un proveedor de balanzas, entregale esa pestaña. Las consultas vienen paginadas y las altas admiten un código para evitar duplicados si se repite un envío.

Canales de trazabilidad (Estrategia)

En el menú Estrategia, pestaña Integraciones, podés configurar canales para intercambiar eventos de trazabilidad con otras plataformas: API JSON ProCampo.ar, Webhook saliente, GS1 EPCIS 2.0, SENASA e Intercambio CSV. Desde ahí podés Preparar exportación, Descargar CSV, Probar configuración e Importar eventos en formato JSON, con Vista previa antes de confirmar. Todo queda registrado en Trabajos recientes.

Importante. Las integraciones ayudan a organizar y compartir información, pero no reemplazan los trámites oficiales (SNIG, RENSPA, guías): esos requisitos se cumplen por su canal.

Tip. Tratá las claves como una contraseña: guardalas solo en el programa que las usa y, si dudás de alguna, renovala o revocala desde esta misma pantalla.

Quién puede hacerlo

Para revisar qué incluye tu plan, mirá planes y alcance.