Technical Interfaces
What all APIs does Freight Tiger have?
What are Webhooks?
Webhooks are automated messages sent from apps when something happens. They have a payload which is sent to a unique URL.
Can FT send the webhooks data in our format?
We have standard contracts for all the webhooks documented on swagger as mentioned above. These are standard across all the customers and cannot be customised.
Do we support data in XML format?
No, we do not support XML format. We only accept JSON format.
In what format do we need to send the data to your APIs?
JSON format.
Do you have web-services?
Yes, we have REST APIs.
What frequency can the data be pushed to our server?
We have event based webhooks, which will be triggered as and when the respective event occurs. These are event dependent and cannot be configured for certain frequency.
Do you have EDIs?
No, we have REST APIs.
What are the merits of v2 over v5 ?
v2 was GET API, v5 is POST API. Some new functionalities - Routes, Waypoints, Invoice Details, some fields set to default - Driver Name, Location Source."
I have OTMS - How can i integrate with FT ?
Details from the OTMS will need to be passed in the Add Trip API.
What are the websites that ought to be whitelisted in order for the visibility module to work seamlessly at the customers end?
Google Analytics
New Relic which is at pod level : http://newrelic.com , bam.nr-data.net
Cloudfront : cloudfront.net
Sentry : browser.sentry-cdn.com
Google Maps : googleapis.com
Zoho : Zoho.com
Trip Creation
When should i create trips?/ At which milestone ?
You can identify a milestone in your process - this could be Plant GateIn/GateOut. We recommend Gate In so that all the loading analytics are captured.
What details do you need for Trip creation ?
The mandatory details needed for a Trip Creation are - Vehicle Number Origin Destination Driver Number"
At what level should I create a trip - Shipment level/ DO level/ Invoice level?
Invoice level
Which details should be sent during trip update ?
Any details to be added/modified in the Trip details can be passed in the Trip Update API.
Trip creation has a lot of parameters which are not used in our logistics solution. For example parameters like consignee, shipment_number, invoice and tax details etc.So, can we pass null values for them in the API method. Will API accept null data for these parameters.
You can choose to not pass these parameters at all.
Driver
Why does FT require driver number ?
If the tracking location source is SIM/Driver Phone then we need the driver number for the same.
Why does FT require driver number if the vehicle is being tracked through GPS ?
Driver number is a mandatory information needed for Trip Creation. It can also act as a fallback for location source in case gps isn't working.
We do not capture driver details in Dispatch information in SAP? How can I still create a trip ?
You can create a trip by passing dummy value in the Driver Number field. Use update API to add the driver details later when you have these details. You can also add this information in your SAP.
Business Data Mapping between ERP and FT
How the system will map LR number to PO/ DO.
The FT Trip will consist of all this data on the trip together for your reference. This data will also be available for you to download in the format of .csv reports.
I want to pass Invoice details - How can they be sent ?
These can be passed in the Add or Update Trip API
Do you have header and line item level structure ?
Yes
Consignee
I do not have lat longs for my Consignee addresses to send in the add trip payload
You can onboard all the Consignee addresses with us along with the unique consignee id, display name and we will get the lat long for these addresses. Next time when you create a trip you only have to provide the consignee code while creating the trip
Why do you need Consignee details?
We do not want to disclose Consignee details Consignee details are not mandatory in a Trip.
Is it okay if we do not provide you Consignee details ?
Yes. Consignee Details are optional.
Uncategorised Questions
Can FT send data back to my ERP or CRM?
OR
Does FT have webhooks/callbacks to push information back to our systems?
Yes, please refer to our standard webhook contracts for more details:
How do we compute ETA?
We set a average truck speed based on the industry type, Once we get the location from the device, ETA is update based on the distance left from destination and the avg speed set
I have multi-drop scenario - How does the API accommodate it?
We do not have support for multi-drop scenario today. We have waypoints which can be added between an origin and destination of the Trip. A waypoint can be a scheduled pickup / drop or a checkpoint in a route. Once the waypoint is given in a trip all the distance and ETA computation will happen based on the route from Origin To Waypoint To Destination
I want to know whether a vehicle which does gate entry has a GPS or not? Is it possible ?
We have an API for the same:
POST https://integration.freighttiger.com/saas/data/vehicle/gpsStatus"
Is trip update mandatory ?
Nope.
I need some additional business logics to be added during integration - How can you help me ?
We have standard list of APIs with pre defined logics.
Is there any android app available for freight tiger?
Yes, you can download them from Google Play Store.