Guías por flujo
Siniestros y peritaje
Crear un siniestro, generar el dossier, descargar el peritaje.
Fuente del diagrama (mermaid)
flowchart LR
E[Evento] --> D[Detección]
D --> C[POST /v1/claims]
C --> P[POST /v1/peritajes]
P --> R[POST /v1/reports]
R --> V[POST /v1/verify]
Un peritaje cuelga de un siniestro y de una detección. La regla la impone el contrato: un peritaje sin medición no es evidencia, es una opinión con formato.
curl -sS "$SBOX/v1/claims" -X POST \
-H "authorization: Bearer $TOKEN" \
-H "idempotency-key: claim-demo-0001" \
-H "content-type: application/json" \
-d '{
"aoiId": "<aoiId>",
"peril": "hail",
"status": "submitted",
"eventWindow": { "start": "2026-01-14T20:00:00.000Z", "end": "2026-01-14T23:00:00.000Z" },
"claimedLossUsd": 42000,
"syntheticReporterRef": "synthetic_adjuster_demo"
}'
curl -sS "$SBOX/v1/peritajes" -H "authorization: Bearer $TOKEN"Lo que se rompe
422 invalid_request_body con el campo señalado cuando el siniestro apunta a un
AOI que no existe en la organización. La integridad referencial se valida
completa, no por recurso: un enlace roto pasa cualquier validación individual y
rompe recién en la demo, donde no hay stacktrace.
Los permisos son de siniestros (claims:read / claims:write), no de
cartera. Alguien que puede ver la cartera no ve los siniestros.