This article answers the most common questions from Salesforce users about connecting Salesforce to ScaleXP: what access ScaleXP needs, what it reads from Salesforce, how opportunities become contracts on the contracts page, and how to view and change those contracts once they exist.

For the full setup walkthrough, see An overview of subscription management and renewal tracking in ScaleXP: Getting started with CRM integration and CRM integration: how to map CRM data in ScaleXP.

What level of access does ScaleXP need to Salesforce?

ScaleXP connects to Salesforce through an authorized Salesforce user and reads opportunity and account data from that user's org. It does not create or modify records in Salesforce.

1. Use a Salesforce user with API Enabled and read access to the Opportunity and Account objects, including any custom opportunity fields you intend to map (for example contract start date, contract end date, ACV or ARR, contract term, invoice frequency, renewal reference). We recommend a dedicated integration user or system administrator so the connection is not affected when a salesperson leaves.
2. In ScaleXP, go to Load Data > Connections > + Add a Connection, select Salesforce, and authorize with that user.
3. Click Sync now to pull your data.

Note: In consolidated companies, connect Salesforce in the parent company. Your Salesforce currency must match the currency of your ScaleXP organization. ScaleXP supports a single CRM connection per organization.

What does ScaleXP read from Salesforce?

For each opportunity within your import window and selected pipelines, ScaleXP reads: the opportunity name and account; Amount, used as total contract value (TCV — not configurable); Close Date (or, if you choose, the date the opportunity moved to Closed Won or Closed Lost); Stage; Record Type and Type; and any opportunity fields you map in Configure — contract start date, contract end date, annual contract value or ARR, contract term, invoice frequency, renewal deal reference, and up to two deal tags.

See CRM integration: how to map CRM data in ScaleXP for what each mapped field is used for, and ScaleXP CRM integration best practices for how to structure your Salesforce fields.

Which opportunities are imported?

1. Data imported from sets the earliest close date imported. Include every opportunity you need for renewals, forecasting and reporting; very large data sets slow down each sync.
2. Pipelines: for Salesforce, you select from Record Types and Types on the Opportunity object and assign each to New Customers or Renewals. Any record type or type not assigned to either category is not visible anywhere in ScaleXP.
3. Stages: every stage in the selected pipelines is imported by default. Click Exclude next to any stage you want left out of forecasts and reports.

Open these settings from Load Data > Connections > three dots on the Salesforce card > Configure.

How is the contracts page populated?

For Salesforce customers, contracts are created automatically. When an opportunity in one of your selected pipelines is Closed Won (and its close date is on or after your Data imported from date), ScaleXP creates a contract for it on the next sync and builds a schedule of future invoices from the opportunity's mapped fields — contract start and end dates, annual contract value or ARR, and invoice frequency.

1. Map contract start date, contract end date, ACV or ARR and invoice frequency in Configure so the schedule is accurate. If invoice frequency is not mapped, ScaleXP assumes monthly; if no end date or term is mapped, it assumes 12 months.
2. Link the real invoices from your accounting system to each contract on the Invoice Matching page as they are issued, so the schedule is replaced by actuals. See Invoice matching (booked vs billed): how to create contracts in ScaleXP linked to your invoices and CRM deals.
3. For deals that are not in Salesforce, click Add Contract on the Contracts page and attach invoices manually. See How to add a contract.

If a contract you expect is missing, check that its opportunity is Closed Won, its record type or type is assigned to New Customers or Renewals in Configure, its stage is not excluded, and its close date is within the import window — then click Sync now on the Salesforce connection.

Each contract holds the contract start and end dates, past and future invoices, the associated accounting customer, and the billing term and frequency. Contracts drive the Renewals schedule and sales forecasts — see View/manage your renewals schedule.

Where do contract values and dates come from?

• Original contract value — the Salesforce opportunity Amount, or the value entered manually for a contract with no linked opportunity.
• Current contract value — the total of all invoices on the contract: scheduled future invoices from the opportunity plus any issued invoices linked to it. In consolidated companies it is held in the subsidiary's currency and translated at the parent company's invoice rates — see FX rates: what foreign exchange rate is being used?
• Contract start date — the Salesforce field mapped as contract start date in Configure; if none is mapped, the close date.
• Contract end date — the Salesforce field mapped as contract end date; if none is mapped, the start date plus the mapped contract term (default 12 months). Once issued invoices are linked, the end date reflects the latest end date of the invoices on the contract.

How do I view contracts?

1. Go to Customers > Contracts.
2. Filter by status, salesperson or deal owner, or search by customer.
3. Click Save filters to keep your view, and Configure Columns to choose which columns are shown.

How do I change a contract?

A contract created from a Salesforce opportunity is read only in ScaleXP: its customer, dates, values and invoice schedule come from the opportunity. Open the contract by clicking the pencil icon on its row on the Contracts page — the Edit contract invoices dialog shows the message "This contract is read only. To change it please use Salesforce and links below."

• Change dates, value or frequency — click Open in Salesforce on the contract or invoice row, update the opportunity fields in Salesforce, then click Sync now on the Salesforce connection. The contract and its schedule update on the next sync.
• Attach an issued invoice — link it on the Invoice Matching page, or click Add Issued Invoice in the dialog. See How to add an invoice or repeating invoice to a contract if you are not using ScaleXP Invoicing.
• Add a repeating invoice — click Add Repeating Invoice in the dialog for billing that is not represented in the opportunity.
• Modify an issued invoice — change it in your accounting system, then sync.
• Move an invoice between contracts — correct the customer in your accounting system first if needed, then re-match the invoice on the Invoice Matching page.
• Merge or split contracts — because Salesforce contracts mirror opportunities, merge or split the opportunities in Salesforce and sync. A contract can have only one accounting customer, so merge duplicate customers in your accounting system first (at subsidiary level in consolidated companies).
• Delete a contract — click the trash icon at the right of the contract's row. If the opportunity is still Closed Won in a selected pipeline, the contract is recreated on the next sync; change the opportunity or exclude its stage instead.

Do changes in ScaleXP sync back to Salesforce?

No. Changes to contracts, invoices, values and dates in ScaleXP stay in ScaleXP and are not written back to Salesforce. However, changes to your invoices in your accounting system affecting opportunities in Salesforce sync back to Salesforce and thus ScaleXP.

Related articles

• An overview of subscription management and renewal tracking in ScaleXP: Getting started with CRM integration
• CRM integration: how to map CRM data in ScaleXP
• ScaleXP CRM integration best practices
• View your contracts: An overview of contracts in ScaleXP
• Updating contracts: how to make changes to contracts in ScaleXP (not using ScaleXP Invoicing)
• Invoice matching (booked vs billed): how to create contracts in ScaleXP linked to your invoices and CRM deals
• How to add a contract
• How to add an invoice or repeating invoice to a contract if you are not using ScaleXP Invoicing
• How to auto-link renewal deals in ScaleXP
• View/manage your renewals schedule
• Data fields for advanced reporting