La cotización de un shipping permite obtener el costo de un envío.
Hay tres Endpoints para obtener esta información.
URL base para el entorno de prueba: https://api-dev.moova. io/b2b
URL base para el entorno Real: https://api-prod.moova.io/b2b
/b2b/v1/budgets | Cotización cuando la direcciones están en una solo string |
/b2b/v2/budgets | Cotización cuando la direcciones están divididas en (dirección, número, etc) |
/b2b/budgets/estimate | Estimación de cotización basada en código postal. La cotización es un estimado. |
La mejor opción es /b2b/v2/budgets cuando tenemos la dirección con datos separados (calle, número, ciudad, etc), en todos los casos se deben pasar como Query Params el appId y en los Headers el Authorization.
Ejemplos de Payloads para cada uno de los casos.
/b2b/v1/budgets
Query Params
Se requiere que le pasemos como valor el "From" que es la dirección desde donde se envía y el "To" que es a donde se envía ese paquete.
Headers
Parameters del Body
{
"conf": {
"assurance": false,
"backAndForth":false,
"items": [
{
"item": {
"description": "iPhone",
"price": 150,
"weight": 2000,
"length": 20,
"width": 20,
"height": 20
}
}
]
}
}Response
{
"size_id": 3,
"size_name": "M",
"price": 200,
"billing": {
"net_price": 200,
"taxes": 42,
"gross_price": 242
},
"price_formatted": "$ 200,00",
"currency": "ARS",
"symbol": "$",
"quote_id": 626,
"kms": 2.166,
"budget_id": 8286,
"token": "fd38992f0f915e9f6250a8f05b8f0d40ad25ee03a58ff2ef24a291ff178bfbed"
}/b2b/v2/budgets - Es el mas recomendado
Se debe pasar todo como Parameters del Body
Payload
{
"from": {
"street": "Av. Santa Fe",
"number": "2678",
"floor": "6to",
"apartment": "C",
"city": "Capital Federal",
"state": "Capital Federal",
"postalCode": "1425",
"country": "AR"
},
"to": {
"street": "Cordoba",
"number": "1500",
"floor": "3to",
"apartment": "b",
"city": "Capital Federal",
"state": "Capital Federal",
"postalCode": "1425",
"country": "AR"
},
"conf": {
"assurance": false,
"backAndForth": false
},
"items": [
{
"description": "T-Shirt",
"referenceCode": "AB-1222",
"serialNumber": null,
"weight": 1500,
"length": 40,
"width": 30,
"height": 50,
"price": 2350.99,
"currency": "ARS",
"quantity": 1
}
],
"shipping_type_id": 1
}Response
{
"size_id": 2,
"size_name": "S",
"price": 200,
"billing": {
"net_price": 200,
"taxes": 42,
"gross_price": 242
},
"price_formatted": "$ 200,00",
"currency": "ARS",
"symbol": "$",
"quote_id": 626,
"kms": 2.166,
"budget_id": 8282,
"token": "6f5dce09fbe1c03bf50fa9bafcf89751ef4aa7bfc675e914fff4f74f1bc3b208"
}/b2b/budgets/estimate
Se debe pasar todo como Parameters del Body
Payload
{
"from": {
"placeId": 10,
"street": "Av. Santa Fe",
"number": "2678",
"floor": "6to",
"apartment": "C",
"city": "Capital Federal",
"state": "Capital Federal",
"postalCode": "1425",
"country": "AR"
},
"to": {
"postalCode": "1642",
"country": "AR"
},
"conf": {
"assurance": false,
"backAndForth": false
},
"items": [
{
"description": "T-Shirt",
"referenceCode": "AB-1222",
"serialNumber": null,
"weight": 1500,
"length": 40,
"width": 30,
"height": 50,
"price": 2350.99,
"currency": "ARS",
"quantity": 1
}
],
"shipping_type_id": 1
}Response
{
"size_id": 1,
"size_name": "XS",
"price": 323.08,
"billing": {
"net_price": 323.08,
"taxes": 67.84679999999999,
"gross_price": 390.92679999999996
},
"price_formatted": "$ 323,08",
"currency": "ARS",
"symbol": "$",
"quote_id": 449,
"budget_id": 8290,
"token": "408394c10938b97a852ba2df00f51a0888fcfe9bd9ae82a7053fc2cb0daf1269".
} La documentación formal de la API la encontrarás en swagger aquí.
Errores por fuera de cobertura
En el caso de que algún cliente quiera la cotización de un envío entre por ejemplo Argentina y China este no será valido debido a que no existe cobertura entre estas áreas, por lo que en caso de que este no sea un error y quieran hacerlo se deberán contactar con un asesor que evaluara de ser o no posible esta acción.