MacroPoint Integration {BETA}
Descartes MacroPoint is a visibility platform that has been integrated into the Shipwell platform to extend our existing end-to-end tracking and status updates on shipments. This integration offers real-time location tracking, current location, and estimated delivery time of freight.
Shipwell offers a seamless integration portal allowing users to connect their existing MacroPoint account to their Shipwell account, enabling communication to MacroPoint on those shipments that are leveraging the MacroPoint visibility options.
In order to use the MacroPoint Integration, you will need to connect with your Implementation Consultant or your Customer Success Manager to have this feature activated for your account. Once activated, follow the steps below to integrate your MacroPoint account into Shipwell.
Key MacroPoint Integration Features
Connect your MacroPoint and Shipwell accounts.
View MacroPoint tracking in Shipwell’s platform.
Benefits to using the MacroPoint Integration
Key Benefits to integrating your MacroPoint account into your Shipwell account include:
Real-time visibility into Macropoint shipments
Centralized visibility for all shipments within Shipwell
Reduced platform management
Setting up the MacroPoint Integration - Initial Connection
If you are interested in exploring this feature please reach out directly to your appointed Customer Success Manager (CSM), they will assist with next steps. Additionally, accessing Macropoint functionality in Shipwell may be subject to a additional annual fee, your CSM will provide additional details.
Once your account has been set up to use this feature, follow these steps to activate your MacroPoint account in the Shipwell platform:
Navigate to the Manage tab in Shipwell, select “Integrations”
This will take you to the Integration Marketplace. Here, you will see the MacroPoint card:
Select “Connect” under the MacroPoint Integration card:
Once selected, a new screen will open, you will enter your MacroPoint credentials here:
Click the “Validate” button to connect your MacroPoint account. Shipwell will validate your credentials with MacroPoint and establish a connection to your MacroPoint account. Successful connection will result in a green pop up confirming connection to your MacroPoint account:
NOTE: If connection is not established, an error will pop up. Please contact your Integration Consultant or Customer Success Manager for further assistance
Once connection is successfully completed, the MacroPoint card in the Integration Marketplace will show a green check mark in the top right corner of the MacroPoint card:
Using the MacroPoint Integration - Viewing Tracking
Shipwell will use your MacroPoint credentials to gather updates on shipments and pass that information into our existing visibility offering.
To view tracking and visibility updates on your shipments that are using MacroPoint for additional visibility, you can navigate to the Shipment Details for any shipment and select the tracking tab to view available breadcrumbs and tracking timeline cards.
MacroPoint FAQ
How do I connect my MacroPoint Account to my Shipwell account?
Contact your Integration Consultant or your Customer Success Manager to discuss having MacroPoint enabled on your account.
Once enabled, follow the steps listed here.
What if my connection attempt fails?
Contact your Integration Consultant or your Customer Success Manager.
Is the MacroPoint tracking real time?
Yes, Shipwell mirrors the configurations you have set in your MacroPoint account for tracking updates
Do I need to add MacroPoint tracking to each of my shipments?
No, when you connect your MacroPoint account, Shipwell checks each shipment against your MacroPoint account for tracking updates.
Can Shipwell set up a MacroPoint account for me?
No. You will need to contact MacroPoint directly to establish an account for truckload visibility with Descartes MacroPoint and obtain credentials from them. Once those credentials are available, connect with your
Integration Consultant and/or Customer Success Manager to get your MacroPoint account connected to your Shipwell account.
Why is my shipment not showing tracking?
Tracking will show once the shipment state has moved from “Tendered” to one of the following states: “Dispatched”, “At Pickup”, “In Transit”
If the shipment is in an “In Transit” state and tracking is still not visible, please proceed to the next step.
Check your MacroPoint Integration card. You should see a green check mark in the top right of the MacroPoint card. If you do not see that mark, click into the card and proceed to reconnect your account. See here for those steps.
If your card shows connected, please reach out to your Integration Consultant or your Customer Success Manager for further support.
How frequently is Macropoint tracking available?
Macropoint provides updates every 15 minutes.
Tive Integration {COMING SOON}
What is the Tive Integration feature?
Shipwell is excited to announce the upcoming integration of Tive IoT devices with our platform, enhancing our real-time shipment visibility capabilities. Tive’s advanced IoT sensors allow you to track not only the location of your shipments, but also their condition, such as temperature, humidity, shock, tilt, and other environmental factors. This new integration empowers you to proactively monitor and manage your shipments, ensuring on-time delivery and the integrity of sensitive goods, all from your Shipwell platform.
How does the Tive Integration feature work?
Shipwell offers a seamless integration portal allowing users to connect their existing Tive account to their Shipwell account as well as assign Tive devices to their shipments.
In order to use the Tive Integration, you will need to connect with your Implementation consultant or your Customer Success Manager to have this feature activated for your account. Once activated, follow the steps below to integrate your Tive account into Shipwell.
Key Tive Integration functionality
Connect your Tive account(s) to your Shipwell account.
Associate a Tive device to a Shipwell shipment.
View Tracking details from your associated Tive device on a Shipwell shipment, including:
Current Location card in the tracking timeline.
Breadcrumbs on Shipwell Tracking map
View and download Tive device data collected on a shipment
Benefits to using the Tive Integration
Key Benefits to integrating your Tive account into your Shipwell account include:
Real time visibility into shipments with attached Tive devices
Centralized visibility for all shipments within Shipwell
Streamlined device attachment through a single platform
Optimized shipping via accurate ETAs
Shipment condition updates from your associated Tive devices
Downloadable Tive device data
Setting up the Tive Integration - Initial Connection
If you are interested in exploring this feature please reach out directly to your appointed Customer Success Manager (CSM), they will assist with next steps. Additionally, accessing Tive functionality in Shipwell may be subject to a additional annual fee, your CSM will provide additional details.
Once your account has been set up to use this feature, follow these steps to activate your Tive account in the Shipwell platform:
Navigate to the Manage tab in Shipwell, select “Integrations”
This will take you to the Integration Marketplace. Here, you will see the Tive card:
Select “Connect” under the Tive Integration card:
Once selected, a new screen will open, you will enter your Tive credentials here:
Click the “Connect” button to connect your Tive account. Shipwell will validate your credentials with Tive and establish a connection to your account. Successful connection will result in a green pop up confirming connection to your Tive account:
NOTE: If connection is not established, an error will pop up. Please contact your Integration Consultant or Customer Success Manager for further assistance.
Once connection is successfully completed, the Tive card in the Integration Marketplace will show a green check mark in the top right corner of the card:
Using the Tive Integration - Attaching a device to a shipment
Once your Tive account is connected through the Integration Marketplace, Shipwell will be able to access available device details, including availability and configurations set up in the Tive platform.
Navigate to the shipment where the device should be added:
Navigate to the Shipment details screen. From here, you will select the “Actions” option on the right side menu:
The right side menu will slide out and you will see an option to “Manage Tracking Devices”, select that option to proceed to device attachment:
After selecting “Manage Tracking Devices”, a new window will open for device selection and attachment:
f you are integrated with Tive and no other IoT device provider, the window will default to Tive. Otherwise, you can use the drop down to select a different IoT provider.
In the “Device ID” selection box, you can either begin typing in the device ID, or you can use the drop down to select from a list. If you type in the box, there is a dynamic functionality that will reduce device options that match with what is being typed into the box. This helps to reduce input error.
Once the device ID is selected/input, click on “Attach”. Connection should occur in 2 to 3 seconds and the window will change slightly as attachment occurs.
After successful device attachment, the device ID will be shown along with a “connected” status. If the device is on, a battery percentage is provided by Tive and displayed. If the device is not on, the battery percentage is not provided by Tive and is left blank.
If during device attachment, the device ID entered is not found, the following error will display:
If you receive this error, click on the “Refresh Tracking Devices” option shown above. This will enable a manual call from Shipwell out to Tive to refresh your device inventory. This error should only occur if you have added new Tive accounts that were not part of your original account list when Tive was added in the integration marketplace.
Using the Tive Integration Feature - Viewing Tracking
Once you have attached an active, powered on Tive device to your shipment AND the shipment has moved to a “Dispatched” or “In Transit” state, tracking information will be available for viewing. Follow these steps to access tracking details provided by your Tive device.
Navigate to the shipment with an associated Tive tracking device:
Click the Shipment ID to access the Shipiment Details page, here you will see the “Current Location” card that contains Tive device details:
Additionally, you will see breadcrumbs on the Tracking map:
Using the Tive Integration Feature - View/Download Tive Device Data
Once you have connected an active, powered on Tive device to your shipment, you can view and download sensor data. Follow these steps to access this information.
Navigate to the Shipment Details page of the shipment where you would like to view or download Tive device details. Select the “Actions” menu option on the right hand side.
The Actions menu will slide from the right hand side, from here, select the “View All Tracking Device Data” option.
A table will appear that shows all available data from the associated Tive device. Note that the device ID is at the top of the table
Within the data table you can:
Once you have finished working with the data table, it can be closed using the “X” on the top right.
TIVE FAQ
Is there a additional cost to utilize my TIVE subscription within Shipwell?
Yes, please reach out directly to your Customer Success Manager for more information.
How do I connect my Tive Account(s) to my Shipwell account?
Contact your Integration Consultant or your Customer Success Manager to discuss having Tive enabled on your account.
Once enabled, follow the steps listed here.
What if my connection attempt fails?
Contact your Integration Consultant or your Customer Success Manager.
Is the Tive tracking real time?
Yes, Shipwell mirrors the configurations you have set in your Tive account for tracking updates
Can I set my Tive device configurations in Shipwell?
No, device configurations are currently handled within the Tive platform only.
I attached the wrong device to a shipment, can I change the device?
You can disconnect a device from a shipment at any time. NOTE: Once a device is removed from a shipment, Shipwell no longer receives information for that device/shipment combination.
Can I attach more than one device to a shipment?
No, at this time, the device to shipment relationship is 1:1.
If I assign a device in Shipwell, does Tive know that the device is no longer available for any other shipment?
Yes, once a device is assigned in Shipwell (or Tive) that device becomes “unavailable” for any other shipment.
When does a device become available for assignment to a shipment?
When a device is manually removed by a user from the shipment OR
When the shipment moves to a “Delivered” state.
Why is my shipment not tracking?
Validate that a device is properly assigned to the shipment.
Validate that the shipment has moved out of a “Dispatched” state.
Confirm that the Tive device is powered on with sufficient battery life.
If you have confirmed the above steps and you are not seeing tracking or sensor data, please contact your Implementation Consultant or Customer Success Manager for further assistance.
Can Shipwell set up a Tive account for me?
No. You will need to contact Tive directly to establish an account and obtain credentials from them. Once those credentials are available, connect with your
Integration Consultant and/or Customer Success Manager to get your Tive account connected to your Shipwell account.
New Shipment Creation Experience for Non-Parcel Modes
Shipwell has implemented the new shipment creation experience for all modes except parcel. This new shipment creation experience will save users time when creating new shipments.
Note this new shipment creation experience is optional to utilize at this time and will continue to be enhanced as there are items that are still being incorporated within it. Stay on top of upcoming new shipment creation page efforts here.
Key benefits of the new shipment creation experience
Navigation Ease: Navigation ease by selecting shipment creation page segment within the index on the lefthand side of page.
Required Field Focused: The lefthand panel displays when the required fields have been completed in a section by filling in a green circle with a checkbox. Furter, sections that have required information have a red star next to it.
Instead of having all available fields presented at once, the new shipment creation experience hides most of the fields that are deemed as optional fields. Users can easily access by selecting ‘More Options’.
Less Required Information: Shipment stop contacts and location type are now optional. This information will still continue to be auto filled based on address book information if provided but is no longer required. Note for now we still require contact information on the Shipment Details page so if a user updates a shipment, then it will trigger an exception on the Shipment Details page. Accordingly, if they
How to access the new shipment creation experience?
When on the new shipment creation page select ‘Try It Today’ button in the upper righthand of page.
Will all the prior capabilities of the classic shipment creation page be incorporated into the new shipment creation page?
Generally, yes. There may be some items that get incorporated in a way that we think is more improved but the same capabilities within the shipment creation page are expected. The one exception to this is related to the question presented below of going from orders to shipments and read that to learn more.
Why don’t I see the ‘Try it Today’ on shipments created from orders?
The order-to-shipment creation experience eventually will have all users leveraging orders into shipments to go from the Order Details page or Order Dashboard directly to the Shipment Details page to by-pass having to access another page. Many customers are already leveraging this new order-to-shipment experience but if you aren’t and interested then contact your Customer Success Manager and they will make sure it is activated for you.
Improved Stop Completion Experience on Shipment Details Page
Shipwell has improved the stop completion experience on the Shipment Details page in order to reduce the amount of time for carriers being able to indicate when key stop events have occurred. This experience update request is based on input from customers and carriers.
Two ways to complete a stop:
One Click ‘Mark Stop as Complete’ button which will enter the current date and time when the button was selected as the time stop was departed. This event will trigger the stop status to be updated to ‘Departed’. However, this means that the dispatch and arrival time have not been registered.
Select ‘Mark Stop as Complete’ dropdown arrow and separately input ‘Dispatched, ‘Arrival’, and ‘Departed’ dates and times. These can be entered in all at the same time or can be entered one-by-one and press ‘Save’ once complete.
Be Aware: Note that once a field has been entered like ‘Arrival’ then the prior fields in time prior to this will no longer be available to be entered. This is done because if allowed it actually means the stop status currently would get updated to the last entered stop status item submitted and would not properly reflect current state. Further, late stop arrivals do not force an entry by carrier user to enter a late stop reason. These late stop reason identifiers can still be entered by selection the actions dropdown and selecting 'Add Event’ and indicating the late stop event reason.
There continues to be the ability to identify additional stop events through the standard full stop event list that has always been available. It is important that carriers follow their customers' mandates on stop event data sought.
Note this stop completion experience has been implemented across all carriers within Shipwell. However, Shipwell customers can also ask their Customer Success Manager for this functionality to be activated if desired also for their own users.
Add Round Trip to Contract Importer
Users now have the ability to indicate a lane should be considered a round trip lane when importing contracts. A round trip lane is defined as having an origin, a destination, and when the round trip flag is set to Y, the shipment stops should then return to the origin location. A round trip contract lane will only be applicable when the shipment stops match this format.
When viewing the Rate Table Details in an imported contract, the Round Trip column will display a “Y” for lanes that were imported as Round Trips.
The contract import file has been updated to include the Round Trip column. This column can contain values of Y, N, or be left blank. Leaving the column blank is equivalent to entering an N in the column.
The latest Contract Import template is located here.
API Changes
Best Practices
Our Best Practices sections in the documentation simplify the way you connect with our API. Follow the best practices to integrate faster, streamline workflows, and get more done in the recommended way. It's integration, without guesswork. New best practices have been added around the following in this release:
Shipment Assembly
Added optional
tags
property to theShipment Assembly
Create Shipment
request body that mirrors that schema of theOrder
Tags
. WhenShipments
are created fromOrders
in the UI, the sametag
information from theOrder
will be passed into theShipment Assembly
Create Shipment
request.
Contract Lanes
Added
is_roundtrip
property toContract Lane
.is_roundtrip
is aboolean
property that indicates if theContract Lane
is a round trip. This property is also supported in theContract Importer
.
A round trip is a transportation movement in which a carrier picks up a load at the origin, delivers it to the destination, and then returns to the origin or nearby location with either another load or an empty truck (deadhead). In the context of a contract lane, roundtrip often signifies a pre-negotiated agreement covering both the outbound and return legs of the route.
EDI Changes
Nothing for this release
Data Science/Analytics Model Updates
Nothing for this release
Mobile
Nothing of note for release
Other Minor Enhancements and Bug Fixes
Bug or Enhancement | Description |
Enh | Complete Products Guide Needed |
Enh | Customer Lane Data Report - To Be Edited |
Bug | Customer Value Report - Median Quote/Cost Avoidance |
Bug | Optimization Error For Canada Address |
Bug | Distance Calculation Failure - Workaround for Rand McNally Zip Code Edge Cases |
Bug | Error received when trying to upload a lane set for carrier bidding via RFP Automation |
Bug | R&L Auto Tender Routing guide failed |
Bug | Tender updates (EDI 204) do not generate when an address change occurs |
Enh | Script creation request to support workflows |
Bug | Orders removed from Shipments and returning to Unassigned |
Bug | Unable to add order on a shipment |
Bug | Creating shipments with 4+ orders via API- Timeout Error/Latency |
Bug | Shipment issues |
Bug | When loading the new/v3 orders dashboard it indicates the status of Ready despite showing on the Not Ready |
Bug | SHIPMENT CREATION FAIL- CSV File- LATENCY issue |
Bug | Cloning Permission Error when creating more than one Shipment (Shipment Cloning) |
Bug | Fix per-stop bol for multiple pickups and one delivery stop |
Bug | Settlements: Error when the user tries to reject an invoice |
Bug | MultipleResultsFound: Multiple rows were found when one or none was required |
Bug | Settlement tab not populating after page 9 |
Enh | Dock Scheduling Calendar UI viewing updates |
Bug | Increase the size of the description field in WebhookResponse to be > 256 |
Bug | FedEx Parcel Dispatch Error - 502 |
Bug | Figure out connection reset problems from most recent eventus |
Bug | Parcel ReRate |
Bug | Percent FSC not rating correctly |
Bug | Shipment Creation Under Parcel Address Not Saving New Address to Address Book |
Bug | SAIA ePRO GENERATION ISSUE |
Bug | Not Able to Tender With Contract |