Estimation Ecommerce External
POST {{url}}/moovinApiWebServices{{country}}/rest/api/ecommerceExternal/estimation
Allows to obtain the possible ways of delivering with its cost and delivery time.
Types of services
The type of service refers to the request required by the client. The following list details the services offered by Moovin, in order to request this service, send it with the parameter name * * serviceType * *
DELIVERY: this is the collection and delivery service to the customer.
REVERSELOGISTIC: this service refers to reverse logistics so that the customer can return the products that have been previously purchased.* * Note * *: if the parameter is not sent, the default service selected by the system is DELIVERY.
Status
SUCCESS: completed successfully.ERRORZONE: You are not within moovin's coverage zone.
ERRORDANGERZONE: The point is in a dangerous zone, so moovin does not deliver.
ERRORLISTPRODUCT: the list of products to be delivered is empty.
ERRORWEIGHT: if one of the products exceeds the weight allowed to transport, which is 45kg.
ERRORSIZE: if the package exceeds the dimensions allowed to be transported, this represents the largest package. (see table 1 Package size)
OUTCOUNTRYINMOOVIN: if the package is for international shipping, you must have the collection point in the corresponding terminal where the package will arrive.
ERRORDATAGEOLOCATION: Displayed in case geoposition data is missing either at the delivery point or the collection point.
OUTZONECOVERAGE: In case the indicated geoposition is outside the coverage area.
Note
Types of vehicles
The estimate can be requested for the following types of vehicles:
motorcycle
car
It is mentioned that this is not a mandatory parameter, it should only be included in particular cases.
For example, a cake, the product has the dimensions to be transported by a motorcycle but for some reason its transport must be by car.
Dimensions
In order to define the size it can be done under two conditions, specifying the size (see the Table 1 Dimension package), through the dimensions provided by Moovin or by sending the 3 parameters of the dimensions:
length: long
width: width
high: high
Note:
The products are combined with size and other assigning dimensions, the system will size the packages that have the size factor as shown in the Table 1 Dimensions package.
List of dimensions:
Acronym | Long (cm) | Width (cm) | High (cm) | Maximum weight (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 |
XXL | 240 | 100 | 35 | 25 |
Table 1: Dimensions package
Response parameters
- deliveryTime: it comes in hours. Indicates the maximum time in which the service will be performed.
The response provides two parameters that must be provided for when you want to execute the creation of the package which are::
idEstimation: refers to the estimate of the service you wish to request.
id: in each of the delivery options the id appears that must be sent when requesting the service so that the system identifies the shipping option.
deliveryTime: is the time in hours that Moovin has to deliver since it has collected the package. If the collection order was generated (Complete Order) in the Moovin system before 12 noon on a business day from Monday to Friday, the package can be delivered the next business day.
If the order is generated after 12am, the collection will be the day after receiving the notification and it will be delivered the next business day.location_type: It is an optional field to report the accuracy of the geoposition.
- ROOFTOP
- RANGE_INTERPOLATED
- GEOMETRIC_CENTER
- APPROXIMATE
Request Body
{"vehicle"=>"car", "pointCollect"=>{"latitude"=>9.929652, "longitude"=>-84.134719}, "pointDelivery"=>{"latitude"=>9.925903, "longitude"=>-84.058123}, "listProduct"=>[{"quantity"=>1, "nameProduct"=>"Samsumg", "description"=>"Galaxy S7", "length"=>2, "width"=>2, "high"=>2, "weight"=>0.1, "price"=>200000, "codeProduct"=>"234234234234"}, {"quantity"=>1, "nameProduct"=>"Samsumg", "description"=>"Galaxy S7", "length"=>2, "width"=>2, "high"=>2, "weight"=>0.1, "price"=>200000, "codeProduct"=>"234234234234"}], "ensure"=>true}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
token | string |
RESPONSES
status: OK
{"optionService":[{"id":1,"amount":2500,"type":"route","deliveryTime":24}],"idEstimation":130,"status":"SUCCESS","message":"infomation estimation"}