There are two Project44 Apps:
Project44 Carrier - this is used for when you need to send data to a customer who is using Project44, and you are their "Carrier"
Project44 - this is used if you use Project44 for visibility and need to sync the P44 tracking to Chain
Project44 Carrier App
If you need to send data to your customer who is using P44, follow the steps highlighted here.
What you will need:
The customer's P44 account will issue you a login and password for p44.
Log in to Project44 using the issued credentials to verify they work
Your Project44 invite or rep should have provided you with a
Customer ID, you will need this to enable the Chain Project44 Carrier AppYou will also need to know how the customer identifies their load numbers in P44, either by
ORDERorBOL.Next, go to your Chain workspace. If you have a model where you have multiple workspaces, you must go to to Enterprise workspace
Go to the workspace's Settings > Apps
Search for "Project 44 Carrier"
Click Enable
Enter the P44 username and pw, the Customer ID issued to you by Project 44
Then enter the customer's unique ID from your TMS. You should be able to find this in the customer's page in your TMS. If you're unsure, ask support@trychain.com
Select your customer's identifier for the load in P44, and then click "Enable"
That is it. If you need to add more customers in the future, you can click "Update" on the enabled app and click the "Add more" button
Project44 App to connect P44 tracking to 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
}
]
//...
}