La cotización es el proceso mediante el cual se obtienen opciones para hacer un envío.
En Zipnova existen múltiples maneras de hacer un envío, combinando diferentes formas de despacho (logistic_type) y formas de entrega (service_type).
En los resultados de cotización verás todas las opciones disponibles en tu cuenta para hacer el envío, con los distintos transportes disponibles.
Recomendamos completar el atributo source con algo que identifique a tu integración, para que luego los clientes puedan definir reglas personalizadas de cotización utilizando el Motor de Reglas, utilizando el atributo source como criterio de filtrado.
Cotizar envío
post
/shipments/quote
Obtiene las opciones de envío disponibles con sus costos y tiempos estimados.
items vs packages — debes usar uno u otro, nunca ambos:
items (recomendado): Lista de unidades individuales de productos. El sistema las empaqueta automáticamente según el modo type_packaging. Cada item puede referenciar un SKU de la cuenta (con sku) o bien declarar explícitamente sus dimensiones y peso.
packages: Lista de bultos ya definidos con dimensiones explícitas. Útil cuando el empaquetado ya está resuelto del lado del integrador. Cada paquete puede referenciar un SKU (sku / sku_id) para obtener sus dimensiones, o declararlas manualmente. Opcionalmente puede incluir items internos si se especifica un container_id.
Autorizaciones
AuthorizationstringRequerido
Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña
Cuerpo
account_idintegerRequerido
ID de la cuenta
Example: 1234
origin_idintegerOpcional
ID del address book de origen. Si se omite, se usa el origen por defecto de la cuenta.
Example: 987654
sourcestringRequerido
Identificador de la fuente que genera la cotización (ej. nombre de la integración). Máximo 150 caracteres.
Example: mi-tienda
declared_valuenumberRequerido
Valor declarado del envío (numérico, mínimo 0). Si se indica en cero, el envío no contará con cobertura del seguro.
Example: 45643.5
type_packagingstring · enumOpcional
Modo de empaquetado, aplicable solo cuando se usa items. dynamic: el sistema elige los mejores contenedores disponibles. boxes: usa los contenedores configurados en la cuenta. none: cada ítem es un bulto individual.
Valores posibles:
logistic_typestringOpcional
Filtra los resultados por tipo logístico (ej. carrier_pickup, carrier_dropoff).
Example: xd_dropoff
service_typestringOpcional
Filtra los resultados por código de tipo de servicio.
Example: standard_delivery
sort_bystring · enumOpcional
Criterio de ordenamiento de los resultados.
Valores posibles:
avoid_rulesbooleanOpcional
Si es true, omite la aplicación de reglas de negocio de la cuenta.
Example: false
include_dropoff_pointsinteger · enumOpcional
Si es 1, incluye puntos de dropoff cercanos al origen en cada resultado que aplique.
Example: 0Valores posibles:
Respuestas
200
Lista de opciones de envío disponibles con precios y tiempos
application/json
sorted_bystring · enumOpcional
Criterio de ordenamiento aplicado a los resultados
ID del proveedor dropshipping asociado al origen, si aplica
400
Datos inválidos o cuenta inactiva
403
Sin permiso para cotizar en esta cuenta
422
Error de validación
post
/shipments/quote
Respuesta de cotización
La respuesta de la cotización incluirá los siguientes elementos:
destination
Describe la localidad/comuna/ciudad de destino que fue identificada según los datos suministrados en el request.
packages
Sirve como referencia para entender cómo se construyeron los paquetes que conforman el envío.
Si al cotizar indicaste paquetes, reflejará la misma información del request.
En cambio, si indicaste items, aquí te mostrará cómo han sido agrupados esos items en paquetes.
results/all_results
Aquí estarán las distintas opciones para poder realizar un envío.
En el objeto results tendrás un solo resultado ganador por cada service_type (forma de entrega).
En el objeto all_results tendrás todos los resultados disponibles.
Atributos de un result
Atributo
Descripción
service_type
Tipo de servicio: la forma de entrega del envío.
El atributo code deberá ser usado al crear el envío (ej. standard_delivery)
logistic_type
Modo de despacho: cómo se va a despachar el envío
carrier
El transporte que hace la entrega. El atributo id deberá ser usado para crear el envío.
delivery_time
Indica el tiempo de entrega.
estimated_delivery indica la fecha máxima de entrega
estimation_expires_at indica cuando vence la estimación
times: indica distintos tiempos del proceso de entrega, en formato ISO8601 de duración.
amounts
Indica aspectos del precio del envío.
price es el precio sin IVA que debe pagar el comprador
price_incl_tax es el precio con IVA que debe pagar el comprador
seller_price es el precio sin IVA que paga el vendedor
seller_price_incl_tax es el precio con IVA que paga el vendedor
price_shipment refleja la porción del precio del envío que es pura del envío
price_insurance refleja la porción del precio del envío que corresponde al seguro y depende del valor declarado.
price y seller_price por lo general son lo mismo, salvo en algunos casos:
Cuando el resultado es de Flota Propia o Contrato Propio, el price refleja el precio de la tarifa y seller_price lo que cobra Zippin.
Cuando haya una regla que modifiquen el precio del envio, esa modificación se ve reflejada en price, mientras que seller_price mantiene el valor original.
pickup_points
Es un array con puntos habilitados para la entrega del envío, cuando el tipo de servicio es pickup_point.
De cada punto es importante obtener el point_id, que deberá ser enviado al crear el envío para indicar la sucursal de entrega.
