Hierarchical structure
The data architecture of a plan mirrors that of a contract. It is organized into a nested hierarchy that allows for complex, multi-stage commercial agreements.- Plan: The top-level container for a standardized offering.
- Phases: Temporal segments within the plan. For example, a “Scale-up plan” might have an introductory phase for the first three months followed by a standard growth phase.
- Products: The specific units of value included in each phase, such as subscription seats or API units.
- Features: Modifiers applied to the products or the phase, such as localized tax rules (e.g., Avalara), volume discounts, or specific payment terms.
Plans versus contracts
The distinction between a plan and a contract is the difference between a blueprint and a physical building.The abstraction layer
Reusing a contract as a template for another customer is architecturally risky, as it carries over customer-specific metadata, billing cycles, and potentially sensitive custom terms. Plans provide an abstraction layer, allowing you to iterate on your “Premium annual” or “Usage-based” models without affecting the historical data of existing contracts.The plan lifecycle
Plans follow a straightforward lifecycle designed to transition from a theoretical model to an active customer agreement:- Definition: You define the phases, products, and features that constitute the standard offering.
- Importation: When a new customer signs, you import the relevant plan into a new contract. Zenskar automatically populates the contract with the plan’s hierarchy.
- Specialization: Once imported, the contract can be customized. You can override specific pricing, add one-time setup fees, or adjust dates to fit the unique requirements of that customer without altering the original plan.
Next steps:
- To create a contract from an existing plan, see how to create a contract from a plan.
- To understand how a plan’s phases, products, and features fit together, see contract: concepts.