En el contexto de nuestra API, un Área representa una región geográfica operativa, la cual está compuesta por una colección de puntos de interés, barrios o códigos postales específicos. Estas áreas funcionan como polígonos virtuales sobre un mapa que delimitan nuestras zonas de cobertura.
El propósito principal de un área es actuar como una regla de validación al momento de crear un envío. Para que una solicitud de envío sea exitosa, tanto la dirección de origen como la de destino deben encontrarse dentro de los límites de una misma área o en áreas que estén conectadas operativamente.
Si una dirección se encuentra fuera de un área definida, no será posible procesar envíos desde o hacia esa ubicación a través de este sistema. Cada área posee un identificador único que puede ser utilizado para consultar coberturas y tarifas asociadas.
Recordar en todos los casos enviar como param el appId y dentro de los headers como Authorization, el appKey.
Paths:
Ambiente de desarrollo (test): https://api-dev.moova.io
Ambiente de Producción: https://api-prod.moova.io
Creación de Areas
Mediante este endpoint van a poder crear areas personalizadas que cumplan con sus requisitos.
Campos:
name: Nombre con el que quieren identificar a este area.
area: Todos los puntos del polígono.
is_dangerous: Si es un area peligrosa o no.
currency: El tipo de moneda.
symbol: El símbolo de la moneda.
locale: Codigo de localización.
meta: Información adicional.
Json Que se debe enviar:
{
"name": "Buenos Aires",
"country": "AR",
"area": [
"-34.62460386987226,-58.36211385211823\\n-34.61754062673878,-58.3552473970401\\n-34.58475931390431,-58.365890402411196"
],
"is_dangerous": false,
"currency": "ARS",
"symbol": "$",
"locale": "es_AR",
"meta": {}
}
Curl de ejemplo:
curl -X 'POST' \ 'https://api-dev.moova.io/saas/areas?appId=appId' \ -H 'accept: */*' \ -H 'Authorization: Authorization' \ -H 'Content-Type: application/json' \ -H 'X-CSRF-TOKEN: ' \ -d '{ "area": [ "-34.62460386987226,-58.36211385211823\n-34.61754062673878,-58.3552473970401\n-34.58475931390431,-58.365890402411196\n-34.557434771221686,-58.41021568762744\n-34.533539286799396,-58.46188576209033\n-34.54739667562728,-58.49467308508838\n-34.5650685682771,-58.48111183630908\n-34.57779000630545,-58.46840889441455\n-34.574963188291356,-58.46325905310596\n-34.600644734753175,-58.43851089477539\n-34.60778005929917,-58.43859672546387" ], "name": "Argentina1", "locale": "es_AR", "currency": "ARS", "symbol": "$", "country": "AR" }'Respuesta Exitosa:
{
"area":{
"type":"Polygon",
"coordinates":[
[
[
-58.36211385211823,
-34.62460386987226
],
[
-58.3552473970401,
-34.61754062673878
],
[
-58.365890402411196,
-34.58475931390431
],
[
-58.41021568762744,
-34.557434771221686
],
[
-58.46188576209033,
-34.533539286799396
],
[
-58.49467308508838,
-34.54739667562728
],
[
-58.48111183630908,
-34.5650685682771
],
[
-58.46840889441455,
-34.57779000630545
],
[
-58.46325905310596,
-34.574963188291356
],
[
-58.43851089477539,
-34.600644734753175
],
[
-58.43859672546387,
-34.60778005929917
],
[
-58.36211385211823,
-34.62460386987226
]
]
]
},
"name":"Argentina1",
"locale":"es_AR",
"currency":"ARS",
"symbol":"$",
"country":"AR",
"updated_at":"2025-09-03 19:14:42",
"created_at":"2025-09-03 19:14:42",
"id":3266
}
Lista de Areas creadas
Mediante este endpint van a poder ver la lista de todas las areas con su respectiva información.
Curl de ejemplo:
curl --location 'https://api-dev.moova.io/saas/areas?appId=appId' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'X-CSRF-TOKEN;' \
--header 'Authorization: Authorization'
Respuesta Exitosa:
{
"data":[
{
"id":1,
"name":"CABA1 ",
"country":"AR",
"area":{
"type":"Polygon",
"coordinates":[
[
[
-58.358337301826,
-34.645754686266
],
[
-58.356749434089,
-34.644192393932
],
[
-58.357307333564,
-34.642065157608
],
[
-58.357221502875,
-34.638975713077
],
[
-58.344690222358,
-34.631384017691
],
[
-58.326759338379,
-34.630100480727
],
[
-58.353538513184,
-34.584323024648
],
[
-58.377410039648,
-34.567422987082
]
]
]
},
"is_dangerous":0,
"currency":"ARS",
"symbol":"$",
"locale":"es_AR",
"meta":null,
"created_at":"2019-02-04 11:28:35",
"updated_at":"2025-09-04 18:13:27"
},
{
"id":2,
"name":"São Paulo",
"country":"BR",
"area":{
"type":"Polygon",
"coordinates":[
[
[
-46.612283688535,
-23.550804537914
],
[
-46.60949419116,
-23.561032737408
],
[
-46.620483398438,
-23.574686305893
],
[
-46.636569947004,
-23.566564893705
]
]
]
},
"is_dangerous":0,
"currency":"BRL",
"symbol":"R$",
"locale":"pt_BR",
"meta":null,
"created_at":"2019-02-04 11:28:35",
"updated_at":"2022-05-31 18:17:53"
}
],
"pagination":{
"total":678,
"limit":500,
"page":0
}
}
Actualizar un Area
Mediante este endpoint van a poder actualizar o modificar cualquier area que este creada por ustedes.
Curl de Ejemplo:
curl --location --request PATCH 'https://api-dev.moova.io/saas/areas/1?appId=appId' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'X-CSRF-TOKEN;' \
--header 'Authorization: Authorization' \
--data '{
"name": "CABA1 "
}'
Respuesta Exitosa:
{
"id": 1,
"name": "CABA1 ",
"country": "AR",
"area": {
"type": "Polygon",
"coordinates": [
[
[
-58.358337301826,
-34.645754686266
],
[
-58.356749434089,
-34.644192393932
],
[
-58.357307333564,
-34.642065157608
],
[
-58.357221502875,
-34.638975713077
],
[
-58.344690222358,
-34.631384017691
]
]
]
},
"is_dangerous": 0,
"currency": "ARS",
"symbol": "$",
"locale": "es_AR",
"meta": null,
"created_at": "2019-02-04 11:28:35",
"updated_at": "2025-09-04 18:13:27"
}