Cotizar

El endpoint de cotización nos permite obtener los precios y opciones de envío.

En cada cotización, se diberá indicar la cuenta, el origen, destino, valor declarado del envío y detalle de paquetes. Con respecto al origen, éste debe haber sido creado previamente.

En el response nos encontraremos dos bloques:

El primer array, results, contiene un resultado ganador de cotización por cada tipo de servicio. El mismo será el resultado ganador de la cotización dependiendo de la configuración de la cuenta o el parámetro opcional sort_by. La clave del array será el código de cada tipo de servicio, y en el detalle estará la información del transporte ganador.

En el segundo array, all_results, se proveen todos los resultados de transportes posibles. También se puede modificar el orden de estos resultados con el parámetro sort_by en el query string.

POST /shipments/quote
Parámetros para la URL:
sort_by string Opcional. Para indicar el ordenamiento de los resultados. Opciones:
price Ordena por menor a mayor precio
rating Ordena por mejor a peor nivel de servicio
time Ordena por menor a mayor tiempo de entrega
Parámetros para el body:
account_id int ID de la cuenta
origin_id int ID de algún origen de la cuenta. Ver Origenes
declared_value decimal Valor declarado del envío Ej: 200.50
packages array de Packages (objetos)
weight int Peso en gramos
height
length
width
int Medidas del paquete, en centímetros
classification_id int 1 General
2 Colchones
destination object
city string Ciudad/Localidad Ej. San Miguel de Tucuman
state string Provincia Ej. Tucuman
zipcode int Código postal Ej. 4500

Ejemplo:

POST https://api.zippin.com.ar/v2/shipments/quote

{
    "account_id": 34,
    "declared_value": 10000,
    "packages": [
        {
            "classification_id": 1,
            "weight": 50000,
            "height": 160,
            "width": 65,
            "length": 65,
            "description_1": "727273828832",
            "description_2": "Heladera No Frost 300L Samsung",
            "description_3": "SMF2828300"
        }
    ],
    "destination": {
        "city": "cordoba",
        "state": "cordoba",
        "zipcode": 5000
    }
}


RESPONSE 200
{
    "results": {
        "standard_delivery": {
            "carrier": {
                "id": 2,
                "name": "Andesmar",
                "rating": 0.89,
                "logo": "https://zippin-ar.s3.amazonaws.com/carriers/andesmar/BjfyAspVpfFSo3VTSiHrSwJWtsbXRLbYBM6DNl7Z.png"
            },
            "selectable": true,
            "amounts": {
                "price": 1676.86,
                "price_incl_tax": 2029
            },
            "delivery_time": {
                "min": 3,
                "max": 6
            },
            "service_type": {
                "id": 1,
                "code": "standard_delivery",
                "name": "Entrega a domicilio estándar",
                "is_urgent": 0
            },
            "rate": {
                "id": 9808,
                "tariff_id": 19
            }
        }
    },
    "all_results": [
        {
            "carrier": {
                "id": 2,
                "name": "Andesmar",
                "rating": 0.89,
                "logo": "https://zippin-ar.s3.amazonaws.com/carriers/andesmar/BjfyAspVpfFSo3VTSiHrSwJWtsbXRLbYBM6DNl7Z.png"
            },
            "selectable": true,
            "amounts": {
                "price": 1676.86,
                "price_incl_tax": 2029
            },
            "delivery_time": {
                "min": 3,
                "max": 6
            },
            "service_type": {
                "id": 1,
                "code": "standard_delivery",
                "name": "Entrega a domicilio estándar",
                "is_urgent": 0
            },
            "rate": {
                "id": 9808,
                "tariff_id": 19
            }
        },
        {
            "carrier": {
                "id": 204,
                "name": "Intralog",
                "rating": 0.8,
                "logo": "https://zippin-ar.s3.amazonaws.com/carriers/intralog/yIVzKJ9JTYb1scBFtkDqaRjquYJzIMxlaVtFAAzm.jpeg"
            },
            "selectable": true,
            "amounts": {
                "price": 1881.82,
                "price_incl_tax": 2277
            },
            "delivery_time": {
                "min": 4,
                "max": 3
            },
            "service_type": {
                "id": 1,
                "code": "standard_delivery",
                "name": "Entrega a domicilio estándar",
                "is_urgent": 0
            },
            "rate": {
                "id": 8943,
                "tariff_id": 67
            }
        },
        {
            "carrier": {
                "id": 8,
                "name": "La Sevillanita",
                "rating": 0.96,
                "logo": "https://zippin-ar.s3.amazonaws.com/carriers/la-sevillanita/Kt4qo3TsENegNCCnrW70OxQhBqbo7uyfemNRT5bH.png"
            },
            "selectable": true,
            "amounts": {
                "price": 2035.54,
                "price_incl_tax": 2463
            },
            "delivery_time": {
                "min": 10,
                "max": 10
            },
            "service_type": {
                "id": 1,
                "code": "standard_delivery",
                "name": "Entrega a domicilio estándar",
                "is_urgent": 0
            },
            "rate": {
                "id": 9658,
                "tariff_id": 30
            }
        },
        {
            "carrier": {
                "id": 201,
                "name": "CCCargas",
                "rating": 0.94,
                "logo": "https://zippin-ar.s3.amazonaws.com/carriers/cccargas/dM1jx0C57D1BKGMVDCLhJiDwP9PT0QErxkHyPUYK.png"
            },
            "selectable": true,
            "amounts": {
                "price": 3850.41,
                "price_incl_tax": 4659
            },
            "delivery_time": {
                "min": 4,
                "max": 5
            },
            "service_type": {
                "id": 1,
                "code": "standard_delivery",
                "name": "Entrega a domicilio estándar",
                "is_urgent": 0
            },
            "rate": {
                "id": 9754,
                "tariff_id": 61
            }
        }
    ],
    "destination": {
        "id": 4307,
        "city": "Cordoba",
        "state": "Cordoba",
        "zipcode": 5000
    }
}
Response (estructura de cada resultado)
selectable bool Si el resultado es seleccionable o no.
carrier
id int ID del transporte. Se deberá indicar en la creación del envío.
name string Nombre del transporte
rating decimal Puntaje del nivel de servicio del transporte. 0%-100%
logo string URL del logo del transporte
amounts
price decimal Precio sin IVA
price_incl_tax decimal Precio con IVA
delivery_time
min int Tiempo de entrega mínimo, en días hábiles
max int Tiempo de entrega máximo, en días hábiles
service_type
id int ID del tipo de servicio
code string Código del tipo de servicio. Se usará para la creación del envío
name string Nombre del servicio
is_urgent bool Si el servicio es urgente o no.