Quickstart: Emisión de Póliza

En esta guía, aprenderá a interactuar con la API de Yastubo para completar el flujo principal de negocio: desde la autenticación hasta la emisión de una póliza activa.

Requisitos Previos

Servidor local ejecutándose en http://localhost:8000.
Haber ejecutado scripts/backend_setup.py.
Recomendado: Tener la Yastubo Dev Machine (make cli) abierta en otra terminal para ver el estado de salud del sistema.
Un cliente REST (cURL, Postman) o usar la Swagger UI en /docs.

Paso 1: Autenticación

Obtenga un Token de Acceso (JWT). Por defecto, el sistema incluye el usuario admin@yastubo.com (contraseña: admin1234).

curl -X POST http://localhost:8000/api/v1/auth/login \
     -H "Content-Type: application/json" \
     -d '{"email": "admin@yastubo.com", "password": "admin1234"}'

Resultado: Copie el valor de access_token para los siguientes pasos.

Paso 2: Registro de Cliente (Suscriptor)

Antes de emitir una póliza, registre al titular del seguro.

curl -X POST http://localhost:8000/api/v1/emission/clients \
     -H "Authorization: Bearer TU_TOKEN_JWT" \
     -H "Content-Type: application/json" \
     -d '{
       "first_name": "Juan",
       "last_name": "Pérez",
       "email": "juan.perez@example.com",
       "phone": "+34600000000",
       "birth_date": "1990-01-01",
       "nationality": "ES",
       "country_of_residence": "ES",
       "document_type": "DNI",
       "document_number": "12345678Z"
     }'

Paso 3: Emisión en Borrador (DRAFT)

Seleccione un plan y vincúlelo al client_id generado.

# Consultar Planes Disponibles
curl http://localhost:8000/api/v1/plans/

# Crear Póliza
curl -X POST http://localhost:8000/api/v1/emission/policies \
     -H "Authorization: Bearer TU_TOKEN_JWT" \
     -H "Content-Type: application/json" \
     -d '{
       "client_id": "CLIENT_ID_GENERADO",
       "plan_id": "PLAN_ID_SELECCIONADO"
     }'

Paso 4: Activación y Generación de PDF

Para activar la póliza, se simulará la confirmación del pago.

# Activar Póliza
curl -X POST http://localhost:8000/api/v1/emission/policies/ID_DE_LA_POLIZA/transition \
     -H "Authorization: Bearer TU_TOKEN_JWT" \
     -H "Content-Type: application/json" \
     -d '{"target_status": "ACTIVE"}'

# Generar Certificado Legal (PDF)
curl http://localhost:8000/api/v1/emission/policies/ID_DE_LA_POLIZA/pdf \
     -H "Authorization: Bearer TU_TOKEN_JWT" \
     --output certificado_yastubo.pdf

Análisis Técnico: Ciclo de Vida de la Póliza

Yastubo Backend utiliza una Máquina de Estados de Ejecución Duradera. Esto garantiza que una póliza no pueda alcanzar el estado ACTIVE sin validaciones de negocio previas, incluyendo el cálculo de prima actuarial y la confirmación de pago.

Trazabilidad con Auditoría Automática

Cada comando ejecutado en este flujo genera una entrada en la tabla de auditoría. Puede verificarlo consultando el endpoint de auditoría:

curl http://localhost:8000/api/v1/audit/logs -H "Authorization: Bearer TU_TOKEN_JWT"

Resumen del Flujo de Emisión

Quickstart Flow