Skip to main content

Sync Orb data to Salesforce

Give your team full visibility into customer subscription data directly in Salesforce. By syncing billing and usage data from Orb, sales and success teams can track account health, identify expansion opportunities, and anticipate customer needs.

Monitor key business metrics including:

  • Current subscriptions and product usage
  • Invoice history and month-over-month trends
  • Real-time usage patterns for upsell opportunities
  • Credit balance and commitment tracking

How it works

The Salesforce CRM integration creates a set of custom objects in Salesforce corresponding to Orb resources, as detailed below.

After successfully authenticating a Salesforce instance, the initial sync will export all existing Orb data into Salesforce. After the initial sync, objects will be incrementally synced on a daily basis.

Orb resourceSalesforce custom object nameDescription
CustomersOrbCustomer__cRepresentation of a business which includes name, address, and other information identifying the billable entity (schema).
InvoiceOrbInvoice__cIssued invoices for the customer if the subscription is still active. Each invoice includes line items and finalized usage and dollar value totals (schema).
PlanOrbPlan__cA group of prices representing what customers could be charged (schema).
SubscriptionOrbSubscription__cThe link between a plan and a specific customer. Including any overrides to a plan (schema).
Invoice Line Item BillingOrbInvoiceLineItemBilling__cThe issued and billed amounts for each line item on an invoice (schema).
Subscription VersionOrbSubscriptionVersion__cA point in time representation of a plan for a particular customer (schema).
Daily Line Item RevenueOrbDailyLineItemRevenue__cThe daily incremental changes on a line item representing the quantities each day for an invoice (schema).
Credit Ledger EntryOrbCommittedLedgerEntry__cInformation on credit increments, decrements and voids (schema).

For schema object information refer to the data exports page.

salesforce_custom_objects.png

Setup

  1. Navigate to the Integrations page under Settings.
  2. Click "Connect to Salesforce" to configure the data sync. salesforce_connect_button.png
  3. Authorize Orb to connect to your Salesforce instance. orb_census_connection.png
  4. After a successful connection, you can configure the sync. crm_configuration_required.png

Sync configuration

Orb allows configuring the data types exported to Salesforce. Orb recommends syncing a smaller set of objects to avoid data limit restrictions in Salesforce. Once the selection has been submitted, Orb will begin the initial sync process to create the objects in Salesforce and begin syncing over the Orb objects. The data type selection can be modified once the integration is active.

crm_configuration_dialog.png

Viewing Data in Salesforce

Navigate to the Reports tab in Salesforce to view the synced data.

subscription_usage.png