Cotización y creación de ordenes
Última actualización
Última actualización
La cotización de envíos funciona igual que cualquier otra cotización. La única diferencia es que la autenticación se debe hacer con el access token, en vez de credenciales de la cuenta, y que luego, en vez de crear un envío, se deberá crear una Orden de Marketplace.
Revisa la .
Recuerda, no se deberían crear envíos en forma directa, si no Ordenes de Marketplace.
Una vez que el comprador realice su compra, y haya elegido una opción de entrega, deberías crear una orden en Zipnova Envíos para que el vendedor pueda verla y luego pueda crearse el envío a partir de ella.
Para crear la orden, deberás contar con algunos datos del envío, que surgen de la opción seleccionada por el comprador, entre la opciones disponibles de una cotización.
Transporte elegido (carrier_id)
Forma de despacho (logistic_type)
Tipo de servicio de entrega (service_type)
Origen del vendedor (origin_id)
Punto de entrega (point_id) - si se eligió una entrega en pickup point.
POST /v2/orders
Este request te permitirá crear ordenes de marketplace indicando los articulos que son parte del despacho. El sistema los agrupará en paquetes automáticamente, según las reglas definidas en la cuenta.
account_id*
int
ID de la cuenta del seller
shipping.origin_id*
int
ID del origen del envío
shipping.logistic_type
string
Código de la forma de despacho del envío.
Ejemplo: carrier_dropoff
Se recomienda explicitarlo basado en los resultados obtenidos en la cotización utilizar la opcion de envio deseada
shipping.service_type
string
Código de la forma de entrega del envío.
Ejemplo: standard_delivery
Se recomienda explicitarlo basado en los resultados obtenidos en la cotización utilizar la opcion de envio deseada
shipping.carrier_id
int
ID del transporte que hará la entrega.
Se recomienda explicitarlo basado en los resultados obtenidos en la cotización.
source*
string (150)
Utilizado para identificar la integración.
total_amount*
float
Monto total de la venta
delivery.recipient.name*
string (100)
Nombre y apellido del destinatario
delivery.address.street*
string (100)
Calle del domicilio de entrega.
Requerido solo en entregas a domicilio.
delivery.address.street_number*
string (10)
Altura/nro de puerta del domicilio de entrega.
Requerido solo en entregas a domicilio.
delivery.address.street_extras
string (190)
Referencias adicionales del domicilio como piso, departamento, nro de lote, etc.
Requerido solo en entregas a domicilio.
delivery.point_id
int
ID de la ubicación de entrega.
Requerido solo cuando la entrega es en un punto de entrega.
delivery.recipient.document*
string (50)
Número de documento (DNI, RUT, o lo que corresponda) del destinatario
delivery.recipient.email*
email (150)
Dirección de correo electrónico del destinatario
delivery.recipient.phone*
string (50)
Número de contacto del destinatario
delivery.address.state*
string
Nombre del Estado del domicilio del destinatario.
AR: provincia
CL: región
CO: departamento
MX: estado
Requerido solo en entregas a domicilio.
delivery.address.city*
string
Nombre de la ciudad del domicilio del destinatario.
AR: localidad
CL: comuna
CO: ciudad
MX: ciudad
Requerido solo en entregas a domicilio.
delivery.address.zipcode*
string
Codigo postal de la dirección de destino.
Requerido solo en entregas a domicilio.
Dato no requerido en Chile y Colombia.
delivery.address.country
string
Código ISO 3166-1 alfa-2 del país
Argentina: AR
Chile: CL
Colombia: CO
México: MX
delivery*
object
Objeto con datos de la entrega
items*
array[Item]
Array de objetos Item.
Cada Item es un articulo a enviar.
El máximo de artículos por envío es 1000.
Ten en cuenta que más allá de la cantidad de items, un envío no puede resultar en más de 99 paquetes.
items.*.sku*
string (190)
Se intentará vincular a un producto cargado en el catálogo de Zipnova.
items.*.weight*
int
Peso en gramos.
items.*.height*
int
Alto del artículo, en centímetros.
items.*.width*
int
Ancho del artículo, en centímetros.
items.*.length*
int
Largo del artículo, en centímetros.
items.*.name*
string (190)
Descripción o nombre del artículo
external_id*
string (30)
ID del envío en tus sistemas. Es para tu propia referencia.
paid_amount*
float
Monto total de la venta pagado por el comprador
shipping_paid_amount*
float
Monto correspondiente al envío pagado por el comprador
currency
string
Código de divisa Ej. ARS, CLP, MXN.
created_at*
timestamp
Fecha y hora de generación de la venta (ISO8601)
shipping*
object
items.*.qty
int
Cantidad vendida del item
items.*.unit_price
float
Precio unitario del producto
items.*.currency
string
Código de divisa Ej. ARS, CLP, MXN.
channel*
string
Identificación del canal. En caso de marketplace, utiliza el prefijo marketplace:
Por ejemplo: marketplace:amazon