SfSkills Domains Docs GitHub

Home / integration / manufacturing-cloud-setup

manufacturing-cloud-setup

Use this skill when configuring Salesforce Manufacturing Cloud — including Sales Agreement setup, Account-Based Forecasting (ABF) recalc jobs, run-rate management, Rebate Management programs, channel inventory tracking. NOT for general Sales Cloud opportunity-to-order flow (use standard Opportunity / Order) — use admin/rebate-management-setup.

Open the skill folder on GitHub

Manufacturing Cloud Setup

This skill activates when a practitioner is configuring Manufacturing Cloud — the industry cloud that adds long-horizon Sales Agreements, account-based forecasting, run-rate planning, and rebate / channel-revenue management to Sales Cloud. It covers Sales Agreement structure, Account-Based Forecasting (ABF) recalc activation, run-rate vs. planned-quantity reconciliation, and Rebate / CRM module setup. It does NOT cover generic Sales Cloud opportunity-to-order flow, Field Service install-base, or Automotive Cloud dealer modeling.

Before Starting

Gather this context before working in this domain:

Core Concepts

Sales Agreement: Long-Horizon Planned Demand

A SalesAgreement is a multi-period commitment between an account (a distributor, dealer, or wholesaler) and the manufacturer to purchase planned quantities of products over a fixed term — often 12–36 months. Unlike an Opportunity (point-in-time sale), a Sales Agreement breaks planned quantity / revenue into a schedule of periods (SalesAgreementProductSchedule).

Each SalesAgreementProduct represents one product within the agreement. Its planned quantity for each schedule period is the "planned" half of the planned-vs.-actual reporting.

The actual half comes from Order / OrderItem data: when an actual order is placed against the agreement, the OrderItem.SalesAgreementId lookup associates the actual with the agreement, and a recalc job aggregates the actuals into the corresponding schedule periods.

Account-Based Forecasting (ABF)

ABF aggregates Sales Agreement schedules + open Opportunities + open Orders + actuals into a single per-account, per-product forecast: AccountProductForecast. Each forecast row holds planned quantity, planned revenue, actual quantity, and actual revenue per period.

The forecast is recomputed by a DPE batch job, not in real time. Without activating the recalc job, AccountProductForecast records grow stale and reports show last-recalc data — which leads to a common production bug: "the forecast doesn't match what I know is in the agreement."

Run-Rate Management

Run-rate is the trailing-period average of actuals, used to detect when a customer is consuming below or above their committed schedule. Manufacturing Cloud computes run-rate as part of the ABF recalc and surfaces variance (planned − actual) on AccountProductForecast. Use this for early-warning alerts on under-consuming agreements.

Rebate Management

RebateProgram defines the rebate structure: tiers (volume-based or revenue-based), payout cadence, eligible products, eligible accounts. RebateProgramPayoutPeriod defines a payout window. ProgramRebatePayout is the calculated payout per member-account per period.

Rebate payout calculation is another DPE batch job that must be activated. It pulls actuals from Order / OrderItem, applies tier logic, and writes ProgramRebatePayout rows.

Channel Revenue Management (CRM module)

For OEMs that sell into a distribution channel (sell-in), then track ultimate consumer sales by the channel partner (sell-through), the Channel Revenue Management module provides:

This is distinct from the base Sales Agreement / ABF flow — only configure if the OEM has a true two-step distribution model.

Common Patterns

Pattern 1: First-Time Sales Agreement Setup with ABF Activation

When to use: Net-new Manufacturing Cloud rollout.

How it works:

  1. Define the Sales Agreement term and schedule frequency on the agreement record (e.g., 24 months, monthly schedule).
  2. Add SalesAgreementProduct rows for each product in scope. Set planned quantity and planned revenue per period.
  3. Activate the agreement (this creates the SalesAgreementProductSchedule rows).
  4. In Setup → Data Processing Engine, locate the Account-Based Forecasting recalculation definition. Activate it and schedule it (typically nightly).
  5. Run the recalc once manually after activation to backfill AccountProductForecast.
  6. Wire OrderItem.SalesAgreementId population in your Order ingest path so actuals associate correctly.

Why activate ABF explicitly: ABF recalc is opt-in. Without activation, AccountProductForecast is empty and the executive dashboards show "no forecast data."

Pattern 2: Actual-vs-Planned Reconciliation

When to use: "The Sales Agreement says we should be at 50K units this quarter but actuals show 30K — is the data wrong?"

