Logistics API??

Hello ,

Does Logistics API support to pick Geo-fence name as address (without having to send y,x geo coordinates ?)

Hello Sets ,

Thank you

We use order "Update" as described here

https://sdk.wialon.com/wiki/en/sidebar/ … der/update

Will it be possible same method as you described above ? We tried with Geofence name as address and without sending y/x , it returned with an error.

Thanks for advice .
Will try the method that you have advised to try.

Hi there

We are going to integrate an ERP system with Wialon and Logistics. Regarding Wialon we have enough experience with Remote API but we have
some problems with Logistics API.

1. The scenario is to retrieve Lat, Long, Weight and Volume from orders inside ERP system, create Orders via API call and then distribute them among vehicles. Important case here is that we don't want to assign any order to any Unit (vehicle) and we want the system itself calculate how many vehicles is needed to carry orders and distribute them. Would you please kindly share the steps we have to do step-by step to implement this scenario?

2. Please let us know what is difference between Optimize order execution and  Create, delete route?

3. What is function of Complete orders from history?

If someone from GT explain the whole concept of Logistics API in 4-5 line here it will help me. I know we should create orders and then execute a command to distribute them but History, Route and such words are not clear for me in term of using Logistics API. Also, we expect Logostics API to choose vehicles itself, is it possible? My question here is that if we assign orders to vehicles what exactly the application optimize?

sets, thank you for your help.

As I understood Route is using the Wialon Route module, right?
How we should get online delivery status of distributed orders? (I mean after vehicles start their routes)

Also please provide me more information about tt and tf parameters.
Flags 0x20 and 0x40 are clear for me but I can't understand other flags algorithm. Give me some explanation about them also.
Can we sum flags like 0x20 + 0x40 to ask server optimize orders based on Weight and Volume together? (or other flags)

sets, I can't understand the Route, After we optimize order, then why we need to create that? Please explain for me. Give me a example.
May you also tell me about assigning of units to orders? What is reason of that while you say Logistics automatically selects units and optimize them.

hhamedk
i created example, see there  https://codesandbox.io/s/route-from-fixed-orders-42kwm
This example include optimization and route creation, you need put params sid, unit_id(array id), and resource id

sets, Thank you for your help.

Would you please explain below parameters with real examples? The documentation description is not enough for us to understand them. also seems that some of these parameters are optional based on callMode but documents doesn't say anything about this case that those are optional. Please inform me which ones are optional:

ORDER CREATE/UPTADE

"oldOrderId":<long>,    /* old oreder id */
"oldOrderFiles":[<text>],     /* old order files array */
"uic":<text>,      /* number of shipping document */
"cid":<text>,      /* custom ID */
"cm":<text>,       /* comment from confirm/reject */
"aff":<text>,      /* [ warehouse ] list of unit ID's of warehouse ("123,456") */
"z":<text>,        /* [ warehouse ] list of geofences of warehouse ("resId_geofenceId,...") */
"tags":[<uint>]    /* order tags */   >>>   Explain its functionality
"rp":<text>,        /* order route */
"dp":"[<uint>,..]" /* array of dependent orders IDs */

I understood the Route, But I can't understand while we are creating a order why we should pass Route

"r": {        /* route infotmation */
                 "id":<text>,        /* route id */
                 "i":<text>,        /* number [0..] */
                 "m":<text>,        /* mileage from previous point according to the plan, m */
                 "t":<text>,        /* time from previous point according to the plan, s */
                 "ndt":<uint>,      /* time to notify customer before assumed delivery time, s */
                 "vt":<text>        /* visit time according to the plan, UNIX_TIME */
},

Regarding flags of order I need explanation for below ones:

0x4     start warehouse;
0x8     final warehouse;
0x10     reload warehouse
0x20     fixed order 

ORDER OPTIMIZATION

"orders":[<uint>,{JSOn},...],   >>>   I understand it, just to be sure, we should pass orders ID we want to optimize separated with comma? Whats the meaning of "orders indexes/orders JSON delimited with comma"?
"warehouses":[<uint>],   >>>   is it optional? what is its function?

Is GIS parameter and its sub-parameters optional while we are using Gurtam map?

I don't understant these at all:

"busyRoutes":{
                   "<uint>":[
                   {
                       "tf":<uint>,
                       "tt":<uint>,
                       "pf":{<uint> || {JSON}},
                       "pt":{<uint> || {JSON}
                   },

"priority":{<uint>:{<uint>:<uint>},...},

while we have set orders priority in creation of that why we should pass priority here?!!!

"preference":{<uint>:<uint>,...}}

Regarding optimization flags please explain each flag in details.

Thank you for your help and detailed explanation in advance.

The First of all
property p - it is custom JSON, if need you can put your own params for your logic

these params filling after optimization in app "logistics". You can open dev tools in your browser and will see that.
method svc=order/route_update with callMode = 'create' and list of orders (JSON)
i wrote that in "i created example, see there  https://codesandbox.io/s/route-from-fixed-orders-42kwm"

sets, thank you for your post.

We won't touch it, but let us understand it. We are going to develop an application based on Logistics API and we have to understand each parameter very well. We should know everything before starting development. (My brain says "If that's really useless why they put it there?!! It should has some function")

My exact question is that why we should pass it in time of creation of order, nothing else.

What will we gain when we pass these parameters in time of creation of an order?!

What the hell! You have some useless parameters and you also reflected them in your documents?! (BTW, if cid is a custom ID we can set for order except the ID of order in Logistics app as I guess, then that's really useful for my case)

Tell me where in this file I can get more data than what you have shared or provided in SDK docs.

If you mean property r, As I understood you mean we can pass these parameters to server to tell server consider these limitations while optimizing orders, right?

Thank you but I don't need your sample code, I need description of parameters. (BTW, I changed your code to work with our WL but doesn't work or I'm not able to use it)

If I got you correctly we can NOT to create orders BUT pass these orders via vc=order/optimize command and ask system to optimize them for us, right?

Please someone read my previous post and explain them one by one.

hhamedk
You have tons of questions, but most of them not HOW to use API, but WHY API work like this.

>  I can't understand the Route, After we optimize order, then why we need to create that?
>  I can't understand while we are creating a order why we should pass Route
>  while we have set orders priority in creation of that why we should pass priority here?!!!
> My exact question is that why we should pass it in time of creation of order, nothing else.

The only answer to this WHY questions I can give you - it's because of server architecture. And I don't want to discuss is it good or not. It works. And moreover, Wialon Remote API (you're familiar with it, right?) works in the same way - you have to pass all the parameters in requests (for example, https://sdk.wialon.com/wiki/en/sidebar/ … date_zone) even if you don't understand them.

Same logic works with logistics API. When you want to update any field of order you have to pass all other (even if you already set them during creation). Simply saying - server will rewrite order in DB with all data from request. That is why you have to add all order properties.

Another important question is why route information saved in order. It's just a child-parent pattern. You can create parent and add list of child too it (then parent will know all its children) OR you can create child and save parent info in it (so every child will know its parent). Logistics works in the second way, each order have info about route.

The last thing I want to say - I strongly believe, you can repair car not knowing how it's engine works somewhere inside and you can develop APP for YOUR needs with YOUR business logic not knowing meaning of every parameters.

Please tell us what you're going to develop and we'll tell you HOW it can be done with logistics API. That's we can do)

Thanks!

P.S. I believe the right question is the key to get right answer. Try to ask HOW, not WHY

Hi
We need to get information of all the active / planing routes / fulfilled route information ,
purpose is to update customer's commerce platform's order status accordingly ,

Order -
ETA -
Assigned vehicle  -

anyway to get this information ?