{"info":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","description":"\n\n

API REST de solo lectura para conectar RedSmartRH con su nómina o HRIS.

\n\"Elija%20por%20la%20pregunta%20que%20quiere%20contestar.%20Las%20tres%20usan%20la%20misma%20API%20key\"\n\n

Un solo host

\n

Todos los requests usan la variable apiHost, que vale https://api.red-smart.com.
Si ve otro host en algún request, es un error: repórtelo.

\n

Autenticación

\n

Header X-Api-Key: rsk_…. La genera el administrador del tenant en Integraciones → Conectores & API. No hay OAuth ni token que refrescar: la key va en cada llamada.

\n

La key identifica al tenant: cada una sólo ve los datos de su empresa. No hay parámetro de empresa en ningún endpoint — si lo hubiera, sería un agujero.

\n

Convenciones

\n\n

Límites

\n

Rate limit por key. checadas acepta máximo 92 días por llamada; movimientos, 366.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1395806","collectionId":"7d41d735-1307-4036-beae-f75a4000e7ef","publishedId":"2sBY4Tpxpz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00B87A"},"publishDate":"2026-08-01T21:34:35.000Z"},"item":[{"name":"Personal","item":[{"name":"Roster (plantilla con estatus laboral)","id":"a7e5ec79-9d4b-4ad7-892d-ae35bd0c0782","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/roster","description":"

La plantilla completa con su estatus laboral.

\n

⚠️ estatus y activo contestan preguntas distintas y sí divergen.

\n\n

Campos de baja: fechaBaja, motivoBaja, motivoBajaClave, fundamentoBaja y tipoBaja (1 voluntaria · 2 involuntaria · 3 neutra) — es lo que separa finiquito de liquidación.

\n

Campos de suspensión: suspendido, suspensionDesde, suspensionHasta (null = abierta, todavía no se reanuda) y suspensionAfectaPago, ya resuelto: la suspensión con goce no suspende el pago.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","roster"],"host":["https://api.red-smart.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a7e5ec79-9d4b-4ad7-892d-ae35bd0c0782"},{"name":"Movimientos del periodo","id":"49be8c1d-82b1-44f5-8b2a-0fb812ffc944","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/movimientos?desde=2026-07-01&hasta=2026-07-31&soloNomina=false","description":"

Altas, bajas, suspensiones, reanudaciones y cambios del periodo. Es el insumo del aviso de baja al IMSS.

\n

Por qué existe además del resumen de asistencia: alguien que trabajó del 1 al 15 y se fue el 15 aparece con 11 días, idéntico a quien faltó el resto del mes. Y hay que hacer cosas muy distintas con cada uno.

\n

Cada fila trae el motivo tipificado con su fundamento en la LFT y afectaPago ya resuelto — no lo derive con una fórmula.

\n

⚠️ Se filtra por fechaEfectiva, no por cuándo se capturó: una baja registrada tarde sigue siendo del periodo en que ocurrió.

\n

Máximo 366 días. Sin fechas, devuelve todo el histórico.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","movimientos"],"host":["https://api.red-smart.com"],"query":[{"key":"desde","value":"2026-07-01"},{"key":"hasta","value":"2026-07-31"},{"description":{"content":"

true = sólo los que su nómina tiene que procesar (deja fuera cambios administrativos como el de domicilio).

\n","type":"text/plain"},"key":"soloNomina","value":"false"}],"variable":[]}},"response":[],"_postman_id":"49be8c1d-82b1-44f5-8b2a-0fb812ffc944"}],"id":"200aaf50-640e-4db5-9952-f53621ad15d1","description":"

Quién trabaja en la empresa y qué le pasó. Es lo que su nómina necesita para pagar y para dar avisos al IMSS.

\n\"estatus%20=%20¿sigue%20contratado?%20·%20activo%20=%20¿puede%20entrar%20al%20sistema?%20No%20son%20lo%20mismo.\"","_postman_id":"200aaf50-640e-4db5-9952-f53621ad15d1","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}}},{"name":"Asistencia","item":[{"name":"Checadas (bitácora de marcas)","id":"4e21b9d5-3e8a-4482-90fd-252a27a399ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/checadas?desde=2026-07-01&hasta=2026-07-31","description":"

Cada marca registrada, cruda, para auditoría. Máximo 92 días por llamada.

\n

banderas es un mapa de bits: la checada quedó registrada y la bandera sólo señala qué revisar. Los dos que más importan:

\n\n

Una checada con 2048 significa que a esa persona nadie le asignó turno, así que no genera jornada y no va a aparecer en el resumen de nómina.

\n

tsEfectiva viene tal cual la registró el reloj, en hora local del centro.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","checadas"],"host":["https://api.red-smart.com"],"query":[{"key":"desde","value":"2026-07-01"},{"key":"hasta","value":"2026-07-31"},{"disabled":true,"description":{"content":"

Opcional: filtra a un centro de trabajo.

\n","type":"text/plain"},"key":"idCentro","value":""}],"variable":[]}},"response":[],"_postman_id":"4e21b9d5-3e8a-4482-90fd-252a27a399ed"}],"id":"8fb67436-da2f-438b-85bb-1906d07281d5","description":"

Las marcas del reloj checador, crudas. Para auditoría y para conciliar contra su sistema de asistencia — el resumen que su nómina consume vive en Movimientos.

\n","_postman_id":"8fb67436-da2f-438b-85bb-1906d07281d5","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}}},{"name":"Cumplimiento","item":[{"name":"Capacitación (cobertura y DC-3)","id":"26d3a457-6f5e-4ddd-9fc4-b05c53635326","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/capacitacion","description":"

Avance por curso y el detalle colaborador × curso. Sostiene la constancia DC-3 (LFT Art. 153).

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","capacitacion"],"host":["https://api.red-smart.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"26d3a457-6f5e-4ddd-9fc4-b05c53635326"},{"name":"Acuses (comunicados, RIT y privacidad)","id":"0bdfab4b-3970-4373-8cae-44e9014f2a47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/acuses","description":"

Quién aceptó qué y cuándo: comunicados oficiales, Reglamento Interior de Trabajo (LFT Art. 422) y aviso de privacidad (LFPDPPP).

\n

Es la evidencia de que el documento se puso a disposición, que es lo que se pide en una inspección.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","acuses"],"host":["https://api.red-smart.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0bdfab4b-3970-4373-8cae-44e9014f2a47"},{"name":"Descansos (Ley Silla)","id":"4e3accf4-8cd9-4581-9183-d87550b4a871","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/descansos","description":"

Políticas vigentes y pausas por centro (LFT Art. 132-V). Sin fechas devuelve sólo las políticas.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","descansos"],"host":["https://api.red-smart.com"],"query":[{"disabled":true,"key":"desde","value":"2026-07-01"},{"disabled":true,"key":"hasta","value":"2026-07-31"}],"variable":[]}},"response":[],"_postman_id":"4e3accf4-8cd9-4581-9183-d87550b4a871"},{"name":"NOM-035 (clima laboral)","id":"25967d10-ea88-4dde-b1d0-d0ea5514a781","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.red-smart.com/api/ext/nom035","description":"

Aplicaciones de la encuesta y, con idAplicacion, sus resultados.

\n

⚠️ Los resultados son AGREGADOS y con k-anonimato ≥ 5: nunca se devuelven respuestas por persona, ni siquiera con la key del tenant. La NOM-035 exige confidencialidad y por eso el límite es del servidor, no de la pantalla. Un grupo con menos de 5 respuestas no se reporta.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","nom035"],"host":["https://api.red-smart.com"],"query":[{"disabled":true,"description":{"content":"

Con este parámetro devuelve los resultados AGREGADOS de esa aplicación.

\n","type":"text/plain"},"key":"idAplicacion","value":""}],"variable":[]}},"response":[],"_postman_id":"25967d10-ea88-4dde-b1d0-d0ea5514a781"}],"id":"f535b641-8d79-4ff4-ab2c-388a9c4792e6","description":"

Lo que la STPS pide poder exhibir.

\n","_postman_id":"f535b641-8d79-4ff4-ab2c-388a9c4792e6","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}}},{"name":"Webhooks","item":[{"name":"Receptor de prueba (eco)","id":"a715fdd5-5785-4a1d-938a-b79b672b6b6c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-RedSmart-Event","value":"empleado.baja"},{"key":"X-RedSmart-Timestamp","value":"1785615812"},{"key":"X-RedSmart-Signature","value":"sha256=ejemplo"}],"body":{"mode":"raw","raw":"{\n \"idRegistro\": 99991131,\n \"idEmpleado\": \"1184\",\n \"fechaEfectiva\": \"2026-07-22T00:00:00\",\n \"fechaIngreso\": \"2024-08-01T00:00:00\",\n \"motivoClave\": \"renuncia\",\n \"motivoEtiqueta\": \"Renuncia voluntaria\",\n \"tipoBaja\": 1,\n \"fundamento\": \"LFT Art. 53-I\",\n \"afectaPago\": true\n}"},"url":"https://api.red-smart.com/api/ext/eco-webhook","description":"

Apunte aquí su webhook antes de escribir una línea de código.

\n

Responde 200 y le devuelve lo que llegó, incluido mensajeFirmado ya armado (timestamp + \".\" + cuerpo) — el mismo texto que usted tiene que firmar para comparar.

\n

Sirve para ver una entrega exitosa en la bitácora antes de tener receptor propio: apuntando a una URL inventada sólo vería reintentos fallidos, sin saber si el problema es suyo o nuestro.

\n

No requiere API key (un webhook manda firma, no key) y no guarda nada.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["api","ext","eco-webhook"],"host":["https://api.red-smart.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a715fdd5-5785-4a1d-938a-b79b672b6b6c"}],"id":"5dd6a794-8fc4-4f06-aaf1-dd937248ea98","description":"

El camino inverso: en vez de que usted consulte, RedSmart le avisa.

\n\"Se%20firma%20timestamp%20+%20"."%20+%20el%20cuerpo%20CRUDO.%20Firmar%20el%20JSON%20re-serializado%20es%20el%20error%20nº%201.\"\n\n

Eventos

\n

empleado.alta · empleado.baja · empleado.suspension · empleado.reanudacion · empleado.movimiento · checada.registrada · curso.completado · comunicado.acuse · rit.acuse

\n

Los de empleado.\\* viajan completos —nº de empleado, fecha efectiva, fecha de ingreso, motivo tipificado con fundamento y afectaPago— para que no tenga que llamarnos de vuelta.

\n

Lo que recibe

\n

Un POST con Content-Type: application/json. El cuerpo es el payload; no hay sobre, el tipo va en el header.

\n
X-RedSmart-Event:     empleado.baja\nX-RedSmart-Delivery:  1043            # úselo para deduplicar\nX-RedSmart-Timestamp: 1785615812      # segundos unix\nX-RedSmart-Signature: sha256=a1b2c3…\n\n

Verificar la firma — aquí es donde casi todos fallan

\n

Se firma timestamp + \".\" + el cuerpo CRUDO con HMAC-SHA256, en hexadecimal, usando el secreto que se mostró al crear el webhook.

\n

Firme los bytes que recibió: si deserializa el JSON y lo vuelve a serializar, los bytes cambian y la firma nunca coincidirá. Es el error nº 1.

\n
const mio = 'sha256=' + crypto.createHmac('sha256', SECRETO)\n      .update(ts + '.' + rawBody).digest('hex');\n\n
\n

Compare en tiempo constante (crypto.timingSafeEqual), y rechace lo que tenga más de 5 minutos.

\n

Qué responder

\n

Cualquier 2xx = entregado. Otra cosa, o no contestar en 10 segundos, cuenta como fallo y se reintenta a 1 min, 5 min, 30 min, 2 h y 6 h.

\n

La entrega es al-menos-una-vez: conteste rápido y procese después. Si hace el trabajo antes de responder, un proceso lento se convierte en un duplicado.

\n

La URL debe ser HTTPS y alcanzable desde internet.

\n","_postman_id":"5dd6a794-8fc4-4f06-aaf1-dd937248ea98","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}}},{"name":"MCP (asistente de IA)","item":[{"name":"Listar herramientas (tools/list)","id":"a00ab2da-e8a9-4746-808f-d82d46dcc01a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json, text/event-stream"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/list\",\n \"params\": {}\n}"},"url":"https://api.red-smart.com/mcp","description":"

Comprobación de conectividad: devuelve las 7 herramientas disponibles. Si esto responde, su asistente podrá conectarse.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}},"urlObject":{"path":["mcp"],"host":["https://api.red-smart.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a00ab2da-e8a9-4746-808f-d82d46dcc01a"}],"id":"1c4a786f-b993-4635-aa8d-c128042f6ebc","description":"

El mismo catálogo, para preguntarle en lenguaje natural desde Claude, ChatGPT o Cursor.

\n

Endpoint: https://api.red-smart.com/mcp · Header: X-Api-Key: rsk_…

\n

7 tools, solo lectura: get_roster · get_movimientos · get_checadas · get_capacitacion · get_acuses · get_descansos · get_nom035

\n

Desde Claude Code o Cursor:

\n
claude mcp add --transport http redsmartrh \\\n  \"https://api.red-smart.com/mcp\" \\\n  --header \"X-Api-Key: rsk_xxxxx\"\n
\n

En ChatGPT o claude.ai agréguelo como conector con esa URL y pegue su API key cuando la pida.

\n","_postman_id":"1c4a786f-b993-4635-aa8d-c128042f6ebc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"7d41d735-1307-4036-beae-f75a4000e7ef","id":"7d41d735-1307-4036-beae-f75a4000e7ef","name":"RedSmart · Integraciones RH","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-Api-Key"},{"key":"value","value":""}]}},"variable":[{"key":"apiHost","value":"https://api.red-smart.com"},{"key":"apiKey","value":""}]}