Cartera y lotes
Crear una cartera, dibujar o importar AOIs, cargar la cartera en lote.
Fuente del diagrama (mermaid)
flowchart LR
P[POST /v1/portfolios] --> A[POST /v1/aois]
P --> I[POST /v1/import/aois]
I --> J[/v1/jobs · polling/]
A --> D[GET /v1/aois/id]
J --> D
Un lote por vez
curl -sS "$SBOX/v1/aois" -X POST \
-H "authorization: Bearer $TOKEN" \
-H "idempotency-key: aoi-demo-0001" \
-H "content-type: application/json" \
-d '{
"portfolioId": "<portfolioId>",
"name": "Lote Demo Norte",
"centroid": { "lat": -33.49, "lon": -63.49 },
"areaHectares": 4.1,
"perilProfile": ["hail"],
"aoiVersion": 1,
"ring": [[-63.5,-33.5],[-63.48,-33.5],[-63.48,-33.48],[-63.5,-33.48]]
}'El anillo va en orden GeoJSON [lng, lat], abierto (sin repetir el primer
punto). La superficie declarada tiene que coincidir con la que mide el anillo:
si difieren, quien compare las dos va a creer que el bug es suyo.
aoiVersion no es decorativo: entra en el hash de contenido de /v1/jobs.
Redibujar el lote SÍ es otro cálculo, y sin versión un footprint viejo se
reusaría para una geometría nueva.
En lote
Ver Batch import. El import usa el mismo evaluador de geometría que la consola: un lote que la consola rechaza, el import lo rechaza igual, con el mismo motivo.
Lo que se rompe
Un anillo que se cruza a sí mismo se rechaza con invalid_geometry porque no
tiene una superficie definida: dos herramientas distintas le dan áreas
distintas, y esa superficie es la base del capital asegurado.
Un archivo proyectado en metros (Web Mercator, Gauss-Krüger) se detecta y se rechaza con "coordenadas fuera de rango": reproyectalo a WGS84.