Asociar los registros con los de tu sistema

Esta guía es para quien programa la integración. Sirve cuando tu sistema (por ejemplo, el de recursos humanos) tiene sus propios identificadores y necesita saber a qué registro de Safety Panel corresponde cada uno. Antes, emití una key para ese sistema, con Lectura y escritura en los recursos que va a asociar.

1. Guardá tu identificador en el registro

Encontrá el registro en Safety Panel, por ejemplo con el listado de profesionales, y guardale tu identificador en external_reference:

curl -X PATCH "https://tuempresa.safetypanel.com.ar/api/v1/professionals/45" \
  -H "Authorization: Bearer spk_…" \
  -H "Content-Type: application/json" \
  -d '{"external_reference": "E-123"}'

Cada registro tiene una sola referencia externa. Si la cuenta conecta más de un sistema, acuerden cuál la usa; los demás pueden guardar su identificador en los metadatos, con una clave propia (por ejemplo, lms_id).

2. Buscá por tu identificador

A partir de ahí, encontrá el registro con el filtro external_reference:

curl "https://tuempresa.safetypanel.com.ar/api/v1/professionals?external_reference=E-123" \
  -H "Authorization: Bearer spk_…"

La respuesta es un listado, y puede traer más de un registro: Safety Panel no exige que la referencia sea única. Si tu sistema espera uno solo y llegan varios, revisá los datos antes de seguir.

La búsqueda incluye los registros dados de baja. Si alguien vuelve a la cuenta, por ejemplo una persona que se reincorpora, encontrás su registro anterior y corresponde restaurarlo, en lugar de crear uno nuevo. Así conserva todo su historial.

3. Guardá tus propios datos, si los necesitás

En external_metadata podés guardar pares clave–valor de tu sistema. Cada PATCH cambia solo las claves que envíes:

curl -X PATCH "https://tuempresa.safetypanel.com.ar/api/v1/professionals/45" \
  -H "Authorization: Bearer spk_…" \
  -H "Content-Type: application/json" \
  -d '{"external_metadata": {"cost_center": "4410", "region": ""}}'

En este ejemplo, cost_center queda en "4410" y region se borra. Ver los límites y las reglas en Campos externos.

No guardes datos sensibles en los metadatos

Los metadatos no se cifran y los lee cualquier key de la cuenta con permiso sobre ese recurso.