Estimacion Ecommerce External
POST {{url}}/moovinApiWebServices-{{country}}/rest/api/ecommerceExternal/estimation
Permite obtener las posibles formas de entrega con su costo y tiempo de entrega.
Tipos de servicios
El tipo de servicio hace referencia a la solicitud de requerida por el cliente en la siguiente lista se detalla los servicios que ofrece moovin, para poder solocitar este servicio de envia con el nombre de parámetro * * serviceType * *
- DELIVERY: este es el servicio de recolección y entrega al cliente.
- REVERSELOGISTIC: este servicio hace referencia a la logistica inversa de forma que el cliente pueda devolver los productos que se han adquirido anteriormente.* * Nota * * : si el parámetro no es enviado el servicio por defecto seleccioando por el sistema es DELIVERY.
Estados
- SUCCESS: se completo correctamente.
- ERRORZONE: no se encuentra dentro de la zona de cobertura de moovin.
- ERRORDANGERZONE: el punto se encuentra en una zona peligrosa, por lo que moovin no realiza la entrega.
- ERRORLISTPRODUCT : la lista de productos a entregar se encuentra vacía.
- ERRORWEIGHT: si uno de los productos sobrepasa el peso permitido para transportar el cual es de 45kg.
- ERRORSIZE: si el paquete sobrepasa las dimensiones permitidas para ser transportado, este representa el paquete de mayor dimensión. (ver la tabla 1 Tamaño del paquete)
Nota
Tipos de vehículos
Se puede solicitar la estimación para los siguientes tipos de vehiculos:
- motorcycle
- car
Se hace mención que este no es un parámetro obligatorio, solo debe ser incluido en caso particulares. Por ejemplo un queque, el producto tiene las dimensiones para ser transportado por una motocicleta pero por alguna condición su transporte debe ser en carro
Tamaño
Para poder definir el tamaño se puede realizar bajo dos condiciones, especificando el size (ver la tabla 1 Tamaño del paquete), mediante las dimensiones brindadas por Moovin o enviando los 3 parámetros de las dimensiones: - length: largo - width: ancho - high: alto
Nota: Se combinan las productos con size y otros asigando dimensiones, el sistema dimensionará los paquetes que tengan el factor size como se muestra en la tabla 1 Tamaño del paquete.
Lista de tamaños establecidos por Moovin:
Acrónimo | Largo (cm) | Ancho (cm) | Alto (cm) | Peso máximo (Kg) |
---|---|---|---|---|
XS | 16 | 15 | 4 | 0.5 |
S | 24 | 17 | 9 | 1 |
M | 32 | 22 | 18 | 2 |
L | 39 | 22 | 19 | 7 |
XL | 97 | 56 | 26 | 10 |
XXL | 120 | 80 | 27 | 15 |
XXXL | 240 | 100 | 35 | 25 |
Tabla 1: Tamaño del paquete
Parámetros de respuesta
- deliveryTime: Se presenta en horas. Indicando el tiempo máximo en el cual se realizará el servicio.
La respuesta entrega dos parámetros que deben propocionarse para cuando se desea ejecutar la creación del paquete los cuales son:
- idEstimation: hace referencia a la estimación del servicio que se desea solicitar.
id: en cada una de las opciones de entrega aparece el id que debe ser enviado al solicitar el servicio para que el sistema identifique la opción de envío.
deliveryTime: es el tiempo en horas que tienen Moovin para realizar la entrega desde que este ha recogido el paquete. Si la orden de recolección se generó (Complete Order) en el sistema de Moovin antes de las 12 del medio día de un día laborable de lunes a viernes, el paquete podrá entregarse al día hábil siguiente.
En caso de que la orden se genere después de las 12am la recolección será al día siguiente de recibir la notificación y se entregara al siguiente día hábil.
Request Body
{"idEstimation"=>9540, "idDelivery"=>2, "servicetype"=>"DELIVERY", "cediMoovin"=>false, "idOrder"=>"343842390jdsh3ju03424", "email"=>"ejimenez@moovin.me", "emailAccount"=>"ejimenez@movin.me", "prepared"=>false, "pointCollect"=>{"latitude"=>9.929652, "longitude"=>-84.134719, "locationAlias"=>"Moovin", "name"=>"Edward", "phone"=>"87988684", "identificationCard"=>"11XXXX680", "notes"=>"Decirle que es frágil"}, "pointDelivery"=>{"latitude"=>9.929652, "longitude"=>-84.134719, "locationAlias"=>"Autopista 27", "name"=>"Daniel Somlo", "identificationCard"=>"124450570", "phone"=>"87988684", "notes"=>"Casa de color amarilla", "documents"=>[{"name"=>"Cédula", "fields"=>[{"name"=>"Cédula frontal", "type"=>"image", "description"=>"Que la cédula se encuentre en perfecto estado", "url"=>"Información sobre prodecimiento"}, {"name"=>"Cédula reverso", "type"=>"image", "description"=>"Que la cédula se encuentre en perfecto estado", "url"=>"Información sobre prodecimiento"}]}, {"name"=>"Contancia salarial", "fields"=>[{"name"=>"Constancia al día", "type"=>"document", "description"=>"Recoger contancia salarial con 30 días de vigencia"}]}], "listPayment"=>[{"description"=>"Total de cobro", "amount"=>1000, "currency"=>"colones", "method"=>"cash"}]}, "listProduct"=>[{"quantity"=>1, "nameProduct"=>"Samsumg", "description"=>"Galaxy S7", "length"=>16, "width"=>4.5, "high"=>12, "weight"=>0.4, "price"=>200000, "codeProduct"=>"234234234234"}], "ensure"=>true}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
token | string |
RESPONSES
status: OK
{"status":"ERRORDANGERZONE","message":"infomation estimation"}