SLA & Transit Times¶
This guide covers how to configure estimated transit times for each country your courier operates in. These values define the delivery window shown to customers at checkout when they select your courier.
Prerequisites¶
- You are logged in as a courier owner (or a team member with
slawrite permission) - Your courier application has been approved
- You have at least one active country configured
- You can access the Config Hub from the courier home screen
Steps¶
Step 1: Navigate to SLA¶
Open the Config Hub and select the Country Operations tab. Tap SLA to open the transit time configuration screen.
Info
If you operate in multiple countries, use the country dropdown at the top of the Country Operations tab to select the country you want to configure. The page title shows "SLA — [Country Name]" to confirm your selection.
Step 2: Set minimum transit days¶
Enter the Min days value in the first field. This represents the fastest expected delivery time (in days) from dispatch to arrival for the selected country.
Tip
Use whole numbers only. This value represents the best-case delivery scenario — for example, orders dispatched early in the week with no delays.
Step 3: Set maximum transit days¶
Enter the Max days value in the second field. This represents the slowest expected delivery time (in days) from dispatch to arrival for the selected country.
Warning
The maximum transit days must be greater than or equal to the minimum transit days. If you enter a max value lower than the min value, the system will show an error: "Max days must be ≥ min days".
Step 4: Save SLA¶
Tap the Save SLA button at the bottom of the screen to persist your transit time configuration. A confirmation message "SLA saved" appears on success.
Result¶
After configuring SLA transit times:
- The values are stored on the courier_countries record for the selected country
- During checkout, customers see the estimated delivery window displayed as "Estimated delivery: X–Y days" when selecting your courier
- SLA configurations are per-country — switching countries in the country dropdown loads that country's transit time values
- Team members with
slaread permission (but not write) can view the configured values but cannot edit them
Troubleshooting¶
| Issue | Cause | Solution |
|---|---|---|
| "Max days must be ≥ min days" error | The maximum transit days value is lower than the minimum | Enter a max days value that is equal to or greater than the min days value. |
| Fields are disabled / cannot edit | Your role does not have sla write permission |
Ask the courier owner to grant you sla write permission in Roles & Permissions. |
| Values not showing at checkout | SLA fields are empty (not saved) for the country | Enter both min and max transit days and tap Save SLA. |
| Wrong country's values displayed | The country selector is set to a different country | Use the country dropdown at the top of Country Operations to switch to the correct country. |
Related Guides¶
- Delivery Zones — configure geographic coverage for door-to-door delivery
- Pricing — set up the cost structure customers see alongside transit times
- Escalation & Alerts — configure automated alerts when orders exceed expected transit times