"Your order will arrive in X business days" (For real)
Guarantee accurate and reliable delivery timelines. Calculate exact dates considering holidays at both origin and destination cities.
The "Business Day" Problem
In e-commerce, customer satisfaction depends on on-time delivery. If your checkout promises "5 business days", it must account for:
Origin (Dispatch)
Holidays at the warehouse location affect when the order can be shipped out.
Transit
Carriers and transport providers operate under special schedules during state holidays.
Destination (Delivery)
Local municipal holidays at the destination address can delay final receipt.
How to Solve with the API
- 1
Receive Customer ZIP Code
Identify the municipality’s 7-digit IBGE code.
- 2
Check Holidays in Timeframe
Verify upcoming holidays at both origin and destination cities.
- 3
Add Buffer Days Automatically
If there is a holiday, add +1 business day to the final displayed deadline.
Simple Integration
Our API returns complete holiday calendars and essential metadata for your shipping calculations. Simulate a delivery from São Paulo to Curitiba:
- Check holidays at origin (Dispatch)
- Check holidays at destination (Delivery)
- Add automatic safety buffer
// 1. Check Origin (São Paulo)
const origin = await api.get(
`/feriados/cidade/3550308?data=${dispatchDate}`
);
// 2. Check Destination (Curitiba)
const destination = await api.get(
`/feriados/cidade/4106902?data=${deliveryDate}`
);
if (origin.length > 0 || destination.length > 0) {
deliveryDays += 1; // Add +1 business day
}