How it works:

  1. Verify the OrderItem.SalesAgreementId field is populated on the relevant orders. This is the linkage to the agreement.
  2. Check the last successful run timestamp of the ABF recalc DPE job. If it's stale, the forecast data is stale by definition.
  3. Confirm the schedule period alignment — Order date must fall within the schedule period for the actual to land in that period.
  4. Re-run the recalc and re-check AccountProductForecast.

Pattern 3: Rebate Program with Volume Tiers

When to use: OEM offers volume-based rebates to channel partners.

How it works:

  1. Create a RebateProgram with payout cadence (typically quarterly).
  2. Define rebate tiers: e.g., 0–10K units = 0%, 10K–50K units = 2%, 50K+ units = 4%.
  3. Enroll member accounts via RebateProgramMember.
  4. Activate the Rebate Payout Calculation DPE definition and schedule it to run after each payout period closes.
  5. Verify ProgramRebatePayout rows are created with the correct tier applied.

Decision Guidance

SituationRecommended ApproachReason
Multi-period commitment to purchaseSalesAgreement + SalesAgreementProduct schedulePurpose-built for multi-period planned demand; do not use Opportunity
Per-account forecast view spanning agreement + opps + ordersActivate ABF recalc DPEAccountProductForecast is the only object that aggregates all four sources
Volume / revenue rebates to channel partnersRebateProgram + Rebate Payout DPEBuilt-in tier engine; do not build custom rebate logic
OEM sells into distributors, distributors sell to consumersChannel Revenue Management moduleChannelInventory + sell-through rebates require CRM module
One-shot point-in-time saleStandard Opportunity / OrderSales Agreement overhead not justified for single transactions
Forecast recalc cadenceNightly DPE schedule for most orgsReal-time recalc is not supported; near-real-time requires custom triggers (rare)
  1. Confirm Manufacturing Cloud license; verify standard objects appear in Object Manager.
  2. Decide schedule frequency and term length per typical agreement before configuring (changes after activation are destructive).
  3. Build the first Sales Agreement end-to-end (with SalesAgreementProduct rows and activation).
  4. Activate the Account-Based Forecasting recalculation DPE definition; run once manually to backfill.
  5. Wire OrderItem.SalesAgreementId population in the order ingest path.
  6. For rebates: configure RebateProgram with tier structure, enroll members, activate the Rebate Payout DPE.
  7. For channel-revenue-management, enable ChannelProgram only if the OEM has a true two-step distribution model. Then test end-to-end: agreement activation → order placement → ABF recalc → forecast accuracy → rebate payout.

Review Checklist

Salesforce-Specific Gotchas

  1. ABF Recalc Is Not Automatic — A net-new Manufacturing Cloud org has no DPE jobs running. AccountProductForecast will be empty until the Account-Based Forecasting recalc DPE definition is activated and scheduled. This is the single most common go-live failure mode.
  2. Schedule Frequency Cannot Be Changed Post-Activation Without Pain — Changing a Sales Agreement from Monthly to Quarterly schedule after activation requires deactivating, deleting SalesAgreementProductSchedule rows, and reactivating. Plan the cadence carefully up front.
  3. OrderItem.SalesAgreementId Is Not Auto-Populated — Even when an order is placed against an account that has an active Sales Agreement, the SalesAgreementId lookup is not automatically set. The Order ingest path (Apex, Flow, or external integration) must explicitly populate it, or actuals never reconcile to plan.
  4. Rebate Tier Boundaries Are Cumulative, Not Marginal — Manufacturing Cloud's standard rebate calculation applies the highest qualifying tier to the entire volume, not marginal tiers. If a member buys 60K units in a 0–10K=0%, 10–50K=2%, 50K+=4% structure, they receive 4% on all 60K. Modeling marginal tiers requires custom logic.
  5. Channel Revenue Management Is Not Required for Simple Rebates — Many practitioners enable CRM unnecessarily. Base Manufacturing Cloud Rebate Management handles direct-customer rebates fine. Only enable CRM when there's a true sell-in / sell-through distribution model with partner inventory tracking.
  6. SalesAgreement Permissions Are Granular — End-user roles need specific permissions on SalesAgreement, SalesAgreementProduct, AND SalesAgreementProductSchedule. Granting only the parent does not cascade — the schedule rows stay invisible.

Output Artifacts

ArtifactDescription
Sales Agreement design documentSchedule frequency, term, product mix, planned quantity source
ABF activation runbookDPE definition activation steps, schedule cadence, manual-run verification
Rebate program blueprintTier structure, payout cadence, member enrollment, DPE activation
Order-to-agreement integration specOrderItem.SalesAgreementId population pattern in the ingest path
Forecast variance dashboardReports built off AccountProductForecast for run-rate alerts

Package files