Summary
Performance Aspirations lets you define the transit time you expect from each service provider, such as carriers, warehouses and distribution centres, or from any leg of the shipment journey, and measures every matching shipment against it automatically. Each shipment is marked compliant or breached on your own terms: your working days, cut-off times, public holidays and timezone.Who it’s for
Logistics teams whose SLA report is rebuilt by hand every month, or whose transit time numbers never match what was agreed with the carrier because they count calendar days. Data and IT teams use the results through the API and webhook to feed their own scorecards.Key benefits
- Compliance becomes a result, not a project. Every shipment is evaluated the moment it reaches the end milestone of its category, with no manual tracking.
- Measured on your calendar, not the carrier’s. Each rule carries its own working days, per-day cut-off times, public holidays by origin or destination country, and timezone.
- Each provider is measured on its own leg. Categories are built from a start and an end milestone, so a warehouse, a carrier, customs or the last mile can each carry its own standard.
- Rules go live in minutes. Create rules one at a time in the portal or hundreds at once by CSV, and change them yourself when a carrier changes its commitments.
- One standard, carried through. The same rules power compliance charts in Business Intelligence, a transit time metric in AI Performance Alerts and the SLA breach rate in AI Recommendations.
How it works
Performance Aspirations is configuration before it is output: a category, a rule, a calendar. The first time it is switched on, a sample Warehouse category with draft rules is created so you have something to start from.Categories
A category is any leg of the journey you want to measure. You name it and pick its start and end milestone, and that pair is what starts and stops the clock. A category can represent a type of service provider or a stretch of the journey:
You can edit a category’s name or milestones at any time; updates apply only to shipments not yet evaluated. A category can be deleted only while all its rules are in Draft status, and deleting it removes those draft rules.
Milestones
Categories are built from 13 standard milestones: 9 that fire in sequence from order placed through to final delivery, and 4 that fire independently.
The sequential chain is kept in chronological order, so inaccurate carrier data cannot produce a negative transit time. Where your own start or end event maps to none of the standard milestones, up to 5 custom milestones per organisation can be built by Perform.AI and then selected like any other.
Rules
A rule is the expected transit time for a specific slice of shipments within a category. You name each rule, so the list reads like your own network: USPS US Domestic, DHL China to North America, FedEx International.
Rule matching. A shipment must match all of a rule’s filters. When several rules match, the most specific rule applies first; equally specific rules are ordered by priority, and if no priority is set the earliest-created rule wins. Rules are normally written to be mutually exclusive, so priority is an edge case rather than part of the standard setup.
Rule status. A rule is either Draft (not evaluating) or Active (evaluating matching shipments). Activating starts calculation for shipments that reach the end milestone from then on; deactivating returns the rule to Draft and stops it for future shipments. Only Draft rules can be deleted, so an Active rule has to be deactivated first. Editing a rule never recalculates shipments already evaluated.
The business calendar
Measured transit time is counted in working days only, using the rule’s calendar:- Non-working days are not counted.
- When the start milestone falls after the day’s cut-off time, the count begins on the next working day.
- Public holidays in the origin country, the destination country or both are excluded, depending on the rule.
- All milestone timestamps are converted to the rule’s timezone before the calculation, so cut-offs and day boundaries reflect where the operation runs.
Bulk management by CSV
Within a category, Upload File opens a dialog with a downloadable CSV template and a setup guide covering the concepts, worked examples and what each field does. The file is validated on upload for format and size. On success you choose Close (new rules created as Draft) or Activate (new rules created and set Active). On failure you download an error report, the original data with an error column, fix it and re-upload. A row with a rule ID updates that rule; a row without one creates a new rule. To update a carrier’s commitments after a network change, export the category’s rules, edit the values and re-upload. Selecting rules in the list enables bulk Export, Activate, Deactivate and Delete. Delete skips any Active rules in the selection. When every rule is selected, you choose whether the action applies to the current page or to all rules in the category.Results
A shipment is evaluated when it reaches the end milestone of a matching category. Shipments still in transit have no result yet.- Shipment Details. A Performance Aspirations section lists, per evaluation, the category, the rule that matched, the start and end milestone, the expected result, the measured result and the outcome. Hover the expected and measured results to see the transit time values.
- Tags. Each evaluated shipment carries a compliant or breached tag named after its category. Use it in shipment filters, chart filters and alert filters.
- Business Intelligence. The Transit Time (Performance Aspirations) and On-time rate (Performance Aspirations) report templates and every chart prefixed (Performance Aspirations) run on the measured transit time. Apply the Performance Aspirations category filter to read one category at a time. Charts include compliance scorecards, a compliance rate map by country and a performance-by-market table.
- AI Performance Alerts. The Transit Time (Performance Aspirations) metric, as an average, median, P90 or P95, filtered to one category.
- AI Recommendations. The SLA breach rate metric is calculated from your rules.
- API and webhook. From API and webhook version 5.3.0, the shipment payload carries one object per evaluation with the category name, rule name, outcome, expected and measured transit time with its unit, the start and end milestone types and timestamps, and the evaluation date. A shipment with no evaluations, or still in transit, returns an empty array.
Set up in the portal
Go to AI Decision Intelligence > Performance Aspirations.- Select Create, enter a category name and choose the Start Milestone and End Milestone, then Save.
- Within the category, select Create Rule. Name the rule, add the filters that identify the shipments it covers, set the working days, cut-off time, timezone and public holiday setting, and enter the expected transit time.
- Save to keep the rule as a draft, or Activate to start evaluating shipments immediately.
- To load many rules at once, select Upload File, download the CSV template, fill it in and upload it. Choose Activate to set the new rules live.
- Open a delivered shipment in Shipment Overview and check the Performance Aspirations section in its details.
- In Business Intelligence, create a report from the Transit Time (Performance Aspirations) or On-time rate (Performance Aspirations) template, and in AI Performance Alerts add an alert on the Transit Time (Performance Aspirations) metric for the categories you want watched.
Use via API and MCP
Performance Aspirations results travel with the shipment:- Retrieve a shipment and the shipment update webhook return the evaluations for a shipment from version 5.3.0.
- Through MCP, the tools
list_performance_categories,list_performance_rules,get_performance_ruleandlist_comply_milestonesread your categories, rules and the milestones available to build them, andget_shipment_detailsreturns a shipment’s results. See MCP tools.