Enable Project44 in Chain
If you are using project44 for truckload visibility, you can connect your project44 account to Chain to sync tracking from project44 with either shipments you have in Chain or if you are assigned shipments from your customers or network.
Once you enable the Project44 app, the next time you create a shipment or you are assigned to a shipment, Chain will check if that shipment is tracking in Project44. If it is, the shipment will automatically start feeding tracking data and update the shipment's location.
Enabling project 44
To enable the Project44 app on Chain, you need to do two things:
Enable the app in your workspace settings page with a project43 username and password of an admin account
Assign 2 roles to Chain in your project44 dashboard, under users.
Once you are done with step 1, head over to your Project44 account and go to the users page. You can use this lint or follow the instructions below:
1. Go to user-management inside of project44
Log in to your project44 account (with an Admin login), and then click "9 dots" at the top right, and select USERS
2. Find the newly created Chain user, and click edit.
You can also search for "chain-app" if you have trouble finding it.
3. Add "Customer Admin", "Truckload Visibility API" and "Developer" roles
Under "Roles", add "Customer Admin", "Truckload Visibility API" and "Developer" roles, click ADD and then SAVE on the top right
Once you add the roles, they will appear under "Assigned".
4. Make sure to click SAVE at the top right
Once you add the roles, they will appear under "Assigned". Then click SAVE at the top right. And that is it, you are all set with setting up the project44 app in your Chain account.
Additional info
If you delete the client app user or edit the name, it may impact the app integration. You can, however, change the Roles as shown above.
Unfortunately, project44 doesn't offer the ability to add "Roles" via API, so this step is manual due to that limitation.
How tracking is shared
If you have the project44 app enabled on Chain, you are now ready to share tracking with your customers that are using Chain.
Once you are added as a participant on a shipment in Chain, you will need to add the Shipment or Load number of your customer in the BOL Number or Order Number fields in project44.
For example, if your customer's Shipment or Load Number is "L221100-00111", here is how you would set this up in project 44:
Using the p44 portal
In the p44 portal, click ADD SHIPMENT
After entering the carrier details, click next
Under BOL Number or Order Number, enter the customer's load number. In our example, this would be: L221100-00111
That is it, Once the shipment starts tracking in p44, every location event will be updated in Chain as well.
Using the p44 API
If you are a developer and have integrated the creation of loads in p44 via API, you need to feed the customer's Shipment or Load Number using the p44 API. See p44 truckload tracking api docs.
In reference to the p44 docs, in the POST /api/v4/tl/shipments end-point, make sure to include the customer's Shipment or Load Number in the "shipmentIdentifiers" property in the JSON request. For example, if the customer's shipment number is "L221100-00111", you could add it in either of the two options below (only one is needed).
{
//...
"shipmentIdentifiers": [
{
"type": "BILL_OF_LADING",
"value": "L221100-00111" // You can use BILL_OF_LADING or ORDER
},
{
"type": "ORDER",
"value": "L221100-00111" // You can use BILL_OF_LADING or ORDER
}
]
//...
}