FAQs: Update Truckload Shipments
You can make the following updates to truckload shipments:
-
Changes to stop information (address, hours of operation, etc.) of future stops, so the driver has not yet been in the geofence of the stop being updated.
-
Adding equipment identifiers like vehicle ID or license plate number
-
The equipment identifier array is an append, not a replace. All new vehicle IDs should be added to the equipment identifiers array.
-
Add shipment attributes
-
Change appointment windows
Updates or changes CANNOT be made to: BOL, Order Number, Carrier ID. To change these, utilize a DELETE request and then re-create the shipment with the new information.
You can make updates to truckload shipments through project44’s API:
-
First, utilize the GET Shipment API Call to retrieve current details about the shipment.
-
Then, update any allowed changes, which include:
-
Changes to stop information of future stops– addresses, hours of operation
-
Appends to equipment identifiers – vehicle ID, license plate, mobile number
-
Shipment attributes
-
Appointment windows
-
Stop information
-
-
Submit shipment with the PUT request to update. The project44 ID will stay the same during this process.
You can also make updates to truckload shipments and shipment locations in the VOC shipments and shipment locations.
To make edits to a shipment:
-
Go to TRACKING, then select SHIPMENTS.
-
Choose the shipment you want to update from the list, and select it.
-
Select EDIT in the top, right-hand corner of the SHIPMENT DETAILS page.
-
Make the edits.
-
Select SAVE.
To edit a location:
-
Go to LOCATIONS.
-
Choose the destination you want to update.
-
Make the updates by selecting EDIT in the top, right-hand corner.
-
Select SAVE.
Carrier frequency could be low because for a couple reasons:
-
If the carrier is sending in updates every 15 mins but the truck has not moved, project44 will not register that as a new update.
-
The carrier can only receive 30 min updates from their tracking system. This is common if the carrier uses a MacroPoint solution.
This is not an error of the system.
Why did I only receive two updates for a shipment and never received updates along the shipment route?
Potential reason: The carrier has brokered the shipment to a 3rd-party carrier and they receive updates from Check Calls or only require the 3rd-party to check-in when the shipment is picked up and delivered.
Solution: The industry is going through an evolution of technology. Make sure you have an open discussion with your carriers on expectations for when they decide to broker a shipment and how that impacts performance from a shipment visibility perspective.
Use one of the two DELETE API requests:
-
DELETE: Delete truckload shipment by shipment identifier. This request requires a shipment identifier (e.g. Bill of Lading or Order Number) to delete an existing truckload shipment.
-
DELETE: Delete truckload shipment by unique system id. This request requires a shipment’s project44-generated ID to delete an existing truckload shipment.
You can also delete a shipment in the VOC by clicking DELETE at bottom of shipment details page.
This is the project44 shipment ID, or how we identify the shipment within our internal systems. We recommend you store this ID for future API calls (like when updating or deleting shipments).
The shipment status should read “delivered,” and the location ping should verify if the vehicle has reached the final stop for the shipment.
“Pending tracking method” means the shipment is missing valid equipment identifiers (truck number, mobile phone) in order to start tracking with the carrier.
To validate equipment IDs, use: GET: Validate equipment identifiers API
To add equipment IDs to a shipment/update shipment information to include equipment IDs, use: PUT: Update a truckload shipment API
You can work with your project44 implementation team to configure a tenant setting that allows you to initialize a shipment for tracking without the equipment identifier if all other required information is provided.
If using ELD or Mobile tracking: sometimes, using an invalid ID will still create a shipment. The response message will reveal an invalid vehicle ID in the API logs.