API Cotizador (Quote)
Descripción¶
La API Cotizador permite obtener una tarifa con un valor aproximado del costo de un envío. El cálculo del mismo se ve afectado por las siguientes variables:
- Peso y medidas del paquete (bulto).
- Categoría del producto que haya dentro del paquete.
- Destino donde debe ser entregado el envío.
GET (CATEGORÍAS)¶
Endpoint¶
🔐 GET - Ambiente Productivo
🚀 https://apis.andreanigloballpack.com/cotizador-globallpack/api/v1/Categorias
🧪 GET - Ambiente de Prueba
🛠️ https://apisqa.andreanigloballpack.com/cotizador-globallpack/api/v1/Categorias
El endpoint reporta las categorías de producto admitidas por GlobAllPack. Para la cotización es necesario indicar algún item de este listado, lo que permitirá calcular los valores a cobrar en la importación.
Response¶
Status 200 (OK)
[
{
"id": 2,
"nombre": "Accesorios para Celulares y Tablets"
},
{
"id": 3,
"nombre": "Alimentos permitidos"
},
{
"id": 4,
"nombre": "Artículos de ortopedia"
},
{
"id": 5,
"nombre": "Artículos para mascotas"
},
{
"id": 6,
"nombre": "Calzado"
},
{
"id": 7,
"nombre": "Celulares"
},
{
"id": 8,
"nombre": "Consolas de videojuegos"
},
{
"id": 9,
"nombre": "Decoración"
},
{
"id": 10,
"nombre": "Deportes y Camping"
},
{
"id": 11,
"nombre": "Electrónica, Tecnología e Informática"
},
{
"id": 12,
"nombre": "Herramientas y equipamiento"
},
{
"id": 13,
"nombre": "Hogar"
},
{
"id": 14,
"nombre": "Instrumentos musicales"
},
{
"id": 15,
"nombre": "Accesorios musicales"
},
{
"id": 16,
"nombre": "Joyería y bijouterie"
},
{
"id": 17,
"nombre": "Juguetes y coleccionables"
},
{
"id": 18,
"nombre": "Librería"
},
{
"id": 19,
"nombre": "Libros"
},
{
"id": 20,
"nombre": "Maquillaje y cosmética"
},
{
"id": 21,
"nombre": "Otros"
},
{
"id": 22,
"nombre": "Lentes y gafas de sol"
},
{
"id": 23,
"nombre": "Relojes y accesorios"
},
{
"id": 24,
"nombre": "Repuestos de vehículos"
},
{
"id": 25,
"nombre": "Vestimenta"
}
]
GET (COTIZACIÓN)¶
El presente endpoint permite obtener un valor aproximado del costo de un envío.
🔐 GET - Ambiente Productivo
🚀 https://apis.andreanigloballpack.com/cotizador-globallpack/api/v1/Cotizador
🧪 GET - Ambiente de Prueba
🛠️ https://apisqa.andreanigloballpack.com/cotizador-globallpack/api/v1/Cotizador
Query Params¶
| PARÁMETRO | DESCRIPCIÓN |
|---|---|
| CpDestino | Código postal de destino. |
| CiudadDestino | Ciudad de destino. |
| PaisDestino | País de destino (código internacional). |
| CpOrigen | Código postal de origen. |
| CiudadOrigen | Ciudad de origen. |
| PaisOrigen | País de origen (código internacional). |
| Contrato | Contrato para cálculo de costo del envío en ultima milla(territorio nacional) |
| Cliente | Código de cliente para cálculo de costo del envío en ultima milla(territorio nacional) |
| bultos[0].valorDeclarado | Precio unitario del producto enviado (pesos argentinos) |
| bultos[0].volumen | Volumen del paquete |
| bultos[0].kilos | Peso del paquete |
| bultos[0].altoCm | Alto del paquete en centímetros |
| bultos[0].largoCm | Largo del paquete en centímetros |
| bultos[0].anchoCm | Ancho del paquete en centímetros |
| bultos[0].categoriaProducto | Nombre de la categoría de producto que cotiene el paquete. Debe existir en el GET de Categorías |
Dirección de destino¶
Los datos de destino (cpDestino, CiudadDestino) deben coincidir con los normalizados por Andreani:
API: https://apis.andreani.com/v1/localidades (no requiere autenticación)
info y documentación: https://developers.andreani.com/document
Transporte y distribución -> datos maestros -> Localidades
Response¶
Status 200 (OK)
{
"FleteAereo": 2332.125,
"Seguro": 310.95,
"TasaImportacion": 7084.99575,
"UltimaMilla": 7598.95,
"CostoDesaduanaje": 10365,
"pesoAforado": "1330.00",
"tarifaSinIva": {
"seguroDistribucion": "0.30",
"distribucion": "6279.82",
"total": "6280.12"
},
"tarifaConIva": {
"seguroDistribucion": "0.36",
"distribucion": "7598.58",
"total": "7598.95"
}
}
| CAMPO | DESCRIPCIÓN |
|---|---|
| FleteAereo | Es el precio que se paga por transportar la mercancía vía aérea |
| Seguro | Costo del seguro del envío |
| CostoDesaduanaje | proceso mediante el cual se regulariza la entrada de productos importados a un país, cumpliendo con los requisitos legales y aduaneros establecidos. Este término es también conocido como "nacionalización" |
| Tasa Importación | Impuesto que se cobra a los productos que ingresan al país. |
| UltimaMilla | Costo de distribución en el país de destino. |
-
TarifaSinIva y TarifaConIva es el detalle desmenuzado del costo de última milla.
-
La suma de FleteAereo + Seguro + TasaImportacion + CostoDesaduanaje + UltimaMilla da como resultado el total de la la tarifa.
Status 400 (BadRequest)
Ocurre cuando algún dato es inválido.
[
{
"code": "400",
"property": "categoria",
"message": "La Categoria café no existe."
}
]