Business Days of Transit

About business days of transit

When you make a call to Shipium's Carrier and Method Selection service (whether getting a label or not), you can optionally provide a Business Days of Transit value in the API call. The businessDaysOfTransit is part of the shipmentParameters field. It takes an integer number of days as its value. Based on that value, it chooses a carrier and ship method that will hit a date calculated based on operating days for the fulfillment center (FC), also referred to as an origin in the Shipium platform, from which it is shipping. Business days refers to Monday through Friday weekdays and does not include holidays. The logic is roughly as follows.

Given a businessDaysOfTransit value of {BD} days:

  1. Check the shippedDateTime against the days of week that your origin ships.
    • This can be found in Configuration / Schedules configured for an origin in Configuration / Origins under the Shipping Days values.
  2. Check the shippedDateTime against the shipment cutoff time for your FC.
    • This can be found in Configuration / Schedules configured for an origin in Configuration / Origins under the Cutoff Time values.
  3. If the shippedDateTime is after the cutoff time or the date is a day that is not configured for shipping, then the effective ship date moves to the next business day. This is the first day after the shippedDateTime that is a day of week that the origin is configured to ship.
  4. From this date, add on {BD} business days, skipping over any non-business days to arrive at a delivery date.
  5. Select the least expensive carrier and ship method that is capable of hitting that delivery date based on the properties of the shipment, the origin address, and the destination address.

Business days of transit code sample

This example shows how to handle Business Days of Transit in API calls.

The following can be added to the shipment parameters when creating a shipment with ShipmentParameters or to the Carrier and Method Selection & Shipment Labels request within the shipment parameters: MegaShipmentProcessCreate.shipmentParameters.

"businessDaysOfTransit": 2

Business days of transit examples

Example 1: Monday shipment, before cutoff time, {BD} of 2 days

Example 1 inputs

Example 1 considers the following scenario:

JSON

{
  "shippedDateTime": "2022-01-03T06:30:00-07:00",
  "businessDaysOfTransit": 2
}

Example 1 output

In this case, the date that Shipium will attempt to hit is calculated as follows:

Example 2: Monday shipment, after cutoff time, {BD} of 2 days

Example 2 inputs

Example 2 considers the following scenario:

JSON

{
  "shippedDateTime": "2022-01-03T21:00:00-21:00",
  "businessDaysOfTransit": 2
}

Example 2 output

In this case, the date that Shipium will attempt to hit is calculated as follows:

Example 3: Wednesday shipment, before cutoff time, {BD} of 2 days

Example 3 inputs

Example 3 considers the following scenario:

JSON

{
  "shippedDateTime": "2022-01-05T06:30:00-07:00",
  "businessDaysOfTransit": 2
}

Example 3 output

In this case, the date that Shipium will attempt to hit is calculated as follows:

Example 4: Wednesday shipment, after cutoff time, {BD} of 2 days

Example 4 inputs

Example 4 considers the following scenario:

JSON

{
  "shippedDateTime": "2022-01-05T21:00:00-21:00",
  "businessDaysOfTransit": 2
}

Example 4 output

In this case, the date that Shipium will attempt to hit is calculated as follows:

Example 5: Saturday or Sunday shipment, before cutoff time, {BD} of 2 days

Example 5 inputs

Example 5 considers the following scenario:

JSON

{
  "shippedDateTime": "2022-01-08T06:30:00-07:00",
  "businessDaysOfTransit": 2
}

Example 5 output

In either the Saturday or the Sunday case, the date that Shipium will attempt to hit is calculated as follows:

Non-business day handling

The BDOT calculation skips non-business days when determining the target delivery date. Understanding what qualifies as a non-business day — and how holidays factor in — helps you predict how BDOT will behave for your shipments.

How BDOT calculates the delivery date

When you provide a businessDaysOfTransit value, Shipium converts it to a desired delivery date (DDD) internally. This conversion considers:

Business days for BDOT are always Monday through Friday, excluding country-observed holidays. This is because carriers typically move parcels every weekday, regardless of your fulfillment center's operating schedule.

Your origin's configured Shipping Days determine when the shipment leaves your warehouse (Day 0), but they do not change what counts as a business day during transit. For example, if your origin ships on Saturdays and you ship a package on Saturday, Saturday is Day 0. However, Saturday and Sunday are still skipped when counting business days of transit — Day 1 would be Monday.

Country holidays vs. carrier holidays

Once Shipium converts your BDOT value to a target delivery date, it evaluates available carrier service methods to find options that can meet that date. During this evaluation, carrier-specific holidays affect each service method's estimated delivery date.

This creates an important distinction:

Because carriers may observe different holidays than the national calendar, a service method's effective delivery date might differ from the BDOT-calculated target. Shipium prioritizes service methods that can meet the target delivery date based on their own holiday schedules.

Using BDOT with desiredDeliveryDate

You cannot use businessDaysOfTransit and desiredDeliveryDate in the same API request. These parameters represent two different approaches to targeting a delivery date:

If you include both parameters in a request, the API returns a validation error. Choose one approach based on your use case.

Example 6: Shipment spanning a country-observed holiday, {BD} of 2 days

Example 6 inputs

Example 6 considers the following scenario:

JSON

{
  "shippedDateTime": "2024-07-03T10:00:00-07:00",
  "businessDaysOfTransit": 2
}

Example 6 output

In this case, the target delivery date is calculated as follows:

Shipium then evaluates available service methods to find carriers that can deliver by Monday, July 8, factoring in each carrier's own holiday schedule.

Holidays by origin country

Shipium excludes nationally recognized holidays from business day calculations. The following holidays apply based on your origin country.

United States

Canada

Mexico