How to Manage Shipping Date Calendar Rules

What This Task Does

This task creates or updates calendar rules that control valid pickup or delivery dates.

Use it when the business needs to block invalid dates or allow dates only under certain conditions.

Before You Start

Make sure:

• you know what date behavior should be allowed or blocked
• you know whether the rule should be active immediately
• you understand the difference between prerequisites and validations

Steps

1. Go to Settings > Calendar Rules.
2. Create a new rule with bilingual titles and the correct entity type, or open an existing rule.
3. Review or update the basic information:
   • English title
   • French title
   • active state
4. Add the conditions the rule needs:
   • prerequisites for when the rule should apply
   • validations for which dates are valid
   • the correct operator and form values for each condition
5. Save the rule.
6. Test a real shipment flow with a date that should pass and a date that should fail.

What Happens Next

After the rule is active:

• shipment pickup or delivery date validation can change immediately
• users can see a new validation message when they pick an invalid date
• Pyle can suggest the next available date

Common Mistakes

• Creating the rule but leaving it inactive.
• Putting logic in the wrong condition scope.
• Testing the rule without matching the shipment context it was designed for.

Related Guides

• Fulfillment & Shipping
• Calendar Rules
• How to choose a shipping service on an order

Sources

• packages/admin/routes/web.php
• packages/admin/src/Livewire/Admin/Settings/CalendarRules/CreateDialog.php
• packages/admin/src/Livewire/Admin/Settings/CalendarRule/BasicInformationBlock.php
• packages/admin/src/Livewire/Admin/Settings/CalendarRule/Conditions/CreateDialog.php
• packages/framework/src/Rules/CalendarRuleValidation.php