Home/ Api / TRM

Overview

Tranzlogix aggregate Logistics data across Carriers, ELD Devices, Brokers, Shippers in US Transport market on line lively and thereby enables smart and smooth management of Load and delivery in time.
Tranzlogix have developed API and UI Interface that can readily integrate with Brokers, Carriers and Shippers through web service for exchange of information for this purpose.
This Interface enables Shippers, Brokers to get connected with carrier for their Load booking and Tracking information online.
Basically Tranzlogix already have online exchange of ELD device log information like GPS Tracking data, DVIR, HOS, Drivers, Vehicle, ELD Device with most of the popular ELD vendors in the US market and readily developed platform for integration.
The Shippers, Brokers and Carriers are get registered with Tranzlogix Truckergig portal and thereby get API authentication code. This API authentication code uniquely identifies the Shippers, Brokers and Carriers in the System and used for subsequent service call and interaction with Tranzlogix.
When Shipper or Broker Book a Load with Carrier, they can in parallel Identify the carrier in Tranzlogix Truckergig system and upload the Load information through UI interface or through API call.
On getting the Load and Carrier Information the Truckergig system get connected with the carrier and get the Driver or Vehicle assigned to the Load by Mapping the Driver ID or Vehicle ID to the Load Number.
Actual transaction between Shippers and Carriers or Brokers and Carriers happen in off line and the reference to these Transactions are tracked in Tranzlogix Truckergig

Location by Vehicle ID

Location by Vehicle ID http://52.71.173.153:7080/api/v1/trackingdataresource/trackvehicle
Description Through Load Reference, now Shippers and Brokers can get their Load Tracking Information like as on time the GPS Location, History, Direction, any event information, remaining HOS, speed, duty status etc. on line
Method POST

Request Parameters

Name Type Size Description
VehicleId String 10 Vehicle Identification No.
TypeOfId String 100 Any of these types(Vehicle ID/VIN/DriverID/Licenseplate)
ELD String 100 Name of the ELD

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
TrailerId String Trailer Id
DeviceId String Device Id
Date String Date
DateUTC String DateUTC
Latitude String Latitude
Longitude String Longitude
Location String Location of the Vehicle

JSON request example:

Based on VIN
[
 {

"id" : "3HSDJAPR2EN532550",
"idType" : "VIN",
"eld"  : "Telogis"
  }
]
Based on DeviceId
[
  {
"id" : "1240045411",
"idType" : "DeviceId",
"eld"  : "Telogis"
  }
]

JSON response example:

[
{
 "trailerId": null,
 "deviceId": "1208389197",
 "date": "2019-03-06T20:05:10",
 "dateUTC": "2019-03-06T20:05:10",
 "latitude": "35.0131803758848",
 "longitude": "-85.2770641611257",
 "location": "US|37407|Tennessee|Chattanooga|8th Ave"
}
]

Create Carrier in TruckerGig

Create Carrier in TruckerGig https://truckergig.com/loadapi/v1/carrier/
Description Broker or Shipper shall create a Carrier for their Load in Tranzlogix System through this service.
Method POST

Request Parameters

Name Type Size Description
Name String 50 Carrier Name
SCAC String 10 Standard Carrier Alpha Code
MC String 10 MC number is for all other carriers and brokers
MX String 10 MX Number is assigned to carriers domiciled in Mexico
FF String 10 Freight Forwarders Number
Contact Object Contact Info
Name Type Size Description
street_address String 50 Street Address
postal_code String 5 Postal Code
city String 25 City
country String 2 CountryCode
phone String 10 Phone Number
email String 50 Email

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
Carrier SCAC Object Standard Carrier Alpha Code

JSON response example:

[
    { 
    "Status":"Success", 
    "Carrier SCAC": "by673" 
    }
]

Choose Valid Carrier

Choose Valid Carrier https://truckergig.com/loadapi/v1/carrier/{scacid}
Description Broker or Shipper can check or choose a Carrier for their Load in Tranzlogix System through this service.

The Carrier is identified by SCAC code in Tranzlogix Truckergig, If the valid code is found in the system this service will return the details of the Carrier there by the chosen carrier is validated.
Method GET

Request Parameters

