This repo contains a Linx 6 solution that shows how you can consume the Cartrack API. Use this solution as a base for your Cartrack integration. Add your system integration and uses the pre-created functions to interact with the Cartrack API. It makes use of a REST call to call the web service with a JSON body (handled by Types). The result is a JSON object that can be manipulated and consumed by other Linx functions or processes. The solution was made to be generic enough so that it will only call the endpoints and use them as you need to in your integration project.
You can download this sample and manipulate it to suit your integration using Linx 6.
You will need the Linx 6 Designer, get it here
The solution also makes use of two Settings that you will need to set:
-
CarTrackBaseURL: Set the base URL for the Cartrack API, this is preconfigured
-
CarTrackToken: Your CarTrack Token
-
CarTrackUser: Your CarTrack User
All authentication details (Token and User) are placed in the settings.
The solution has 4 main functions:
This function will get all drivers. It works by calling the drivers endpoint. It will return a list of drivers.
This function will get a list of Jobs based on input dates. The function has two parameters:
- Created_From: This is the date that the order was create, and the filter will be applied on the API to filter only orders from the specified date. It is sent in the filter[ create_ts_from ] query parameter
- Created_To: This is the date that the order was create, and the filter will be applied on the API to filter only orders to the specified date. It is sent in the filter[ create_ts_to ] query parameter.
The date filter is applied between the two entered dates.
It works by calling the jobs endpoint. It will return a list of Jobs.
This function will get a specific job based on the JobID. The function has an input parameter for the JobID. It works by calling the jobs endpoint.
This function will create a new Job. It has a type input parameter that will require you to input all delivery information, use the CarTrackDelivery type to know what fields are to be added. It works by calling the jobs POST endpoint. It will return a list of Jobs.
For questions please ask the Linx community.