RUT, beneficiarios, ISAPRE

Skip es un producto chileno. Tres conceptos chilenos aparecen en todas partes en la documentación. Esta página los explica una sola vez.

RUT

El RUT ("Rol Único Tributario") es el ID nacional chileno. Toda persona y toda entidad legal tiene uno.

Formato: XXXXXXXX-Y, donde X es hasta 8 dígitos y Y es un dígito verificador (0–9 o K).

Normalización

Skip normaliza los RUTs antes de almacenar o comparar. Dos normalizaciones válidas del mismo RUT deben comparar igual:

12.345.678-9   →  12345678-9
12345678-9     →  12345678-9
12.345.678-K   →  12345678-K   (K mayúscula)

Reglas que aplica Skip:

• Quita los puntos.
• Mantiene el guion antes del dígito verificador.
• Convierte K a mayúscula.
• Sin ceros a la izquierda.

Cuando envías un RUT a Skip, puedes enviar cualquiera de las variantes — Skip normaliza al recibir. Cuando Skip te devuelve un RUT, siempre está en forma normalizada.

Validación

El dígito verificador se calcula del cuerpo del RUT con un algoritmo conocido. Si quieres validar client-side antes de enviar, la función canónica chilena de dígito verificador es:

function rutCheckDigit(body) {
  let sum = 0;
  let factor = 2;
  for (const digit of String(body).split("").reverse()) {
    sum += parseInt(digit, 10) * factor;
    factor = factor === 7 ? 2 : factor + 1;
  }
  const remainder = 11 - (sum % 11);
  if (remainder === 11) return "0";
  if (remainder === 10) return "K";
  return String(remainder);
}

Skip rechaza RUTs mal formados con 422. No te apoyes en la validación de Skip — valida client-side para mejor UX.

Beneficiario

Un Beneficiary es la ficha del paciente que Skip crea cuando un usuario se registra vía widget o POS. Un User (titular de cuenta) puede ser dueño de varios beneficiarios — él mismo, su pareja, sus hijos. El RUT es la clave única por beneficiario.

Cuando envías una boleta o creas una orden AAPD, Skip busca el Beneficiary por RUT y enruta todo (reembolsos, notificaciones) bajo esa ficha.

ISAPRE

Una ISAPRE ("Instituciones de Salud Previsional") es una aseguradora privada chilena de salud. Los pacientes son afiliados a una ISAPRE (o a FONASA, el seguro público) y presentan reembolsos a ella.

Cuando un paciente se registra a Skip, entrega sus credenciales de login de la ISAPRE. Skip las usa para presentar reembolsos en su nombre — el paciente nunca vuelve a iniciar sesión después del onboarding.

ISAPRE comunes en Chile: Banmédica, Colmena, Consalud, CruzBlanca, Vida Tres, Esencial. FONASA es la opción pública.

Cuando Skip dice "ISAPRE" en la documentación, se refiere a cualquiera de las anteriores más FONASA — el pipeline técnico es el mismo.

Por qué "issuer RUT" vs "doctor RUT"

Una boleta médica tiene dos RUTs relevantes:

• Issuer RUT (receipt_rut, provider_rut, issuer_rut — el nombre del campo varía por endpoint): la entidad que emitió la boleta. Usualmente la clínica o farmacia.
• Doctor RUT (doctor_rut, physician_rut): el médico que prestó el servicio.

Ambos los pide la ISAPRE para reembolso. Skip los almacena por separado. Cuando envías una boleta, popula los dos — incluso si es la misma persona (ej. un médico independiente que opera su propia clínica).