Name Type Size Description
SCAC String 10 Uniquely identify the Carrier. Standard Carrier Alpha Code.

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
Carrier String Carrier Name
CarrierInfo Object Carrier Information
Name Type Size Description
street_address String 50 Street Address
postal_code String 5 Postal Code
city String 25 City
country String 2 CountryCode
phone String 10 Phone Number
email String 50 Email
CarrierCode Object Carrier Code
Name Type Size Description
name String 50 Carrier Code Name
value String 5 Carrier Code Value

JSON response example:

[
    { "Status":"Success", 
      "Carrier": "Amex_Trucking_company", 
      "Carrier_Info":{
           "street_address":"Teststreet 10 A 34",
            "poatal_code":"70100", 
            "city":"Kuopio", 
            "country":"FI", 
            "phone":"0401231234",
             "email":"example@example.com" 
         } , 
      "Carriercode":[ 
          { "name":"SCAC#", 
            "value":"1234" 
          }, 
          { "name":"MC#", 
            "value":"MAZS92A004"
           }, 
           { "name":"MX#", 
             "value":"1234" 
           }, 
           { "name":"FF#",
             "value":"1234" 
           }
        ]
    }
]

Assign Load to Carrier in TruckerGig

Assign Load to Carrier in TruckerGig https://truckergig.com/loadapi/v1/assignLoad/
Description Broker or Shipper shall be able to assign a load to the carrier already been created in the Truckergig CRM.

The Carrier is identified by SCAC code in Tranzlogix Truckergig and the Load is identified by the Load Number..
Method POST

Request Parameters

Name Type Size Description
SCAC String 10 Uniquely identify the Carrier. Standard Carrier Alpha Code.
LoadNumber String 10 Load Number
LoadNumber_Date String 10 Load Number Date
PO String 10 Purchase Order Number
PO_Date String 10 Purchase Order Date
BOL String 10 Bill Of Lading Number
BOL_Date String 10 Bill Of Lading Date

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
Carrier SCAC String Carrier SCAC
Load Number String Load Number
Load Number Date String Load Number Date

JSON response example:

[
    { 
      "Status":"Success",
      "Carrier SCAC": "by673", 
      “LoadNumber”:” MAZ6732309”,
      “LoadNumber_Date”: ” 15-12-2018” 
    }
]

Get Assigned Load to the Carrier

Get Assigned Load to the Carrier https://truckergig.com/loadapi/v1/assignLoad/{scacid}/{loadnumer}
Description On executing the Purchase Order, Bill of Lading with the carrier the details of the Load with PO, BOL or Load Number reference can be uploaded to the Truckergig through UI or API interface. This service will get the details of the Load and the carrier mapping information.
Method POST

Request Parameters

Name Type Size Description
SCAC String 10 Uniquely identify the Carrier. Standard Carrier Alpha Code.
LoadNumber String 10 Load Number

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status Object Load Status
Name Type Size Description
Code String 5 Carrier Code
Description String 100 Description of Loads
Load Info Object Load Information
Name Type Size Description
Miles Integer 10 Miles
Weight Integer 10 Weight
Quantity Integer 10 Quantity
Commodity String 50 Commodity
Equipment Type String 10 Equipment Type
Temprature String 10 Temprature
Length Integer 10 Length
Width Integer 10 Width
Height Integer 10 Height
Pickup Object Pickup Details
Name Type Size Description
From String 50 Carrier Code
EarliestTime String 30 EarliestTime
LatestTime String 30 LatestTime
Delivery Object Delivery Details
Name Type Size Description
From String 50 Carrier Code
EarliestTime String 30 EarliestTime
LatestTime String 30 LatestTime
Load Reference Object Load Reference
Name Type Size Description
name String 50 Load Reference Name
Value String 50 Load Reference Value
Broker Info Object Broker Information
Name Type Size Description
Broker String 50 Broker Name
Company Phone String 10 Broker Company Phone
Company Fax String 10 Broker Company Fax
Agent Name String 50 Agent Name
Agent Phone String 10 Agent Phone
Agent Fax String 10 Agent Fax
Address String 10 Broker Address
Name Type Size Description
Street_address String 100 Street Address
Postal_code String 5 Postal Code
Carrier Info Object Carrier Information
Name Type Size Description
Carrier String 50 Carrier Name
Phone String 10 Carrier Phone
Fax String 10 Carrier Fax
Contact Name String 30 Contact Name
Dispatch Email String 30 Dispatch Email

