Global Search
Overview
The Global Search feature provides a fast, unified way to find and access any record in your Shipwell account. Instead of navigating to individual pages, you can search across all object types from anywhere in the application and jump directly to the record you need.
Quick Access
Keyboard Shortcut: Press ⌘K (Mac) or Ctrl+K (Windows/Linux) from anywhere in Shipwell to open Global Search.
Alternative: Click the search icon in the top navigation bar.
What You Can Search
Global Search searches across all major object types in your Shipwell account:
Shipments
Search by:
Reference ID, Mode (e.g., FTL, LTL, Parcel, FCL etc), Customer name, Status, Location, and any other field you can search on the Shipment Dashboard
Orders
Search by:
Order number, Supplier name, Origin/destination locations, custom data fields and any other field you can search on the Orders Dashboard
Note: Your account may use either Orders (V3) or Purchase Orders (V2) depending on your configuration.
Carriers
Search by:
Carrier name, MC number, DOT number, SCAC code, or other identifying code, Address, and any other field you can search on the Carrier Dashboard
Customers
Search by:
Company name, Billing email, Phone number and any other field you can search on the Customer Dashboard
Suppliers
Search by:
Supplier name, Address, Contact name or email
Products
Search by:
Product name, Description, Hazmat codes, References and any other field you can search on the Products Dashboard
Locations (Address Book)
Search by:
Location reference/name, Company name, Address, Contact information and any other field you can search on the Locations Dashboard
Appointments
Search by:
Shipment reference ID, Facility name, Carrier name, Appointment date and any other field you can search on the Appointments Dashboard
Settlements (Freight Invoices)
Search by:
Invoice number, Shipment reference ID, Carrier/service provider name and any other field you can search on the Carrier Dashboard
Contracts
Search by:
Contract name, Carrier name, Origin/destination locations and any other field you can search on the Contracts Dashboard
Routing Guides
Search by:
Routing guide name, Modes or equipment types, Origin/destination locations and any other field you can search on the Routing Guide Dashboard
Load Board
Search by:
Load board ID, Customer name, Equipment type and any other field you can search on the Load Board Dashboard
Filtering Results
Filter Chips
At the top of the search results, you'll see filter chips for each object type (Shipments, Orders, Carriers, etc.).
To filter results:
Click on any filter chip to show only results for that object type
Click multiple chips to see results from multiple object types
Click a selected chip again to deselect it
Customizing Filter Order:
Hover over a filter chip to see the drag handle (6-dot icon)
Click and drag chips to reorder them
Your preferred order is saved automatically
Search results will display in your custom order
Clear All Filters:
Click the "Clear All" button to reset all filters and see results from all object types
Viewing More Results
Each object type initially shows the first 3 results. To see more:
Click "Show more [object type]" at the bottom of any result group
Additional results will load and append to the existing results
Continue clicking "Show more" until all results are loaded
Once all results are loaded, you can click "Show less" to collapse back to the first 3
Tip: A loading indicator is shown when additional results are being fetched.
Keyboard Navigation
For power users, Global Search includes keyboard support:
Shortcut | Action |
⌘K / Ctrl+K | Open Global Search |
ESC | Close the search modal |
↑ / ↓ Arrow Keys | Navigate through search results |
Enter | Open the selected result |
Tab | Navigate between filter chips |
The selected result is highlighted in blue and automatically scrolls into view.
Search Tips
Best Practices
Search terms are matched across multiple fields for each object type
You don't need to type the complete ID or name - partial matches work
Results appear in real-time as you type
Filter chips help narrow results when you know what type of object you're looking for
Performance
Results are paginated to load quickly
Initial search shows 3 results per object type
Permissions
You'll only see results for object types you have permission to view
Some features (like Load Board or Suppliers) may only appear if enabled for your account
Common Use Cases
Finding a Specific Shipment or Order
Press ⌘K or Ctrl+K
Type the reference ID or customer name
Click the Shipments filter chip to narrow results
Click on the shipment to view details
Looking Up Carrier Information
Open Global Search
Type the carrier name, MC number, or DOT number
Select the Carriers filter
Click to view the carrier profile
Locating an Invoice
Open Global Search
Type the invoice number or shipment reference
Filter by Settlements
Click to view the freight invoice details
Finding a Contract
Open Global Search
Type the contract name or carrier name
Filter by Contracts
Click to view contract details and rates
Frequently Asked Questions
Q: Why don't I see all object types in my filters?
A: Filter chips only appear for features enabled on your account and that you have permission to access.
Q: Can I search for multiple objects at the same time?
A: Yes! By default, Global Search searches across all enabled object types. Use filter chips to narrow results if needed.
Q: How do I change my default filter order?
A: Simply drag and drop the filter chips into your preferred order. This preference is saved automatically.
Q: What happens if I search with no filters selected?
A: Results from all available object types will be displayed, organized by object type.
Q: Why are some results showing "Show more" while others aren't?
A: "Show more" only appears when there are more than 3 total results for that object type.
Q: Can I bookmark search results?
A: No, but you can bookmark the individual record pages after clicking through from search results.
Troubleshooting
No Results Found
Check your search term spelling
Try a partial match (e.g., first few characters)
Clear any active filters that might be excluding results
Verify you have permission to view the object type you're searching for
Search Is Slow
Check your internet connection
Try filtering to specific object types to reduce the search scope
Clear your browser cache if the issue persists
Can't Open Global Search
Verify you're logged into Shipwell
Try clicking the search icon in the navigation bar instead of using the keyboard shortcut
Refresh your browser if the feature isn't responding
Feature Availability
Account-Specific Features
Global Search is available to all Shipwell users. However, the specific object types you can search depend on:
Your user permissions
Features enabled on your company account
Contact your Shipwell administrator or support team if you need access to additional object types.
API Release Notes
Overview
This release introduces significant enhancements to carrier relationship management, shipment tracking, and access control. Key features include LTL carrier account terms support, enhanced ETA tracking with additional metadata, carrier rate configuration terms, and improved point of contact permissions. All changes are backward compatible and provide enhanced functionality for managing carrier relationships and shipment visibility.
New Features
Carrier Account Terms Support
We've added comprehensive support for carrier account terms across all quoting and shipment workflows, enabling better management of carrier-specific terms and conditions.
New Property:
carrier_account_terms(optional object) - Available in quotes and awarded quote objects
Key Capabilities:
Quote creation with terms: Include carrier-specific account terms when creating quotes
Terms management: Update and manage carrier terms during negotiations
Visibility: Access terms in all quote responses and on awarded shipments
Integration: Available across all quoting workflows and shipment endpoints
Affected Quote Types:
RFQ quotes
Spot negotiation quotes
Load board spot negotiation quotes
Private market negotiation quotes
Customer negotiation quotes
Enhanced ETA Tracking
We've significantly enhanced ETA (Estimated Time of Arrival) tracking capabilities with additional metadata properties for both carrier-specified and predictive model ETAs.
New ETA Properties:
For both carrier_specified_eta and predictive_model_eta:
eta_source(optional string) - Source of the ETA informationeta_status_text(optional string) - Human-readable status descriptionschedule_alert_code(optional string) - Alert code for schedule variances
Benefits:
Better visibility: Understand the source and confidence of ETA predictions
Proactive alerts: Schedule alert codes enable automated exception management
Dual tracking: Compare carrier-provided ETAs with predictive model estimates
Enhanced reporting: Additional context for delivery performance analysis
Availability:
All shipment stop endpoints (GET, POST, PUT)
Shipment creation and update endpoints
Purchase order and spot negotiation shipments
Load board and pickup endpoints
Carrier Rate Configuration Terms
Enhanced carrier relationship rate configuration with a new terms property for managing carrier-specific terms and conditions.
New Property:
terms(optional object) - Terms and conditions for carrier rate configuration
Endpoints:
GET /carrier-relationships/{carrierRelationshipId}/rate-configuration/POST /carrier-relationships/{carrierRelationshipId}/rate-configuration/
Point of Contact Access Control
New access control property for managing point of contact permissions across customer shipments.
New Property:
access_all_customer_shipments(optional boolean) - Grant point of contact access to all customer shipments
Affected Entities:
Address book entries
Carrier relationships
Shipment stop locations
Products with external pickup addresses
Supplier addresses
Enhanced Endpoints
Quoting Endpoints with Carrier Terms
RFQ Management:
POST /quoting/rfqs/- Create RFQs with carrier account termsPUT /quoting/rfqs/{rfqId}/- Update RFQs with termsPOST /quoting/rfqs/{rfqId}/quotes/- Create quotes with termsPUT /quoting/rfqs/{rfqId}/quotes/{quoteId}/- Update quote terms
Spot Negotiations:
POST /quoting/spotnegotiations/spot-negotiations/{spotNegotiationId}/quotes/- Create quotes with termsPUT /quoting/spotnegotiations/spot-negotiations/{spotNegotiationId}/quotes/{quoteId}/- Update termsAll spot negotiation GET endpoints return carrier account terms
Private Market:
POST /quoting/privatemarket/spot-negotiations/{spotNegotiationId}/quotes/- Create quotes with termsPUT /quoting/privatemarket/rfqs/{rfqId}/customer-negotiation/- Update negotiations with termsAll private market endpoints return terms in responses
Load Board:
POST /quoting/loadboard/{loadBoardShipmentId}/spot-negotiations/- Create negotiations with terms
Shipment Endpoints with Enhanced ETA
Shipment Management:
POST /shipments/- Create shipments with enhanced ETA propertiesPUT /shipments/{shipmentId}/- Update shipments with ETA metadataGET /shipments/,GET /shipments/{shipmentId}/- View enhanced ETA informationAll shipment action endpoints return enhanced ETA data
Stop Management:
POST /shipments/{shipmentId}/stops/- Create stops with enhanced ETAsPUT /shipments/{shipmentId}/stops/{stopId}/- Update stop ETAs with metadataGET /shipments/{shipmentId}/stops/- View stops with enhanced ETA tracking
Additional Coverage:
Purchase order shipment endpoints
Spot negotiation shipments
Carrier power unit shipments
Shipment pickup endpoints
Load board endpoints
Point of Contact Management
Address Book:
POST /address-book/- Create entries with access controlPUT /address-book/{addressBookId}/- Update access permissions
Carrier Relationships:
POST /carrier-relationships/- Create relationships with POC access controlPUT /carrier-relationships/{carrierRelationshipId}/- Update POC permissions
Shipment Integration:
All shipment endpoints now include
access_all_customer_shipmentsin point of contact objects
Usage Examples
Creating a Quote with Carrier Account Terms
POST /quoting/rfqs/{rfqId}/quotes/ { "carrier_account_terms": { "account_number": "LTL-ACC-12345", "contract_rate": true, "fuel_surcharge_program": "WEEKLY_DOE", "accessorial_terms": { "liftgate_delivery": 75.00, "residential_delivery": 85.00, "inside_delivery": 125.00 }, "payment_terms": "NET 30", "liability_coverage": "$100,000 per shipment" }, "rate": 850.00, // other quote properties... }
Viewing Enhanced ETA Information
GET /shipments/{shipmentId}/ { "id": "ship_12345", "stops": [ { "stop_type": "pickup", "carrier_specified_eta": { "datetime": "2024-01-15T14:00:00Z", "eta_source": "CARRIER_EDI", "eta_status_text": "On time - no delays expected", "schedule_alert_code": "ON_TIME" }, "predictive_model_eta": { "datetime": "2024-01-15T14:30:00Z", "eta_source": "ML_MODEL_V2", "eta_status_text": "Predicted slight delay based on traffic", "schedule_alert_code": "MINOR_DELAY" } } ] }
Creating Stop with Enhanced ETA Tracking
POST /shipments/{shipmentId}/stops/ { "stop_type": "delivery", "location": { "address": "123 Main St", "city": "Los Angeles", "state": "CA" }, "carrier_specified_eta": { "datetime": "2024-01-16T10:00:00Z", "eta_source": "CARRIER_API", "eta_status_text": "Confirmed by carrier dispatch", "schedule_alert_code": "CONFIRMED" }, "predictive_model_eta": { "datetime": "2024-01-16T09:45:00Z", "eta_source": "PREDICTIVE_MODEL", "eta_status_text": "High confidence prediction", "schedule_alert_code": "ON_TIME" } }
Setting Carrier Rate Configuration Terms
POST /carrier-relationships/{carrierRelationshipId}/rate-configuration/ { "items": [ { "terms": { "minimum_charge": 150.00, "fuel_surcharge_basis": "DOE_WEEKLY", "detention_free_time": 120, "detention_rate": 75.00, "contract_expiration": "2025-12-31", "volume_commitment": "100 shipments per month" }, // other rate configuration properties... } ] }
Managing Point of Contact Access
POST /address-book/ { "name": "Main Distribution Center", "address": "456 Warehouse Dr", "point_of_contacts": [ { "name": "John Smith", "email": "john.smith@example.com", "phone": "555-0123", "access_all_customer_shipments": true // Grant access to all shipments }, { "name": "Jane Doe", "email": "jane.doe@example.com", "phone": "555-0124", "access_all_customer_shipments": false // Restricted access } ] }
Viewing Shipment with Terms on Awarded Quote
GET /shipments/{shipmentId}/ { "id": "ship_12345", "most_recently_awarded_quote": { "id": "quote_67890", "rate": 850.00, "carrier_account_terms": { "account_number": "LTL-ACC-12345", "contract_rate": true, "payment_terms": "NET 30" } } // other shipment properties... }
Migration Guide
For Carrier Account Terms
No action required - All carrier account terms functionality is optional and additive.
To start using carrier account terms:
Include terms in quote creation: Add the optional
carrier_account_termsobject when creating quotesUpdate response parsing: Handle the new
carrier_account_termsfield in quote and shipment responsesLeverage in negotiations: Use terms to manage carrier-specific account conditions
Track awarded terms: Access terms on
most_recently_awarded_quotein shipment responses
For Enhanced ETA Tracking
No action required - Enhanced ETA properties are optional and additive.
To leverage enhanced ETA tracking:
Update ETA objects: Include new metadata when creating or updating stops:
const stop = { carrier_specified_eta: { datetime: etaDateTime, eta_source: "CARRIER_EDI", eta_status_text: "Confirmed delivery window", schedule_alert_code: "ON_TIME" } };
Process enhanced responses: Update your parsing logic to capture new ETA metadata:
const processStopETA = (stop) => { const carrierETA = stop.carrier_specified_eta; if (carrierETA) { console.log(`ETA Source: ${carrierETA.eta_source}`); console.log(`Status: ${carrierETA.eta_status_text}`); if (carrierETA.schedule_alert_code === "DELAY") { notifyCustomer(stop); } } };
Compare ETA sources: Leverage both carrier and predictive model ETAs for better accuracy
Implement alerts: Use
schedule_alert_codefor automated exception management
For Carrier Rate Configuration Terms
No action required - Terms property is optional and additive.
To use rate configuration terms:
Add terms to rate configs: Include the
termsobject when creating or updating rate configurationsUpdate response handling: Parse
termsfrom rate configuration responsesDocument carrier agreements: Use terms to store carrier-specific contract details
For Point of Contact Access Control
No action required - Access control property is optional and additive.
To implement POC access control:
Set access permissions: Include
access_all_customer_shipmentswhen creating or updating POCs:
const pointOfContact = { name: "Warehouse Manager", email: "manager@example.com", access_all_customer_shipments: true // or false for restricted };
Update permission logic: Use the flag in your access control systems
Review existing POCs: Consider updating existing point of contacts with appropriate permissions
Backward Compatibility
✅ Fully Compatible: All existing integrations will continue to work without modification.
✅ Optional Fields: All new properties (carrier_account_terms, ETA metadata, terms, access_all_customer_shipments) are optional and won't break existing parsing logic.
✅ Enhanced Responses: Additional data in responses is purely additive and maintains backward compatibility.
✅ Flexible Implementation: You can adopt new features gradually across different workflows without impacting existing functionality.
Description |
Breadcrumb hover detail |
Tive - Move Shipment State to delivered |
Script-Add Consolidation Cooler to existing integration |
Non IoT users side menu update |
Tive - Data Table - Simplified Device Selection |
Tive - Update Tracking Data Icon |
Refactor Shipments dashboard to use new Engine |
Samsara Fleet Tracking Missing Stop data |
Add MacroPoint ETA details to Shipment Details |
Add MacroPoint ETA text to ETA pill |
[ANDROID][5.3.15] NullPointerException in LaunchDarkly initialization |
Samsara Power Unit Sync Failing with 400 Error - After Release 25.14 |
Carriers unable to update/change Driver details on Shipments |
Enable SuiteApp to only require Shipwell marketplace configurability without any other BE work on Shipwell side |
Orders not properly reflecting status and shipment info alignment |
Leverage Factoring company object in First Pass Match process to match carrier / factor name if active in settlement |
Support 'By carrier' and 'By mode' options for settlement configurations and invoice exception criteria |
Implement 'By carrier' and 'By mode' options within First Pass Match |
FE - Support 'By carrier' and 'By mode' options for settlement configurations and invoice exception criteria |
Order Split Function - Mapping Quantity, Items, Weight Fields |
Update v3 order importer with a couple improvements |
Add support for Payment Terms configuration in Carrier Profile UI |
Routing guide trigger shipment creation not working |
[NetSuite SuiteApp] Improve error handling |
Add support for Payment Terms configuration in Shipment Customer Profile UI |
FAVR PATCH operations deleting payment-terms |
v3 Order new order / viewing / editing experience does not properly populate all choices for Item Unit for items |
New shipment creation experience is not passing along address book ID when present |
[NetSuite] erp-gateway address-book failures |
Add 'Uncancel' option to the new v3 over creation / edit / view experience |
Inability to Copy Carrier Financials to Shipper Financials ("Invalid Input Error") |
Map invoice and bill default line items fields for SuiteApp |
Appointment Lead Time Requirement not saving when an update has been made to the Dock Scheduling Facility. |
User Appointment Card Details view not refreshing when navigating away from the Uploaded Documents screen. |
Documents and Financials are not being sent to NetSuite |
Update to by mode and by carrier configuration to support include/exclude and future proof |
Delivery time changing when changing carrier on shipment |
Delivery times not showing on added order to shipment |
Customer Financial invoicing issue |
Error when connecting Fedex Parcel Account |
Correctly map P44 charge codes onto the shipment financials |
RXO carrier information disappeared-Unable to Tender |
RFP Lane Import Failure - "Lane not Recognized" Error for Valid Lane |
RFP Import Results Not Showing |
Custom carrier reference code number dropping after API update to "inactive" |
Add BOND accessorial to the FE UI when creating/editing shipments and quotes |