Ninsaúde

Cómo obtener las credenciales de la API

En la instalación del NicoApp, informas un único campo: el Access Token (Bearer), usado en todas las llamadas como Authorization: Bearer <token>.

La propia Ninsaúde documenta la autenticación de su plataforma de desarrollo (Ninsaúde Toro) de la siguiente manera:

• El estándar es OAuth2, con dos tokens: un Access Token, usado en todos los encabezados de solicitud, con validez de 15 minutos (funciona como una sesión); y un Token de actualización, sin validez definida, usado solo para obtener nuevos Access Tokens — sustituye el compartir usuario/contraseña con el app.
• La API sigue el estándar RESTful, con "miles de rutas disponibles", documentadas en una colección pública en Postman ("Ninsaúde Clinic").

Recomendación: ponte en contacto con el soporte o el equipo comercial de Ninsaúde (por el panel de la clínica o por los canales de atención) y solicita la emisión del Bearer Token de integración para la API. Al configurar, confirma con ellos si ese token expira (y necesita renovarse periódicamente, como el Access Token de 15 min del flujo OAuth2 estándar) o si es un token de integración de larga duración — eso cambia la forma en que debes reinstalarlo/actualizarlo en el app.

Fuentes: página de Desarrolladores de Ninsaúde y colección "Ninsaúde Clinic" en Postman.

Limitaciones

• Validez del token: si la credencial sigue el estándar OAuth2 descrito por Ninsaúde, el Access Token dura solo 15 minutos — confirma con el soporte de Ninsaúde la validez del token usado en este app y si necesita renovación periódica.
• Plan necesario: no documentado públicamente. Trátalo como una pregunta obligatoria al activar la integración con el cliente.

Qué hace el NicoApp

Pacientes

Agenda

Comunicación interna

Consejos y observaciones

• "Agendar Consulta" vs. "Agendar Consulta #1": a pesar del nombre parecido, no son duplicadas — Agendar Consulta crea un agendamiento nuevo (POST /atendimento_agenda) y Agendar Consulta #1 en realidad reagenda un agendamiento existente (POST /atendimento_agenda/reagendar/agendamento/{id}). En esta documentación se la llamó Reagendar Consulta para dejar claro el propósito.

• Cálculo automático de la Hora Final: en Agendar Consulta y en Reagendar Consulta, si la Hora Final no se informa, el app busca la duración predeterminada del Servicio elegido (GET /cadastro_servico/{id} → duracaoPadrao) y calcula Hora Final = Hora Inicial + duración automáticamente — no es necesario informar los dos horarios manualmente.
• IDs encadenados: el ID del Paciente sale de Crear/Buscar Paciente y entra en Actualizar, Eliminar y Agendar Consulta. El ID del Agendamiento sale de Agendar Consulta y entra en Reagendar Consulta, Eliminar Agendamiento y Editar Status del Agendamiento.
• Formatos de fecha/hora: fechas en AAAA-MM-DD (ej.: 2026-08-01); horarios en HH:MM:SS (ej.: 17:00:00).
• Buscar Paciente: la acción intenta CPF, después e-mail, después celular, en ese orden, hasta encontrar exactamente un paciente — si no encuentra ninguno, el error es "Paciente no encontrado"; si encuentra más de uno, "Múltiples pacientes encontrados" (pide un dato más específico al usuario para refinar la búsqueda).
• Mensaje Interno: el texto enviado se higieniza antes del envío — los saltos de línea y las tabulaciones se convierten en espacio, las comillas simples en acento grave y las comillas dobles en comillas tipográficas, evitando romper el JSON de la solicitud.
• Tratamiento de errores: toda acción devuelve el error real de Ninsaúde (campo error de la respuesta) cuando la llamada falla — usa el camino de error del bloque para tratarlo en el flujo (ej.: token inválido/expirado, horario no disponible, campo obligatorio faltante).