Guía del Portal de Operadores

El Portal de Operadores es un formulario web para que el personal de un cliente (por ejemplo, una farmacia o una asistencia al viajero) registre a un paciente y le envíe el acceso a una videoconsulta médica online. No requiere integración técnica ni clave API: el operador entra con su usuario y contraseña. Los mismos accesos también pueden generarse por API.

Acceso

Cada operador tiene un usuario propio. El link puede indicar el proveedor por su nombre; si no lo indica, o si ese proveedor no está disponible, el portal muestra los disponibles para elegir.

Formato del link:

https://nuevometodo.com/operators-portal?name=<nombre-del-proveedor>

Para dar de alta un operador o sumar un proveedor, contacte al equipo de Nume.

Flujo

El operador inicia sesión y elige el proveedor.
Completa los datos del paciente.
Presiona Generar token.
Nume envía al email del paciente el link de acceso a la videoconsulta.
La pantalla muestra el mismo link para copiarlo o compartirlo por WhatsApp.
El paciente abre el link e ingresa a la consulta. El link vence a los 30 minutos.
Con Registrar otro paciente el formulario queda listo para el siguiente.

Datos del paciente

Algunos datos opcionales son obligatorios para ciertos clientes. Si faltan, el portal lo indica al generar el token.

Campo	Obligatorio	Descripción
Nombre y apellido	Sí	Nombre completo del paciente.
Tipo de documento	Sí	Pasaporte, DNI, ID, CPF, RG, RUT u Otro.
Nro. de documento	Sí	Solo letras, números o guiones, sin puntos ni espacios.
Email	Sí	Dirección a la que se envía el link de acceso a la consulta.
Nro. de celular	Sí	Prefijo del país, código de área y número. Se usa para compartir el link por WhatsApp.
Fecha de nacimiento	Según el cliente	Algunos clientes la exigen para atender al paciente.
Género	Según el cliente	Masculino, Femenino o No especifica.
Obra social / prepaga	No	Cobertura del paciente. Se usa para emitir recetas y órdenes médicas.
Plan de la cobertura	No	Plan de la obra social o prepaga.
Credencial	Según el cliente	Número de credencial de la cobertura médica.
Código externo	Según el cliente	Identificador del paciente o del caso en un sistema externo.

Resultado

Token generado: el paciente recibe el email con el link. La opción Ver email muestra el mensaje enviado.
Email no enviado: el token se generó pero el email no pudo enviarse. El link sigue siendo válido y debe compartirse copiándolo o por WhatsApp.
Recientes: lista los links generados durante la sesión. No se guarda: al cerrar la página, la lista se pierde.

Uso por API

Genera el mismo acceso que el formulario, desde su sistema: Nume envía el email al paciente y devuelve el link. Se autentica con la clave API que entrega Nume, en el header Authorization: Bearer TU_CLAVE_API, y solo acepta llamadas desde los dominios o IPs habilitados para su empresa.

Endpoint:

POST https://api.nuevometodo.com/lad/tokens

Campo	Tipo	Descripción
`providerName`	string	Nombre del proveedor, tal como figura en el link del portal.
`name`	string	Nombre completo del paciente.
`documentType`	string	PAS, DNI, ID, CPF, RG, RUT u OTRO.
`documentNumber`	string	Solo letras, números o guiones, sin puntos ni espacios.
`email`	string	Dirección a la que Nume envía el link de acceso.
`phone`	string	En formato internacional, con + y sin espacios.Ejemplo: +5491122334455
`birthDate`	string (opcional)	AAAA-MM-DD. Algunos clientes la exigen.
`gender`	string (opcional)	M, F o X. Algunos clientes lo exigen.
`healthInsurance`	string (opcional)	Obra social o prepaga del paciente.
`healthInsurancePlan`	string (opcional)	Plan de la cobertura.
`credential`	string (opcional)	Número de credencial de la cobertura. Algunos clientes la exigen.
`externalId`	string (opcional)	Identificador del paciente o del caso en su sistema.

curl -X POST https://api.nuevometodo.com/lad/tokens \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "providerName": "farmacia-central",
    "name": "Juan Pérez",
    "documentType": "DNI",
    "documentNumber": "30111222",
    "email": "juan@ejemplo.com",
    "phone": "+5491122334455"
  }'

200 — Acceso generado

url es el link para el paciente y vence a los 30 minutos. Si emailSent es false, el email no pudo enviarse y el link debe compartirse por otro medio.

{
  "url": "https://nuevometodo.com/consulta/4f1c2b8e-9a3d-4e5f-8b6a-1c2d3e4f5a6b#t=eyJhbGciOi...",
  "emailSent": true
}

403 — Proveedor no disponible

providers lista los proveedores que sí puede usar.

{
  "key": "operators_portal.provider_not_allowed",
  "message": "Tu empresa no tiene habilitado ese proveedor. Elige uno de los disponibles.",
  "providers": [
    { "name": "farmacia-central", "description": "Farmacia Central", "country": "ARGENTINA" }
  ]
}

Otras respuestas: 400 si faltan datos o el servicio de videoconsulta no respondió (ver mensajes de error), y 401 si la clave no es válida o la llamada sale de un origen no habilitado.

Mensajes de error

Mensaje	Qué hacer
Faltan datos que este cliente exige para crear el acceso. Revisa fecha de nacimiento, género y credencial.	Completar esos campos y volver a generar el token.
No se pudo obtener el token LAD en este momento.	Volver a intentar en unos minutos. Si persiste, contactar al equipo de Nume.
Tu empresa no tiene habilitado ese proveedor. Elige uno de los disponibles.	Elegir un proveedor de la lista. Si falta alguno, contactar al equipo de Nume.
Sin proveedores habilitados	Contactar al equipo de Nume.
Tu empresa no tiene habilitado el Portal de Operadores.	Contactar al equipo de Nume.

Datos y privacidad

Los datos del paciente se envían al servicio de videoconsulta para crear el acceso, y el email se usa para enviarle el link.
De cada solicitud, Nume registra la fecha, el proveedor, el email al que se envió el link, el resultado y si el paciente abrió el link.
El link da acceso a una consulta médica: compártalo solo con el paciente.