FCL Shipment Mode - Deploying the week of Nov 10th
Overview
Shipwell is excited to announce the launch of FCL Shipments, providing comprehensive visibility and management capabilities for your ocean freight operations. This new mode enables you to create, track, and manage FCL shipments with real-time container tracking from origin to destination, while leveraging negotiated contract rates, managing invoices with ocean-specific accessorials, and maintaining complete documentation directly on shipment records. To enable FCL container tracking visibility, please engage with your Customer Success Manager. This service may require additional charges to your base subscription.
Key Features
Create FCL Shipments via Web UI and API Build FCL shipments using our intuitive interface or programmatically through APIs, giving you flexibility in how you manage your ocean freight operations.
Real-Time Container Tracking Monitor container movements from origin to destination with automatic updates from ocean carriers, reducing manual tracking efforts and improving visibility across your supply chain.
Ocean-Specific Statuses Track containers through detailed lifecycle stages including origin events, transshipment, discharge, terminal availability, and empty returns, providing clarity on exactly where containers are in their journey.
Tracking Status Indicators Know immediately when tracking has successfully started with dedicated status events (Locating, Tracked, Error), eliminating uncertainty about whether your containers are being monitored.
Ocean Carrier Management Create carrier profiles and leverage negotiated contract rates directly in Shipwell, streamlining rate management and ensuring accurate pricing for your FCL freight.
Settlement for FCL Invoices Manage carrier invoices with ocean-specific accessorials, match costs to shipments, and reconcile charges against quoted rates, improving financial accuracy and reducing billing discrepancies.
Document Management Upload and store bills of lading, customs documents, and shipping certificates directly on shipment records, maintaining a complete audit trail and ensuring compliance documentation is easily accessible.
Ocean-Specific Accessorials Capture industry-standard charges including Terminal Handling Charges (THC), Bunker Adjustment Factor (BAF), Peak Season Surcharge (PSS), and seven additional accessorial types, ensuring complete cost visibility.
Dashboard Enhancements Filter and search by MBOL and Ocean SCAC codes with new reference types and ocean-specific status filters, making it easier to find and manage your FCL shipments.
Compass Integration View ocean shipment milestones and monitor exceptions across your ocean freight operations, enabling proactive management of potential issues.
Analytics Support Leverage your existing reports to filter on this new FCL mode.
How it Works
Create Your FCL Shipment: Easily create new FCL shipments within the Shipwell platform using our intuitive interface or APIs.
Enter MBOL: Provide the Master Bill of Lading (MBOL) number and container details for your shipment to initiate tracking.
Track in Real Time: Monitor your container's progress with real-time updates and notifications throughout its journey.
Access Detailed Insights: View comprehensive tracking information, including origin, transshipment ports, discharge location, terminal availability, estimated arrival times, and more.
Manage Costs: Leverage ocean-specific accessorials, contract integration, and settlement features to manage invoices and costs.
Creating FCL Shipments
Shipwell has introduced FCL shipments with the same user-friendly interface as our other supported modes. Users can also create shipments via our API suite. Mode, Equipment, Service Level and Movement Type auto populate, but can be adjusted by the user.
Note: Building FCL shipments directly from orders will be supported in a future release.
Initiating Container Tracking
Once an FCL shipment is created in the Shipwell system and a valid MBOL is supplied, container tracking will begin automatically once updates are available from the ocean carriers.
This tracking field is located in the shipment details page in the References section and must be filled in with a valid MBOL for tracking to begin. The system validates the MBOL format before allowing you to save the value. Once tracking has started, the system will automatically receive updates throughout the container's lifecycle. Note that this tracking information is also available through our APIs.
Container Tracking Updates
All updates and key milestones related to your ocean shipments will be displayed on the Shipment Tracking tab. You can expect to see updates as your container moves through various stages of its journey.
Tracking Status Events
Before container movement updates begin, you'll see tracking status indicators:
Event | Description | Timeline Event Card |
Locating | Locating MBOL tracking details | Tracking Requested |
Tracked | Successful tracking on MBOL details | Tracking Started |
Error | Error tracking on MBOL details, such as MBOL not found. | Tracking Error |
ETA Update | ETA has been updated due to schedule changes | ETA Changed |
Container Movement Events
The following table lists ocean-specific event codes, descriptions, and their impact on shipment status throughout the container's journey:
Origin Events
Shipment Status | Timeline Display | Description |
Empty Outgated - Origin | Outgated - Origin | Container empty outgated to shipper at origin |
Full Ingated - Origin | Ingated - Origin | Container full ingated from shipper at origin |
Loaded on Barge - Origin | Loaded - Barge - Origin | Container loaded onto barge at origin |
Barge Departed - Origin | Departed - Barge - Origin | Barge departed from origin port |
Barge Arrived - Origin | Arrived - Barge - Origin | Barge berthed at origin port |
Discharged from Barge - Origin | Discharged - Barge - Origin | Barge discharged from origin port |
Loaded - Origin | Loaded - Origin | Container loaded onto vessel at origin port |
Departed - Origin | Departed - Origin | Vessel departed from origin port |
Transshipment Events
Shipment Status | Timeline Display | Description |
Arrived - Transshipment | Arrived - Transshipment | Vessel arrived/berthed at transshipment port, Container has discharged/loaded at transhipment port |
Departed - Transshipment | Departed - Transshipment | Vessel departed from transshipment port |
Discharge Events
Shipment Status | Timeline Display | Description |
Arrived - Discharge | Arrived - Discharge | Vessel arrived/berthed at final port of discharge |
Discharged | Discharged - Discharge | Container discharged from vessel at final port of discharge |
Loaded on Barge - Discharge | Loaded - Barge - Discharge | Container loaded onto barge at port of discharge |
Barge Departed - Discharge | Departed - Barge - Discharge | Barge departed from port of discharge to final destination |
Barge Arrived - Discharge | Arrived - Barge - Discharge | Barge berthed at final destination |
Discharged from Barge - Discharge | Discharged - Barge - Discharge | Container discharged from barge at final destination |
Terminal and Facility Events
Shipment Status | Timeline Display | Description |
Available - Terminal | Available - Terminal | Container available for pickup at terminal |
Full Outgated - Terminal | Outgated - Terminal | Container full outgated from terminal |
Available - off dock facility | Available - Off Dock Facility | Container full ingated at off-dock facility |
Available - off dock facility | Available - Off Dock Facility | Container available for pickup at off-dock facility |
Full Outgated - Off dock facility | Outgated - Off Dock Facility | Container full outgated from off-dock facility |
Trucker Yard Events
Shipment Status | Timeline Display | Description |
Available - trucker yard | Available - Trucker Yard | Container full dropped off at trucker yard |
Available - trucker yard | Available - Trucker Yard | Container full picked up from trucker yard |
Empty Container Return Events
Shipment Status | Timeline Display | Description |
Ready for Pick up - final destination | Ready for Pick up | Empty container available for pickup at final destination |
Empty Picked up - final destination | Picked up | Empty container picked up at final destination |
Ready for Pick up - trucker yard | Ready for Pick up - Trucker Yard | Empty container dropped off at trucker yard |
Empty Picked up - trucker yard | Picked up - Trucker Yard | Empty container picked up from trucker yard |
Empty Returned | Returned | Empty container returned |
Shipment Status Updates
FCL mode includes comprehensive shipment statuses organized by container lifecycle stage and color-coded to help with selection and exception management. These statuses automatically update as real-time visibility events occur, dependent on the ocean carrier's adherence to the event standard.
Supported Ocean Carriers
Ocean Carrier | Ocean Carrier SCAC |
American Presidents Line | APLU |
ANL | ANNU, ANLC |
Arkas Line | AXVJ |
Atlantic Container Line | ACLU |
CMA-CGM | CMDU |
CNC | CHNL, 42NY, AAA4 |
COSCO | COSU |
Crowley | CWPN, COSN, CWQN, CQLQ, CLAM, CAMN, CWYG, CMSN, CWSP, CWPS, CPRC, CMCU, CWLQ |
CU Lines | CULV |
Dole Ocean Cargo Express | DOLQ |
ECU WorldWide | ECUI |
ESL | ESLC, EMIV |
Evergreen | EGLV, EVRG |
Grimaldi Lines | GRIU, GESM, GDSL, GMGO |
Hamburg-Sud | SUDU |
Hapag-Lloyd | HLCU, HLUS |
Hede | HDUJ |
Hellmann Worldwide Logistics | POLN |
Hyundai Merchant Marine (HMM) | HDMU |
Independent Container Lines | IILU |
KMTC | KMTC, KORP, KMTU |
Maersk | MAEU |
Marfret | MFUS |
Matson | MATS |
MSC | MEDU |
Ocean Network Express | ONEY |
OOCL | OOLU |
Pacific International Lines | PABV |
Pasha Hawaii | PHHD |
Safmarine | SAFM |
Sea Lead | SJHH |
Seaboard Marine | SMLU |
Sealand Maersk | SEAU |
Seth Shipping | SSPH |
Sinokor | SNKO |
Sinotrans | SNLF, 12IH |
SITC | SITG |
SM Line | SMLM |
Swire | SSES, SSEH, CSEH, CSES, UWLD |
TOTE Maritime | TOTE, TMGT |
TS Lines | TXZJ, TSYN |
Turkon | TRKU |
Wan Hai | WHLC, WHLU |
Westwood Shipping Lines | WWSU, SSBF, QWJA |
Yang Ming | YMLU, YMPR, YMJA |
ZIM | ZIMU |
Mapped Container Updates
As location updates are received, the latest location will be updated on the shipment tracking map. The system will update regularly throughout the lifecycle of the container based on carrier data availability. Hovering over any of the location points on the map will display the date and time of the location update.
Shipment Itinerary Details
Users will have the ability to view additional MBOL and container movement details associated with their FCL shipments. As part of our tracking service, the system captures vessel itinerary and movement details associated with the MBOL and container.
Updates to Shipment Dashboard
The shipment dashboard now includes container-specific capabilities:
New Reference Types: MBOL and Ocean SCAC have been added as reference types and columns. You can add these columns to your dashboard view and use them for searching and filtering.
Container Statuses: The status filter now includes all container-specific statuses, allowing you to easily identify and manage containers at different stages of their journey.
Search and Filter: Both MBOL and Ocean SCAC are fully searchable, enabling quick access to your FCL shipments.
Ocean Carriers and Contract Rates
Shipwell supports ocean-specific carriers, allowing you to create carrier profiles and leverage negotiated contract rates directly within the platform. This enables accurate quoting and cost management for your ocean freight operations.
Ocean-Specific Accessorials
FCL mode includes support for industry-standard ocean freight accessorials, enabling accurate cost capture and invoicing:
Terminal Handling Charges (THC) - Charges for handling containers at the terminal
Documentation Fee - Fees for processing shipping documentation
Container Imbalance Fee (Repositioning Fee) - Charges for repositioning empty containers
Bunker Adjustment Factor (BAF) - Fuel surcharge adjustments
Peak Season Surcharge (PSS) - Additional charges during high-demand periods
Container Cleaning Fee - Charges for cleaning containers between uses
Change of Destination Fee - Fees for modifying the container's destination
Late Documentation Fee - Penalties for delayed documentation submission
Telex Release Fee - Charges for electronic release of cargo
Container Seal Fee - Fees for sealing containers
These accessorials can be added to shipments and managed through Shipwell's settlement features. Moreover, we will be able to quickly add more accessorial codes based on customer need.
Settlement for FCL Invoices
Use Shipwell's settlement capabilities to manage FCL freight invoices, including:
Capture carrier invoices with FCL-specific accessorials
Match invoices to shipments
Reconcile costs against quoted rates
Process payments efficiently
Document Management
FCL shipments support document uploads directly to the shipment record, enabling you to:
Upload bills of lading, customs documents, and certificates
Attach commercial invoices and packing lists
Store arrival notices and delivery receipts
Maintain a complete document trail for compliance and reference
Compass Integration
All FCL shipments are now supported in Compass, Shipwell's analytics and alerting platform. This integration enables you to:
Create custom alerts for container shipment milestones
Monitor container movements and exceptions
Track performance metrics across your ocean freight operations
Set up automated notifications for critical events
Analytics Support
Comprehensive reporting and analytics for ocean shipments, providing insights into transit times, carrier performance, cost trends, and operational metrics.
API Access
FCL shipment data, including tracking events and movement details, is available through Shipwell's API, enabling seamless integration with your existing systems and workflows.
What's Coming
We're continuously enhancing FCL mode capabilities. Here's what's on the roadmap:
Port Selection by UN/LOCODE Support for standardized UN/LOCODE port identification codes, providing a globally recognized system for selecting ports and reducing ambiguity in port selection.
Template Builder Support Create reusable FCL shipment templates to streamline repetitive booking processes and ensure consistency across similar shipments.
Shipment Stage Support Enhanced workflow management with defined shipment stages, enabling better process control and team coordination throughout the ocean freight lifecycle.
Rolled Container Status Dedicated status tracking for rolled containers (containers that miss their scheduled vessel), improving visibility when schedule changes occur and helping manage demurrage risks.
Drayage Mode - Container Statuses Ocean specific statuses for container tracking stages on Drayage Mode.
Multiple Container to a Single Shipment Allow users to have multiple containers to a single shipment.
LCL Mode Enable users to create and manage LCL shipments
For questions about enabling container tracking visibility or to learn more about FCL mode capabilities, please contact your Customer Success Manager.
Settlement First Pass Match Support for Carrier Factoring Company
Shipwell supports identifying your carrier’s factoring company within the ‘Payments’ tab of the carrier profile. Go to ‘Manage’ → ‘Carrier’ → ‘Payments’ and identify your carrier’s factoring company if applicable. Note if connected via Triumph Pay in the Shipwell marketplace and this factoring company is identified there then the factoring company will be automatically populated.
Once you have a factoring company that has been identified for a carrier then when an invoice is received for a shipment with that same carrier the factoring company’s name will also be evaluated as a potential matching option for the Settlement rule matching the carrier or factor name. This way you will not have unneeded exceptions to review for those carriers that have a factor identified.
The Settlement Configuration ‘Carrier match’ has been updated to ‘Carrier or Factor match’ where if either the carrier name matches or the factor name matches on an uploaded invoice’s invoicing party then it will not trigger an exception.
As always, settlement configuration updates only apply going forward for new invoices received or new reviews of already uploaded invoices. Therefore, any change made to factors for carriers will be forward looking.
By Mode and By Carrier Settlement Configuration Support
Shipwell’s Settlement configurations allow for users to identify which modes and which carriers each Settlement configuration applies. This way you can activate or deactivate an individual settlement configuration by mode and/or by carrier if you prefer.
For example, if you are a customer that has a private fleet you may not wish to have certain documents required that you may require of your non-fleet carriers. Or for example you may require certain documents for your Ocean freight that you do not require of your other freight modes.
How to adjust which ‘Invoice Exception Criteria’ or which ‘Settlement Configurations’ apply to which modes and which carriers?
By default, all configurations will apply to all modes and all carriers for ease of management. You can adjust this by adding in specific modes and/or carriers to specific settlement configurations and it will limit that specific settlement configuration to the mode and carriers identified. Remember that if a configuration does not apply because it doesn’t match a mode or a carrier for an invoice the invoice is still reviewed for First Pass Match, but it simply does not apply the particular settlement rule for that review.
If you select some particular modes and some particular carriers, then both the mode selection and the carrier selection must be met for that settlement configuration to apply to the shipment that the freight invoice is associated. For example, if you have a shipment that is LTL mode for XPO carrier, but you have a Settlement configuration of a Lumper Receipt activated for FTL modes and all carriers then this Lumper Receipt will not be required for the LTL shipment since it does not meet the mode criteria. See table below for some example scenarios.
By Mode Configuration | By Carrier Configuration | Carrier on Shipment Invoiced | Mode of Shipment Invoiced | Settlement Rule Applied |
Blank (all modes apply) | Blank (all carriers apply) | XPO | LTL | Applied |
Blank (all modes apply) | XPO, ESTES, Schneider | SAIA | LTL | NOT Applied |
FTL, LTL | Blank (all carriers apply) | SAIA | LTL | Applied |
FTL, LTL | Blank (all carriers apply) | SAIA | Drayage | NOT Applied |
FTL, LTL | Blank (all carriers apply) | SAIA | LTL | Applied |
If no carrier or mode is identified for any “Invoice Exception Criteria” or any “Settlement Configuration”, then the respective criteria or configuration applies to all carriers and all modes (note parcel as not supported currently).
As always, settlement configuration updates only apply going forward for new invoices received or new reviews of already uploaded invoices. Therefore, any change made to by mode or by carrier configurations for settlement configurations will apply going forward.
Carrier and Customer Payment Term Support and Leverage in Settlement
Shipwell allows for you to define payment terms for your carriers and customers. These payment terms can be identified on each of your carrier and customer pages. The benefit of leveraging these payment terms is that they will automatically be applied to invoices received as respects the payment term date calculation and in the future there may be additional automation built off these predefined payment terms.
How do I set a carrier or customer payment term?
Set Carrier Payment Term: Go to ‘Manage’ → ‘Carrier’ → ‘Payments’ and select ‘Add Payment Term’ to create a payment term. You can have one of these payment terms that will be your default and if you only have one payment term then it will be default automatically.
Set Customer Payment Term: Go to ‘Manage’ → ‘Customer’ and select ‘Add Payment Term’ to create a payment term. You can have one of these payment terms that will be your default and if you only have one payment term then it will be default automatically.
What payment term triggers are available?
You can select from ‘Invoice Date’, ‘Shipment Delivered’, ‘Shipment Picked Up’, and ‘Proof of Delivery’ as options for the Payment Term trigger starting date. Note that if something is not present as of the time the invoice is created and run through First Pass Match then it will leverage ‘Invoice Date’ as the default term since all invoices will have an Invoice Date.
How is this payment term utilized?
Once you have defined those payment terms then they will be used when freight invoices are created in Shipwell based on your default payment term for that carrier or customer. Note this means that in the in-app carrier created invoice it will lock the interface to represent the date for the default payment term you have selected so the carrier does not have the option of selecting a different date. For EDI 210 and uploaded invoices it will also leverage this payment term date.
As always, settlement configuration updates only apply going forward for new invoices received or new reviews of already uploaded invoices. Therefore, only new invoices received will have this payment term date utilized.
Freight Invoice Payment Information
Shipwell supports having customers writeback payment information via API to display payment details for carriers. The benefit of implementing this is will reduce the number of questions raised by carriers on when they will get paid. Typically this payment information would be added during the ‘Scheduled’ or ‘Paid’ invoice status stage.
Once added then this payment information is available both in the Settlement dashboard with new columns that are available for ‘Payment Amount’, ‘Payment Date’, ‘Payment Type’, and ‘Payment ID’.
This information is also available within the Shipment Details page as a hover over for the information icon next to the freight invoice. Note this icon is not presented unless payment information is available.
This information is also available within the Shipment Details page as a hover over for the information icon next to the freight invoice. Note this icon is not presented unless payment information is available.
Lastly, if payment information is provided at the time of updating the freight invoice status, then this payment information will be provided within the email sent to carriers also.
Swifty In-App AI Assistant
Shipwell’s Swifty In-App AI Assistant allows users to ask tasks and perform questions based on a user’s permissions and Swifty’s capabilities. Users can access Swifty by selecting the pink conversation cloud icon in the upper righthand portion of your screen. Once selected you can simply ask it what you want it to do.
Initially, Swifty in-app assistant is being released to all Shipwell users but in the future some or all of the in-app assistant is expected to be a product add-on that will have an additional cost.
What is available?
Initial Swifty in-app assistant’s capabilities supported include:
Conversational analytics (users with ‘Analytics’ viewing permissions only) so users can ask questions related to their data
Ask questions related to the Shipwell knowledge base along with directing users to articles that are applicable (note there is still the entire Knowledge Base available by selecting the '?' icon in the upper righthand side of Shipwell navigation panel)
Get information about a shipment including external tracking link
Get detailed information about a specific shipment
Create shipments (must provide at least a ship from location, ship to location, and product information)
Create multiple shipments
Filter shipments by status, mode, companies, dates, locations, etc
Filter orders (v3 orders only) by status, tags, companies, order numbers, etc.
Create a dock appointment (Dock Scheduling customers only)
List dock appointments with optional filtering by references, dates and facility (Dock Scheduling customers only)
Reschedule a dock appointment (Dock Scheduling customers only)
Cancel a dock appointment (Dock Scheduling customers only)
More capabilities will be added to this interface, and we will be watching for questions being asked to better understand desired capabilities.
How it works?
Simply ask Swifty what you are trying to do using natural language.
Example Applying Shipment Filters: Below it is an example where as a user I am on the new shipment dashboard and have asked it to “show me my ftl shipments that are tendered” and it has then reviewed my question and knows that I am on the shipment dashboard so it applied the filters for both Mode = Full Truckload and Status = Tendered. Sometimes after you ask Swifty to do something it will provide you one or more quick command buttons based on common actions users might take after. In this case after applying filters, it gives me an easy one click option to “Clear All Filters”.
Example Conversational Analytics: As a user I want to get some quick information about my data and I have ‘Analytics’ access but I want to not have to find a report and then apply filters or even possibly have to apply some custom logic to get my results. Instead I can simply ask questions related to my data.
First, I’m going to ask Swifty “what are my top 10 ftl lanes” and as you can see it has provided a list of my top 10 lanes in descending order.
Next, I’m going to ask Swifty “what is my average cost per lane for my top 5 ftl lanes for the last 6 months” and now it is going to perform an averaging of my costs paid on my top 5 FTL lanes over the last 6 months.
How to adjust the Swifty interface?
If you want to start a different conversation thread, then click the ‘+' icon in Swifty chat’s header.
However, if you want to have a multi-part conversation related to something like related to conversational analytics then you can continue your conversation, and it will use the context of the conversation in coming up with its response.
If you want to expand or contract the size of Swifty you can do so by selecting the ‘^' icon in Swifty chat’s header.
At any point if you want to hide Swifty from the interface you simply select either the 'x' in the upper righthand side of Swifty or you select the pink conversation cloud icon in the upper righthand side of navigation bar.
How can I provide feedback for Swifty to make it better?
Anytime you ask Swifty a question you will be given the option to provide it a thumbs up or a thumbs down. If you provide it a thumbs down, then you will be provided a modal to provide more specific reason on why it was not what you were expecting.
Thank you in advance for your feedback provided as this will help us make Swifty better for you and our other customers.
Developer Tools
Overview
Shipwell’s new Developer Tools feature allows users to manage webhooks, monitor events, and obtain API tokens from within the Shipwell platform to speed up implementation and development.
[Screenshot of the main Developer Tools interface highlighting navigation tabs]
Key Features & How to Use Them
1. Webhooks Management
Easily configure, monitor, and maintain webhook endpoints from a centralized dashboard. How to Use:
Note: To use this feature, you must have Company Administrator permission.
Access Webhooks:
Go toManage > Company > Developer Toolsand select the Webhooks tab.View & Search:
See all configured webhooks in a table with status indicators.Add a Webhook:
Click Add Webhook. Enter the endpoint URL, contact email, and select events to subscribe.Configure Authentication (Optional):
Expand the authentication section to add HTTP Basic Auth credentials.Set Custom Payload (Optional):
Add custom JSON data if needed.Save & Monitor:
Save your webhook. Monitor delivery attempts, filter by status (All/Succeeded/Failed), and retry failed deliveries directly from the details view.
[Webhooks Configuration Interface — Screenshot of the webhook creation form with URL input, event selection, and authentication options]
Benefits:
Centralized management and quick status visibility
Real-time monitoring and troubleshooting
Flexible authentication and payload options
You can also quickly replay an event and send to the webhook. Useful when setting up the webhook and testing code.
Editing Existing Webhook
Access Webhooks:
Go toManage > Company > Developer Toolsand select the Webhooks tab.View & Search:
Find the associated webhook you would like to edit.Note you can View, Edit, (Enable/Disable), and Delete a Webhook simply by using the action button from the dashboard.
You can mouse over a field and update that field from the webhook details page. For example if you want to update the URL, simply mouseover the url and click the edit pencil
If you want to update the events the webhook is subscribed to, you simply mouse over the events and click the pencil. You can search and find the events you are interested in. Simple search by created, update, the object, or any other combination and the list will filter for you.
You can edit the error email, events, authentication, and custom data fields.
2. Events Monitoring & Analysis
Gain real-time visibility into all API and webhook events with advanced filtering and search. How to Use:
Access Events:
Navigate to the Events tab in Developer Tools.Filter & Search:
Use filters for date range, event type, and delivery status. Search across event properties for quick access.View Event Details:
Click any event ID to see full metadata, source system info, and the JSON payload (with raw/pretty view and copy options).Monitor Delivery Attempts:
Open the webhook attempts modal to review delivery status, HTTP responses, and retry failed attempts for the specific event. This is helpful if you have multiple webhooks that receive the same event.
[Events Monitoring Dashboard — Screenshot showing event filters, real-time event feed, and event details panel]
Benefits:
Comprehensive event visibility and audit trail
Fast troubleshooting with detailed payload and delivery logs
Efficient handling of high-volume event streams
View Webhook Attempts for a specific event
Retry events which will retrigger the event to the webhook.
3. API Token
Easily sdAccess API Keys:
Go to the API Keys tab in Developer Tools.
On API Keys tab: You will see the option to “Get Token.” This page requires you to re-enter your password for the user linked to the API token. You can also run permission tests on core objects (Locations, Shipments, and Orders) to verify if your user has the proper permissions for standard API requests
[API Token Screen — Screenshot of the API Token tab]
Benefits:
Quickly get your user’s API Token.
Quickly test permissions and test a curl request.
Getting Started
Prerequisites:
Shipwell account with Developer Tools access
Appropriate company permissions
Quick Start Steps:
Open Developer Tools from the Manage → Company → Developer Tools.
Set up your first webhook and subscribe to relevant events.
Use the Events dashboard to monitor activity and troubleshoot.
Check the API Keys tab to obtain user token.
Best Practices
Start with a test webhook to validate your integration.
Monitor events regularly to catch issues early.
Use built-in validation to prevent configuration errors.
Document webhook and API key usage for team clarity.
Support & Resources
Documentation: Visit the Developer Portal for API guides and tutorials.
Support: Contact Shipwell support for integration help.
API Changes
Overview
This release includes updates to shipment timeline event types, providing better tracking granularity throughout the shipment lifecycle.
New Features
Enhanced Timeline Event Types
We've expanded the available event types and subtypes for shipment timeline events, providing more granular tracking and visibility throughout the shipment lifecycle.
New Event Types:
ARRIVED- Shipment has arrived at a locationAVAILABLE- Shipment is available for pickupDEPARTED- Shipment has departed from a locationDISCHARGED- Container has been dischargedINGATED- Container has been ingated at a facilityLOADED- Shipment has been loadedOUTGATED- Container has been outgated from a facilityPICKED_UP_EMPTY- Empty container has been picked upREADY_FOR_PICKUP- Shipment is ready for pickupRETURNED- Shipment has been returned
New Event Subtypes:
DISCHARGE- Discharge-related eventsOFF_DOCK_FACILITY- Events at off-dock facilitiesORIGIN- Origin location eventsTERMINAL- Terminal-related eventsTRACKING_ERROR- Tracking errors encounteredTRACKING_REQUESTED- Tracking has been requestedTRACKING_STARTED- Tracking has startedTRANSSHIPMENT- Transshipment eventsTRUCKER_YARD- Events at trucker yards
Availability:
Available in both request and response payloads
Supported across all shipment-related endpoints
Compatible with timeline event creation and updates
Enhanced Endpoints
Timeline Event Endpoints
All shipment timeline event endpoints now support the expanded event types and subtypes:
Shipment Timeline Events:
GET /shipments/{shipmentId}/timeline-events/- List timeline events with new typesPOST /shipments/{shipmentId}/timeline-events/- Create events with new typesGET /shipments/{shipmentId}/timeline-events/{shipmentTimelineEventId}/- View events with new typesPUT /shipments/{shipmentId}/timeline-events/{shipmentTimelineEventId}/- Update events with new types
Shipment Endpoints:
All shipment GET, POST, and PUT endpoints now return the new event types in
timeline_eventsPurchase order shipment endpoints
Spot negotiation endpoints
Carrier power unit endpoints
Shipment pickup endpoints
Migration Guide
For Enhanced Timeline Events
No action required - The new event types and subtypes are additive.
To start using new event types:
Update event handling: Ensure your code can handle the new event types in responses
Create detailed events: Use the new types when creating timeline events for more granular tracking
Filter by new types: Leverage new event types in your tracking and reporting logic
Backward Compatibility
✅ Fully Compatible: All existing integrations will continue to work without modification.
✅ Timeline Events: New event types are fully backward compatible and purely additive.
⚠️ Enum Handling: If your integration uses strict enum validation for timeline event types, you may need to update your validation to accept the new values.
✅ No Breaking Changes: This release maintains full backward compatibility across all endpoints.
Description |
Driver Name is not populating in Analytics |
Allow Users to enter multiple container numbers in the AI Assistant and provide the list on the Shipments Dashboard |
Actions Menu Update |
Tive Users - Data Table Device Default |
FE - Update Tracking Data Icon |
Ocean Shipment Statuses and Stop updates |
New Timeline Card - Ocean Tracking status |
204 EDI transactions are not appearing on the Orderful UI. |
RPO not available for Elite BOL |
Zone origin update |
Ocean Mode - Shipment Details Page |
214 Appointment Update Not Updating Pickup/Delivery Time |
MacroPoint Not updating arrivals and departures in Shipwell |
MacroPoint arrivals and departures not updating in Shipwell |
sFTP orders NOT being picked up by Shipwell Production |
[ANDROID][5.3.13] Exception thrown on stop complete screen |
[ANDROID][5.3.14] Onboarding crash in Android 33 |
Display Factoring company object onto the carrier profile saved by SaaS customer |
Support different currency of record for customer financials (decouple from shipments.preferred_currency) |
Support payment_terms object on the carrier-relationship for shipments |
Support payment_terms object on the shipper-relationship for shipments |
Leverage payment_terms when creating a freight invoice in Shipwell and ignore any Due Date provided parameter |
Order PU# being removed from BOL |
The invoice and bill charge mapping need to display all the records |
Shipments are showing up on the dock schedule a day early |
NetSuite Mapping Issues |
Invoice Creation Fails – Backend Rejects Amount Due to Floating-Point Precision Beyond 4 Decimals |
Map invoice and bill default fields for sending on creation to NetSuite |
Inaccurate Invoice Status |
EMAILING INVOICES- to incorrect recipients |
Supplier releases not working on new order creation experience in all instances |
Product name field in the new order creation experience incorrectly displaying UUID instead of product reference |
Fix Order Creation Issues: V3 Redirect, and Order Release References |
NetSuite orders timezone issue |
Stop company name is empty when adding order to shipment |
SuiteApp V3 Order having the wrong pickup times |
Shipwell Transmission Error – NetSuite Duplicate PO Rejection |
FedEx Account Registration Returns 500 Internal Server Error |
LTL loads marked as Delivered when still in transit |
Carrier Exclusion Rules Not working for LTL Carrier |
RXO carrier information disappeared-Unable to Tender |
CHR direct rates not returning all available service levels |
CH Robinson - set the Delivery Date based on Transit Days |
Logos for Forward Air & Crosscountry Courier |
RFP Lane Import Failure - "Lane not Recognized" Error for Valid Lane |
Servicing Carrier (e.g., Forward Air, LLC) Displays as CH Robinson on Shipments |
Inconsistencies with Contract Rate visibility during the tendering process. |
Add remove fake and duplicate GUR rates to P44 V4 rating |
Old Dominion Delivered Status Not Syncing from Project44 to Shipwell |
Unable to Save new Capacity Provider Accounts in the Carrier Profile |
Workflow Not Broadcasting to Carriers & Pushing to Routing Guide Not Working |
























