Saltar a contenido

Flujo operativo — Emisión y consulta de receta electrónica

A continuación se describen los pasos operativos típicos para integrar el ciclo de vida de una receta electrónica con Asystir. Incluyo diagramas en mermaid (soportado por Docusaurus con plugin mermaid).

Resumen del proceso

  1. El desarrollador (su app) valida identidad y profesional.
  2. Se genera un CUIR.
  3. Se registra la receta en Asystir (opcional: se notifica al Ministerio).
  4. Se consulta / lista / audita.

Diagrama (Mermaid)

flowchart TD
  A[Cliente (App del profesional)] --> B[Verificar persona]
  A --> C[Verificar profesional]
  C --> D{Profesional válido?}
  D -- Sí --> E[Generar CUIR]
  E --> F[Registrar Receta (Asystir)]
  F --> G{Registro OK?}
  G -- PENDING --> H[Envío a Ministerio / Trámites]
  G -- COMPLETED --> I[Respuesta al cliente: receta disponible]
  G -- FAILED --> J[Notificar error y resolución]
  I --> K[Listar / Consultar Recetas]
  H --> K

Secuencia HTTP (paso a paso)

  1. Verificar persona POST /v1/persona/verificar

  2. Objetivo: obtener datos demográficos del paciente (nombre, domicilio, edad).

  3. Verificar profesional POST /v1/profesional/verificar

  4. Objetivo: validar matrícula, REFEPS y especialidad del prescriptor.

  5. Generar CUIR POST /v1/cuir/generar

  6. Objetivo: construir la clave única (CUIR) para la receta.

  7. Registrar receta POST /v1/recetas/registrar

  8. Incluya Idempotency-Key. Devuelve id_transaccion y estado.

  9. Listar / Consultar GET /v1/recetas/listar

  10. Objetivo: auditoría, consulta por paciente o profesional.

Recomendaciones de implementación

  • Siempre use la sandbox para pruebas y genere Idempotency-Key para todos los registros.
  • Trate las llamadas a servicios externos (REFEPS, SISA, ministerio) con timeouts razonables (p. ej. 5–15s) y reintentos exponenciales limitados.
  • Mantenga logs de auditoría (request id, usuario, IP) para cumplir requisitos regulatorios.
  • En cliente web, no exponga X-API-Secret; pasar por un backend seguro.

Representación de errores y reintentos

  • Las operaciones de registro deben tratar 429 y 5xx con reintentos exponenciales.
  • Para POST /v1/recetas/registrar usar Idempotency-Key permite reintentos seguros sin duplicar registros.