Flujos de Spot

La contrapartida narrativa a la referencia por endpoint. Cada flujo recorre un proceso completo, muestra la secuencia de llamadas, y enlaza a las páginas de endpoint relevantes.

Onboarding del paciente vía widget

El flujo widget es la integración Spot más común. Una clínica o plataforma de agendamiento mintea un token desde su backend, embebe un iframe, y escucha el evento de completitud del paciente.

1. El backend del partner mintea un token. Ver Generar widget token.
2. Skip retorna widget_token y url. El backend pasa la URL al frontend.
3. El frontend renderiza el iframe. Dimensiones y CSP en Spot Widget → Embeber el iframe.
4. El widget pide a Skip el estado de la sesión. Esto determina la primera pantalla que ve el paciente.
5. El widget renderiza la pantalla acorde. No gestionas las pantallas — el widget lo hace.
6. El paciente envía el form. El widget crea el usuario en Skip.
7. Skip registra al paciente y vincula sus cuentas de seguro. Devuelve éxito.
8. El widget emite postMessage. Tu frontend escucha y reacciona. Ver Spot Widget → Eventos postMessage.

Casos inusuales (colisión de RUT, token expirado, abandono a mitad de flujo) en Spot Widget → Casos borde.

Envío de boletas y extracción IA

Los proveedores de boletas empujan directo a Skip; el paciente nunca toca una UI. Tú haces un POST y recibes un 200; el resto del procesamiento ocurre del lado de Skip.

Qué ves vs qué corre en background

• Tú ves: HTTP 200 con processed_files. Si la extracción IA tuvo éxito o si la ISAPRE aceptó el reembolso — nada de eso aparece en tu respuesta.
• Background: Extracción IA, notificaciones al paciente, presentación de reembolso por cada ISAPRE. Todo asíncrono, todo trackeado en Skip pero no expuesto a tu endpoint en v0.

Skip deduplica boletas por archivo dentro de un mismo paciente y origen: reenviar el mismo documento no crea un gasto duplicado. receipt_id es solo una referencia tuya, no la clave de dedup. Detalle en Boletas → Deduplicación.

Modos de fallo

Ciclo de vida de la suscripción

Un usuario Skip está en uno de tres estados de suscripción en cualquier momento. El estado afecta lo que renderiza el widget.

Skip determina el estado internamente; el widget renderiza la pantalla acorde. El umbral de prueba gratuita es 2 boletas enviadas.

Videos demo

Grabación pendiente. Cada item se convertirá en un YouTube unlisted embebido cuando lo grabemos. La lista está ordenada por lo que el equipo planea grabar primero.

1. Widget Spot en un sitio de partner real (~2 min) — Una integración estilo Reservo: minteo del token, embed del iframe, escuchar el evento de completitud. Audiencia: ingenieros/as de integración.
2. Envío de boleta vía cURL (~1 min) — Mandar una boleta con el endpoint de archivo y verla aparecer en Skip. Audiencia: proveedores de boletas estilo DTEmite.
3. Los tres event_type del widget en acción (~3 min) — SPOT_USER_NEW → SPOT_USER_CREATED, plus GOKEI_PRO_USER y la pantalla de recuperación para RUT_OTHER_EMAIL. Audiencia: cualquiera que embebe el widget.
4. Flujo POS en mostrador de clínica (~2 min) — Lookup por RUT, crear usuario desde input del personal. Audiencia: clínicas con flujo de mostrador.