wiki-Alta-HD
Alta HD
Alta Planet
Alta de cuota
Esto se hace a través del panel de admin, dando de alta los addons correspondientes al usuario que será tenedor de la cuota. Para dar de alta un lote en Planet, es necesario saber el id del usuario del que se consumirá la cuota.
Para ver las cuotas, se puede usar la consulta de Planet https://bi.auravant.com/question/926
Alta de lotes
El segundo paso es asignarle HD a un lote. Para eso hay dos u opcionalmente 3 consultas a la API.
El usuario que utilice estas apis debe ser SUDO
1. verificación de area total (opcional)
Si hay que dar de alta muchos lotes puede interesar saber el area total a consumir.
POST https://api.auravant.com/api/internal/planet/shape/verify
Body: application/json
{
"field_ids": [ IDS DE LOTES]
}
Respuesta:
{
"res": "ok",
"data": {
"original_area": 65.67016400000001,
"requested_area": 80.04017323200281
}
}
- original_area es el area que se consumirá de la cuota, que es la suma del area de los lotes
- requested_area es el area que se consumirá en Planet (con buffers)
2. Validación de la suscripción
POST https://api.auravant.com/api/internal/planet/subscriptions/validate
Body: application/json
{
"field_ids": [ IDS ],
"sponsor_user_id": 18883,
"fetch_history": true
}
- sponsor_user_id es el id del usuario de la cuota
- fetch_history para procesar el historico (default true)
Respuesta: Por cada lote, se enviará un objeto como este:
{
"field_id": 197477,
"shape": "<features.ingest.shapes.Shape object at 0x7ff2502a6828>",
"addon_start_date": "2021-08-09T20:45:51Z",
"sponsor_user_id": 18883,
"addon_end_date": "2022-08-10T00:00:00Z",
"original_quota": 3.08,
"source_name": "geo gestion tech",
"quota_start_date": "2021-08-09T00:00:00Z",
"quota_end_date": "2022-08-10T00:00:00Z",
"consumed_quota": 0.0,
"field_name": "Verdesian_lote1_25demayo",
"consumer_name": "geo gestion tech",
"consumer_user_id": 18883,
"requested_area": 3.555096269163181,
"original_area": 3.07105,
"enough_quota": true,
"resulting_quota": 0.008950000000000014
}
Datos importantes:
- source_name Nombre del dueño de la cuota, verificar que esté bien
- consumer_name Nombre del dueño del lote, verificar que esté bien
- field_name Nombre del lote, verificar que esté bien
- resulting_quota Cuota después del consumo
- enough_quota Bool que indica si alcanza la cuota
Cuando se dan de alta más de un lote, si la validación falla para uno, falla para todos
Cuando se dan de alta más de un lote, la cuota resultante no se va acumulando, es decir que habría que verificar previamente que la cuota disponible alcance para todos los lotes. (esto está pendiente de cambio)
3. Creación de la suscripción
POST https://api.auravant.com/api/internal/planet/subscriptions/create
Es el mismo Body de la consulta 2. Copiar y pegar
Body: application/json
{
"field_ids": [ IDS ],
"sponsor_user_id": 18883,
"fetch_history": true
}
Respuesta: "subscriptions running"
Teniendo en cuenta el warning del punto anterior, si no se verificó la cuota, pueden darse de alta los primeros lotes y que en un punto el usuario se quede sin cuota, fallando el alta. Ahi a mano hay que revisar los que faltan
Los errores saltan en Sentry: https://logs.auravant.com/organizations/auravant/issues/?project=9