JSON response example:

[
    {
      "Status":{
            "Code":"", 
            "Description":""
       } , 
       "Load_Info":{ 
            "Miles":"975",
             "Weight":"2400",
             "Quantity":"25", 
             "Commodity":"Floor Loaded Mattresses", 
             "Equipment Type":"Van",
             "Temprature":"", 
             "Length":"", 
             "Width":"", 
             "Height":"", 
             "PickUp":{
                "From":"1676 Montgomery Hwy. Dothan, AL 36303", 
                "EarliestTime":"11/10/2018 07:00",
                "LatestTime":"11/10/2018 08:00" 
              },
             "Delivery":{
                "To":"7402 Hodgson Memorial Ste 105 Savannah, GA 31406", 
                "EarliestTime":"11/10/2018 07:00",
                "LatestTime":"11/10/2018 08:00"  
              } ,
             "Load_Reference":[ 
                {
                 "name":"PO", 
                 "value":"1234"
                }, {
                 "name":"BOL",
                 "value":"MAZS92A004" 
                }, { 
                  "name":"BOL_Date",
                   "value":"15-10-2018" 
                }, { 
                  "name":"LoadNumber", 
                  "value":"MAZS92A004"
                }, { 
                  "name":"LoadNumber_Date", 
                  "value":"15-10-2018" 
                }
              ],
             "Broker_Info":{
                "Broker":"Blue Star Logistics",
                "Company Phone":"(800)-666-7200",
                "Company Fax":"(888)-611-8954", 
                "Agent Name":"Corey Hardee", 
                "Agent Phone":"(260)-755-4389",
                "Agent Fax":"(000)-000-0000",
                "Address":{
                    "street_address":"875 Old Roswell Road Suite $G-300 Roswell GA",
                    "poatal_code":"30076"
                 },
                "Carrier_Info":{
                    "Carrier":"On Time Transport LLC",
                    "Phone":"(402)-328-9082",
                    "Fax":"25", 
                    "Contact Name":"Stephen",
                    "Dispatch Email":"example@example.com" 
                }
            }
]

Assign Vehicle/Driver/Device to the Load by Carrier in TruckerGig

Assign Vehicle/Driver/Device to the Load by Carrier in TruckerGig https://truckergig.com/loadapi/v1/assignVehicle/
Description Carrier shall be able to assign his load to the Vehicle or Driver or Device in the Truckergig CRM.
The Carrier is identified by SCAC code in Tranzlogix Truckergig and the Load is identified by the Load Number. Carrier can link the load to his Vehicle or Driver or to the tracking device..
Method POST

Request Parameters

Name Type Size Description
SCAC String 10 Uniquely identify the Carrier. Standard Carrier Alpha Code.
LoadNumber String 10 Load Number
LinkBy Integer 1 LinkBy 0: by vehicle 1: by Driver 2: by Device
AssertId Integer 10 The assetId shall be the corresponding asset Id of the Vehicle or Driver or the Device in the system.

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
Carrier SCAC String Carrier Code
Load Number String Load Number
AssetId Integer The assetId shall be the corresponding asset Id of the Vehicle or Driver or the Device in the system.

JSON response example:

[
    { 
        "status":"Success",
        "carrier SCAC": "by673", 
        “loadNumber”:” MAZ6732309”, 
        “assetId”: ” 9612303” 
    }
]

Get Vehicle/Driver to the Load

Get Vehicle/Driver to the Load https://truckergig.com/loadapi/v1/getVehicle/{scacid}/{loadNumber}
Description Through ELD Integration channel of Tranzlogix the Carrier can Identify their Driver and Vehicle in the Tranzlogix and can readily Map the Load reference to the assigned Driver or Vehicle. This request been sent to the Carrier and shall get the Driver or Vehicle Reference.
Method GET

Request Parameters

Name Type Size Description
SCAC String 10 Uniquely identify the Carrier. Standard Carrier Alpha Code.
LoadNumber String 10 For the Carrier code the Load Number may be PO Number or BOL Number. Which Identifies the Load

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
Person Id Integer Person Id
Assign Date String Assign Date
Driver Name String Driver Name
Co-Drivers String Co-Drivers
CarrierId String CarrierId
Carrier Name String Carrier Name
Carrier Address String Carrier Address
Home-Terminal-Address String Home-Terminal-Address
Truck Object Truck
Name Type Size Description
Truck-id Integer 50 Truck-id
Vin_number String 30 Vehicle Identification Number
license String 30 license plate no
Device Object Device
Name Type Size Description
Device-id Integer 50 Device-id
Device_type String 30 Device_type
SSID String 30 SSID
Load Reference Object Load Reference
Name Type Size Description
Name Integer 50 Load Reference Name
Value String 30 Load Reference Value
Trailers String Load Reference Value
Shipments String Shipments
Remarks String Remarks

JSON response example:

[
    { 
      "Status":"Success",
      "person-id": "1", 
      "assign_date": "2014-05-23",
      "driver-name": "Lee Payne",
      "co-drivers": "Dan Collens", 
      "carrier_id":"89T633",
      "carrier-name": "Renegade Trucking",
      "carrier-address": "1401 Russell St, Baltimore, MD, 21230", 
      "home-terminal-address": "123 Another St", 
      "truck": {
          "truck-id": "22",
          "vin_number": "133iOS", 
          "license": "ALYJ 633"
       }, 
      "Device": { 
          "device-id": "22",
          "device_type": "133iOS",
          "SSID": "ALYJ 633"
       },
      "Load_Reference":[ {
          "name":"PO", 
          "value":"1234"
         },
         { "name":"PO_Date",
          "value":"12-10-2018" 
         }, 
         {"name":"BOL", 
          "value":"MAZS92A004"
         },
         { "name":"BOL_Date",
           "value":"15-10-2018" 
         },
         { "name":"LoadNumber",
           "value":"MAZS92A004"
         },
         { "name":"LoadNumber_Date",
           "value":"15-10-2018" 
       } ],
     "trailers": "4127 ",
     "shipments": "Q109A88667",
     "remarks": "Extreme weather caused unusual delay on this date.", 
 }
]

Start Tracking the Load.

Start Tracking the Load. https://truckergig.com/loadapi/v1/starTracking/
Description Broker, Shipper and Carrier shall be able to trigger or initiate the tracking of the Load. By default, the tracking data will not be available and exposed unless this service is called in the Truckergig CRM.
The Carrier is identified by SCAC code in Tranzlogix Truckergig and the Load is identified by the Load Number.
Method PUT

Request Parameters

Name Type Size Description
SCAC String 10 Standard Carrier Alpha Code.
Load Number String 10 If the Load and the Carrier are assigned to the Vehicle, then this service will initiate the tracking.

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
carrier SCAC String carrier SCAC
Load Number String Load Number
assetId Integer assetId

JSON response example:

[
{ 
    "status":"Success", 
    "carrier SCAC": "by673", 
    “loadNumber”:” MAZ6732309”, 
    “assetId”: ” 9612303” 
}
]

Stop Tracking the Load.

Stop Tracking the Load. https://truckergig.com/loadapi/v1/stopTracking
Description Broker, Shipper and Carrier shall be able stop or hold the tracking of the Load. By default, the tracking data will not be available and exposed unless the start tracking service is called in the Truckergig CRM.
Once again this stop Tracking service can stop tracking the Load and the tracking data will not available to view.
The Carrier is identified by SCAC code in Tranzlogix Truckergig and the Load is identified by the Load Number..
Method PUT

Request Parameters

Name Type Size Description
SCAC String 10 Standard Carrier Alpha Code.
Load Number String 10 If the Load and the Carrier are assigned to the Vehicle, then this service will initiate the tracking.

Response Codes

HTTP Status Code Description
200-OK Successful
201-Created Created
400-BadRequest Bad input parameter. Error message should indicate which one and why
401 Unauthorized The client passed in the invalid Auth token. Client should refresh the token and then try again.

Response Parameters

Name Type Description
Status String Whether the request is Success/Fail
carrier SCAC String carrier SCAC
Load Number String Load Number
assetId Integer assetId

JSON response example:

[
{ 
    "status":"Success", 
    "carrier SCAC": "by673", 
    “loadNumber”:” MAZ6732309”, 
    “assetId”: ” 9612303” 
}
]