Trigger: A new subscription is created, or an existing subscription is modified (plan change, add-on, cancellation) via Recurly's subscription.created, subscription.updated, or subscription.canceled webhook.
Context/Data Pulled: The AI agent ingests the full subscription object, including:
- Plan code, unit amount, and billing cycle.
- Any add-ons, discounts, or coupons applied.
- Contract start date, term length, and any trial period.
- For modifications, the previous subscription state and effective date of change.
Model or Agent Action: The agent analyzes the contract terms against configured revenue recognition policies (e.g., ratable over term, upfront for setup fees). It constructs or updates a detailed revenue schedule, calculating:
- The total contract value (TCV) and performance obligations.
- The monthly (or periodic) recognizable revenue amount.
- Adjustments for mid-term modifications (catch-ups or true-ups).
System Update or Next Step: The generated schedule is posted as a structured data object (JSON) to a designated endpoint, which could be:
- A custom object within Recurly via its API for internal tracking.
- Directly into the general ledger of an integrated ERP (e.g., NetSuite, Sage Intacct) via a middleware layer.
- A dedicated revenue management database for audit and reporting.
Human Review Point: For any contract with non-standard terms, custom pricing, or significant modifications, the schedule is flagged for finance team review within a designated dashboard before final posting.