Skip to main content
The Schedule is the system that generates projected future orders based on subscription configurations. It calculates when orders should be created by analyzing subscription items’ billing intervals, delivery frequencies, and associated discounts. The schedule groups subscription items that share common delivery methods, addresses, and payment methods into cohesive orders, and applies schedule adjustments that can modify orders during generation using workflow conditions and actions. The schedule also handles dynamic pricing calculations, such as shipping costs, and respects recurring cycle limits for both items and discounts. This allows operators and subscribers to preview upcoming orders and understand the projected billing and fulfillment timeline.

​
Schedule adjustments

Schedule adjustments allow modification of individual schedule orders. Each adjustment consists of a matcher (to identify which order to modify) and an action (what modification to apply). Common adjustments include skipping an order (SKIP_ORDER) or changing its scheduled date (CHANGE_DATE). You can match orders by their billing cycle, a specific date, or both. For a detailed breakdown of available actions and matchers, see the Schedule adjustment resource.

​
Schedule orders

Schedule orders are the projected future orders generated by the schedule system. Each schedule order represents a planned transaction that will occur at a specific date based on the subscription’s billing cycle. Schedule orders contain:
  • Items: The products or services that will be included in the order, with quantities, pricing, and product information
  • Discounts: Applied discounts that affect the order’s pricing, including item-level and shipping discounts
  • Delivery information: Delivery address, shipping method, and calculated shipping costs
  • Payment information: Payment method and billing address associated with the order
  • Pricing details: Calculated subtotal, delivery price, and total amounts after discounts
  • Cycle index: The billing cycle number this order represents in the subscription’s lifecycle
  • Metadata: Custom attributes, notes, and other order-specific information
Schedule orders can be modified by schedule adjustments during generation, can be marked as skipped, and may represent prepaid orders (where multiple cycles are paid in advance). They serve as a preview of upcoming orders before they are actually created and processed.

​
Diagram