Revenue Lifecycle Management
This skill activates when a practitioner needs to implement the native Salesforce Revenue Lifecycle Management (RLM) product — the Revenue Cloud order-to-cash engine distinct from the CPQ managed package. It covers Dynamic Revenue Orchestrator (DRO) for order decomposition, asset amendments, billing schedule creation, and invoice management. It does NOT cover CPQ quoting, pricing rules, or the legacy blng__* Salesforce Billing managed package objects.
Before Starting
Gather this context before working on anything in this domain:
- Revenue Lifecycle Management (RLM) is a native Revenue Cloud product, completely distinct from CPQ + Salesforce Billing (managed package). RLM uses standard Salesforce objects (Order, OrderItem, BillingSchedule, Invoice). CPQ uses custom managed objects (blng__*, SBQQ__*). These are different products with different object models.
- Billing schedules in RLM are created via Connect API POST after order activation — they do NOT auto-update when an asset amendment order is activated. Each amendment produces a net-new BillingSchedule record requiring manual reconciliation.
- Dynamic Revenue Orchestrator (DRO) decomposes a commercial order into technical fulfillment orders routed across swimlanes (billing, provisioning, shipping) using auto-tasks, callouts, manual tasks, milestones, and pauses.
Core Concepts
Revenue Lifecycle Management vs. CPQ + Salesforce Billing
| Dimension |
RLM (Native Revenue Cloud) |
CPQ + Salesforce Billing |
| Object model |
Standard API objects (Order, BillingSchedule, Invoice) |
Managed package objects (SBQQ__*, blng__*) |
| Quoting |
Product Catalog + Pricing engine |
CPQ Quote, Quote Line, Price Rules |
| Fulfillment |
Dynamic Revenue Orchestrator |
Salesforce Billing DRE (different engine) |
| Billing schedules |
Created via Connect API POST |
blng__BillingSchedule__c, auto-created |
| Amendments |
Asset Lifecycle Management |
SBQQ__Amendment pattern |
These are not interchangeable. Code, SOQL, flows, and automation built for one product does NOT work for the other.
Dynamic Revenue Orchestrator (DRO)
DRO is the fulfillment engine in RLM. When a commercial order is activated, DRO creates a fulfillment plan that decomposes the order into technical fulfillment orders. Each fulfillment order is routed across configurable swimlanes (e.g., billing, provisioning, shipping).
Swimlane steps can include:
| Step type |
Role |
| Auto-tasks |
Automated Apex or integration callouts. |
| Manual tasks |
Human review steps. |
| Callouts |
External system notifications. |
| Milestones |
Synchronization points across swimlanes. |
| Pauses |
Wait states pending external completion signals. |
DRO enables parallel processing of fulfillment activities that can proceed independently while maintaining synchronization at milestones.
Billing Schedule Creation
Unlike legacy Salesforce Billing, RLM does NOT automatically create billing schedules on order activation. After an order is activated, billing schedules must be explicitly created via a Connect API POST call. The request specifies the OrderItem, start date, billing period, and amount.
Critically: when an asset amendment order is activated, it does NOT auto-update existing BillingSchedule records. Instead, a net-new BillingSchedule record is created for the amended asset. Reconciling billing schedules across the full asset lifecycle requires explicit aggregation logic.
Asset Lifecycle Management
Assets in RLM represent contracted products post-order. The asset lifecycle follows: Order Activated → Asset Created → Asset Amendment → Renewal. Each asset amendment generates a new Order and new fulfillment plan through DRO.
Invoice Management
Invoices in RLM are standard Invoice objects (not blng__Invoice__c). Invoice generation is triggered from BillingSchedule milestones. Invoice posting creates FinanceTransaction records (read-only accounting journal entries). Payments are tracked via the Payment standard object.
Common Patterns
Pattern 1: Configure a DRO Fulfillment Plan with Parallel Swimlanes
When to use: A commercial order requires parallel execution of billing setup, provisioning, and shipping steps.
How it works:
- In Revenue Cloud Setup > Dynamic Revenue Orchestrator, create a Fulfillment Plan.
- Add Swimlanes: "Billing", "Provisioning", "Shipping".
- Within each swimlane, define steps:
- Billing: Auto-task (Create Billing Schedule via Connect API), then Milestone "Ready to Invoice"
- Provisioning: Callout to provisioning system, Manual Task (provisioning confirmation), Milestone "Provisioned"
- Shipping: Auto-task (generate shipping label), Callout to fulfillment partner
- Define cross-swimlane synchronization: shipping starts after "Provisioned" milestone.
- Assign the Fulfillment Plan to the product catalog entries that trigger this plan.
Why not use a single sequential flow: Parallel swimlanes cut fulfillment cycle time significantly when billing, provisioning, and shipping can proceed concurrently.
Pattern 2: Create a Billing Schedule via Connect API
When to use: An order has been activated and requires billing schedule creation.
How it works:
# POST to Connect API BillingSchedule resource
import requests
headers = {
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json"
}
payload = {
"orderItemId": "801...", # OrderItem ID
"billingStartDate": "2026-05-01",
"billingFrequency": "Monthly",
"numberOfBillingPeriods": 12,
"amount": 1200.00
}
resp = requests.post(
f"{instance_url}/services/data/v63.0/commerce/billing/schedules",
headers=headers,
json=payload
)
billing_schedule = resp.json()
Why not use standard Salesforce Billing objects: RLM uses standard API objects, not blng__* managed-package objects. blng__BillingSchedule__c is for the legacy Salesforce Billing product — using it in an RLM org will not link to native Revenue Cloud billing flows.
Decision Guidance
| Situation |
Recommended Approach |
Reason |
| CPQ quoting, pricing rules, discount schedules |
Use cpq-* skills |
Completely separate product, different objects |
| Order decomposition into fulfillment steps |
Dynamic Revenue Orchestrator (DRO) |
Native RLM fulfillment engine |
| Create billing schedule after order activation |
Connect API POST |
RLM does not auto-create billing schedules |
| Asset amendment billing reconciliation |
Aggregate BillingSchedule records by Asset |
Amendment creates new BillingSchedule, not update |
| Invoice generation |
Configure BillingSchedule milestone triggers |
Invoice generation flows from BillingSchedule milestones |
| Legacy Salesforce Billing (blng__*) |
Use billing-schedule-setup skill |
Separate product, separate workflow |
Recommended Workflow
- Confirm the org is enabled for Revenue Cloud (RLM) — check Setup > Revenue Cloud — and distinguish from CPQ/Salesforce Billing.
- Design the product catalog (Product Catalog and Pricing in Revenue Cloud Setup) before configuring DRO.
- Create DRO Fulfillment Plan: define swimlanes and steps (auto-tasks, callouts, manual tasks, milestones, pauses).
- Assign the Fulfillment Plan to relevant product catalog entries.
- After order activation, create billing schedules via Connect API POST for each OrderItem that requires billing.
- For asset amendments: activate the amendment order, then create net-new BillingSchedule records for amended assets via Connect API. Do not expect auto-update of existing schedules.
- Configure invoicing and monitor fulfillment. Configure Invoice generation from BillingSchedule milestone triggers; monitor DRO fulfillment plan execution via the Revenue Cloud Fulfillment Dashboard.
Review Checklist
Salesforce-Specific Gotchas
RLM and CPQ + Salesforce Billing Are Completely Different Products — The most damaging LLM error is conflating these two product lines. blng__BillingSchedule__c is not the same as the standard BillingSchedule object. Code, flows, and SOQL from one product does not work in the other. Always confirm which product is in use before writing any code.
Billing Schedules Are Not Auto-Created on Order Activation — Unlike legacy Salesforce Billing, RLM does not automatically create BillingSchedule records when an order activates. This is an explicit Connect API call that must be coded or configured. Missing this step leaves orders with no billing schedule.
Amendment Orders Create New BillingSchedule Records — Activating an asset amendment order does NOT update the existing BillingSchedule — it creates a net-new one. Billing reconciliation across amendments requires aggregating all BillingSchedule records for a given asset.
FinanceTransaction Is Read-Only — FinanceTransaction records are system-generated accounting journal entries created when an Invoice is posted or a Payment is received. They cannot be created, updated, or deleted via API. Attempting to DML FinanceTransaction records causes errors.
DRO Swimlane Step Errors Do Not Auto-Retry — If a DRO auto-task or callout step fails (e.g., an Apex auto-task throws an exception), the DRO plan stalls at that step. There is no automatic retry. Operators must review the DRO dashboard, resolve the root cause, and manually resume the fulfillment plan.
Output Artifacts
| Artifact |
Description |
| DRO Fulfillment Plan design |
Swimlane configuration with step types and milestone synchronization |
| Billing schedule creation script |
Connect API POST implementation for post-activation billing setup |
| Amendment billing reconciliation query |
SOQL/query pattern to aggregate BillingSchedule records across asset lifecycle |
| RLM vs. CPQ disambiguation guide |
Checklist to confirm which product is in use before beginning implementation |
Related Skills
- revenue-cloud-data-model — for native Revenue Cloud object relationships (BillingSchedule, Invoice, FinanceTransaction)
- revenue-cloud-architecture — for order-to-cash architecture design across Revenue Cloud domains
- billing-schedule-setup — for legacy Salesforce Billing managed package (blng__*) billing schedules
1---2name: revenue-lifecycle-management3description: "Use this skill when implementing or troubleshooting Salesforce Revenue Lifecycle Management (RLM) — the native Revenue Cloud product covering order-to-cash lifecycle, Dynamic Revenue Orchestrator (DRO) fulfillment plan design, asset amendments, billing schedule creation via Connect API, and invoice management. Triggers on: Dynamic Revenue Orchestrator, RLM order decomposition, DRO fulfillment swimlanes, native Revenue Cloud billing schedule, asset lifecycle management Salesforce. NOT for the overall Revenue Cloud domain architecture or the RLM vs CPQ-classic vs legacy blng__ Billing product choice — use architect/revenue-cloud-architecture. NOT for querying the BillingSchedule / Invoice / FinanceTransaction objects and their relationships — use data/revenue-cloud-data-model."4category: integration5salesforce-version: "Spring '25+"6well-architected-pillars:7 - Reliability8 - Scalability9tags:10 - revenue-cloud11 - rlm12 - dynamic-revenue-orchestrator13 - dro14 - order-to-cash15 - billing-schedule16 - asset-lifecycle17 - invoice-management18 - fulfillment19inputs:20 - "Revenue Cloud (RLM) enabled org"21 - "Order and OrderItem records (native Salesforce objects, not CPQ)"22 - "Dynamic Revenue Orchestrator fulfillment plan definition"23 - "Connect API credentials for billing schedule creation"24outputs:25 - "DRO fulfillment plan with swimlane configuration"26 - "Billing schedule created via Connect API POST"27 - "Asset amendment order design"28 - "Invoice management workflow"29triggers:30 - "Dynamic Revenue Orchestrator DRO fulfillment plan setup"31 - "RLM billing schedule not created automatically"32 - "native Revenue Cloud vs Salesforce Billing difference"33 - "DRO stalled swimlane troubleshooting"34 - "asset amendment creates new BillingSchedule"35dependencies: []36version: 1.0.037author: Pranav Nagrecha38updated: 2026-04-2839metadata:40 source: https://skillmd.com/skills/pranavnagrecha/revenue-lifecycle-management41---4243# Revenue Lifecycle Management4445This skill activates when a practitioner needs to implement the native Salesforce Revenue Lifecycle Management (RLM) product — the Revenue Cloud order-to-cash engine distinct from the CPQ managed package. It covers Dynamic Revenue Orchestrator (DRO) for order decomposition, asset amendments, billing schedule creation, and invoice management. It does NOT cover CPQ quoting, pricing rules, or the legacy blng__* Salesforce Billing managed package objects.4647---4849## Before Starting5051Gather this context before working on anything in this domain:5253- Revenue Lifecycle Management (RLM) is a native Revenue Cloud product, completely distinct from CPQ + Salesforce Billing (managed package). RLM uses standard Salesforce objects (Order, OrderItem, BillingSchedule, Invoice). CPQ uses custom managed objects (blng__*, SBQQ__*). These are different products with different object models.54- Billing schedules in RLM are created via Connect API POST after order activation — they do NOT auto-update when an asset amendment order is activated. Each amendment produces a net-new BillingSchedule record requiring manual reconciliation.55- Dynamic Revenue Orchestrator (DRO) decomposes a commercial order into technical fulfillment orders routed across swimlanes (billing, provisioning, shipping) using auto-tasks, callouts, manual tasks, milestones, and pauses.5657---5859## Core Concepts6061### Revenue Lifecycle Management vs. CPQ + Salesforce Billing6263| Dimension | RLM (Native Revenue Cloud) | CPQ + Salesforce Billing |64|---|---|---|65| Object model | Standard API objects (Order, BillingSchedule, Invoice) | Managed package objects (SBQQ__*, blng__*) |66| Quoting | Product Catalog + Pricing engine | CPQ Quote, Quote Line, Price Rules |67| Fulfillment | Dynamic Revenue Orchestrator | Salesforce Billing DRE (different engine) |68| Billing schedules | Created via Connect API POST | blng__BillingSchedule__c, auto-created |69| Amendments | Asset Lifecycle Management | SBQQ__Amendment pattern |7071These are not interchangeable. Code, SOQL, flows, and automation built for one product does NOT work for the other.7273### Dynamic Revenue Orchestrator (DRO)7475DRO is the fulfillment engine in RLM. When a commercial order is activated, DRO creates a **fulfillment plan** that decomposes the order into technical fulfillment orders. Each fulfillment order is routed across configurable **swimlanes** (e.g., billing, provisioning, shipping).7677Swimlane steps can include:7879| Step type | Role |80|---|---|81| Auto-tasks | Automated Apex or integration callouts. |82| Manual tasks | Human review steps. |83| Callouts | External system notifications. |84| Milestones | Synchronization points across swimlanes. |85| Pauses | Wait states pending external completion signals. |8687DRO enables parallel processing of fulfillment activities that can proceed independently while maintaining synchronization at milestones.8889### Billing Schedule Creation9091Unlike legacy Salesforce Billing, RLM does NOT automatically create billing schedules on order activation. After an order is activated, billing schedules must be explicitly created via a **Connect API POST** call. The request specifies the OrderItem, start date, billing period, and amount.9293Critically: when an asset amendment order is activated, it does NOT auto-update existing BillingSchedule records. Instead, a net-new BillingSchedule record is created for the amended asset. Reconciling billing schedules across the full asset lifecycle requires explicit aggregation logic.9495### Asset Lifecycle Management9697Assets in RLM represent contracted products post-order. The asset lifecycle follows: Order Activated → Asset Created → Asset Amendment → Renewal. Each asset amendment generates a new Order and new fulfillment plan through DRO.9899### Invoice Management100101Invoices in RLM are standard Invoice objects (not blng__Invoice__c). Invoice generation is triggered from BillingSchedule milestones. Invoice posting creates FinanceTransaction records (read-only accounting journal entries). Payments are tracked via the Payment standard object.102103---104105## Common Patterns106107### Pattern 1: Configure a DRO Fulfillment Plan with Parallel Swimlanes108109**When to use:** A commercial order requires parallel execution of billing setup, provisioning, and shipping steps.110111**How it works:**1121131. In Revenue Cloud Setup > Dynamic Revenue Orchestrator, create a Fulfillment Plan.1142. Add Swimlanes: "Billing", "Provisioning", "Shipping".1153. Within each swimlane, define steps:116 - Billing: Auto-task (Create Billing Schedule via Connect API), then Milestone "Ready to Invoice"117 - Provisioning: Callout to provisioning system, Manual Task (provisioning confirmation), Milestone "Provisioned"118 - Shipping: Auto-task (generate shipping label), Callout to fulfillment partner1194. Define cross-swimlane synchronization: shipping starts after "Provisioned" milestone.1205. Assign the Fulfillment Plan to the product catalog entries that trigger this plan.121122**Why not use a single sequential flow:** Parallel swimlanes cut fulfillment cycle time significantly when billing, provisioning, and shipping can proceed concurrently.123124### Pattern 2: Create a Billing Schedule via Connect API125126**When to use:** An order has been activated and requires billing schedule creation.127128**How it works:**129130```python131# POST to Connect API BillingSchedule resource132import requests133134headers = {135 "Authorization": f"Bearer {access_token}",136 "Content-Type": "application/json"137}138139payload = {140 "orderItemId": "801...", # OrderItem ID141 "billingStartDate": "2026-05-01",142 "billingFrequency": "Monthly",143 "numberOfBillingPeriods": 12,144 "amount": 1200.00145}146147resp = requests.post(148 f"{instance_url}/services/data/v63.0/commerce/billing/schedules",149 headers=headers,150 json=payload151)152billing_schedule = resp.json()153```154155**Why not use standard Salesforce Billing objects:** RLM uses standard API objects, not blng__* managed-package objects. blng__BillingSchedule__c is for the legacy Salesforce Billing product — using it in an RLM org will not link to native Revenue Cloud billing flows.156157---158159## Decision Guidance160161| Situation | Recommended Approach | Reason |162|---|---|---|163| CPQ quoting, pricing rules, discount schedules | Use cpq-* skills | Completely separate product, different objects |164| Order decomposition into fulfillment steps | Dynamic Revenue Orchestrator (DRO) | Native RLM fulfillment engine |165| Create billing schedule after order activation | Connect API POST | RLM does not auto-create billing schedules |166| Asset amendment billing reconciliation | Aggregate BillingSchedule records by Asset | Amendment creates new BillingSchedule, not update |167| Invoice generation | Configure BillingSchedule milestone triggers | Invoice generation flows from BillingSchedule milestones |168| Legacy Salesforce Billing (blng__*) | Use billing-schedule-setup skill | Separate product, separate workflow |169170---171172## Recommended Workflow1731741. Confirm the org is enabled for Revenue Cloud (RLM) — check Setup > Revenue Cloud — and distinguish from CPQ/Salesforce Billing.1752. Design the product catalog (Product Catalog and Pricing in Revenue Cloud Setup) before configuring DRO.1763. Create DRO Fulfillment Plan: define swimlanes and steps (auto-tasks, callouts, manual tasks, milestones, pauses).1774. Assign the Fulfillment Plan to relevant product catalog entries.1785. After order activation, create billing schedules via Connect API POST for each OrderItem that requires billing.1796. For asset amendments: activate the amendment order, then create net-new BillingSchedule records for amended assets via Connect API. Do not expect auto-update of existing schedules.1807. **Configure invoicing and monitor fulfillment.** Configure Invoice generation from BillingSchedule milestone triggers; monitor DRO fulfillment plan execution via the Revenue Cloud Fulfillment Dashboard.181182---183184## Review Checklist185186- [ ] Org confirmed as Revenue Cloud (RLM), not CPQ + Salesforce Billing187- [ ] DRO Fulfillment Plan defined with appropriate swimlanes and step types188- [ ] Billing schedules created via Connect API POST after order activation189- [ ] Amendment workflow documented: amendment creates new BillingSchedule, not update190- [ ] FinanceTransaction records (read-only) reviewed for accounting journal validation191- [ ] No blng__* or SBQQ__* objects used in RLM code or flows192- [ ] Invoice generation configured from BillingSchedule milestones193194---195196## Salesforce-Specific Gotchas1971981. **RLM and CPQ + Salesforce Billing Are Completely Different Products** — The most damaging LLM error is conflating these two product lines. blng__BillingSchedule__c is not the same as the standard BillingSchedule object. Code, flows, and SOQL from one product does not work in the other. Always confirm which product is in use before writing any code.1992002. **Billing Schedules Are Not Auto-Created on Order Activation** — Unlike legacy Salesforce Billing, RLM does not automatically create BillingSchedule records when an order activates. This is an explicit Connect API call that must be coded or configured. Missing this step leaves orders with no billing schedule.2012023. **Amendment Orders Create New BillingSchedule Records** — Activating an asset amendment order does NOT update the existing BillingSchedule — it creates a net-new one. Billing reconciliation across amendments requires aggregating all BillingSchedule records for a given asset.2032044. **FinanceTransaction Is Read-Only** — FinanceTransaction records are system-generated accounting journal entries created when an Invoice is posted or a Payment is received. They cannot be created, updated, or deleted via API. Attempting to DML FinanceTransaction records causes errors.2052065. **DRO Swimlane Step Errors Do Not Auto-Retry** — If a DRO auto-task or callout step fails (e.g., an Apex auto-task throws an exception), the DRO plan stalls at that step. There is no automatic retry. Operators must review the DRO dashboard, resolve the root cause, and manually resume the fulfillment plan.207208---209210## Output Artifacts211212| Artifact | Description |213|---|---|214| DRO Fulfillment Plan design | Swimlane configuration with step types and milestone synchronization |215| Billing schedule creation script | Connect API POST implementation for post-activation billing setup |216| Amendment billing reconciliation query | SOQL/query pattern to aggregate BillingSchedule records across asset lifecycle |217| RLM vs. CPQ disambiguation guide | Checklist to confirm which product is in use before beginning implementation |218219---220221## Related Skills222223- revenue-cloud-data-model — for native Revenue Cloud object relationships (BillingSchedule, Invoice, FinanceTransaction)224- revenue-cloud-architecture — for order-to-cash architecture design across Revenue Cloud domains225- billing-schedule-setup — for legacy Salesforce Billing managed package (blng__*) billing schedules