New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

Agentic AI


  • Chargebee Copilot
  • Catalog Setup Assistant
  • MCP Servers

Developer Resources


  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Chargebee Apps


  • Chargebee Apps CLI Developer Guide

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Overview
  • Use Cases
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Mid-term Subscription Changes
  • FAQs

Invoices and Credit Notes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

E-Invoicing


  • Overview
  • Enabling E-Invoicing

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration


  • Add Users & Assign Roles
  • Chargebee Notifications
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • OAuth Apps
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • E-Invoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Integrations
  3. Articles and FAQ
  4. Salesforce
  1. Billing
  2. Integrations
  3. Articles and FAQ
  4. Salesforce

Custom field mapping in Salesforce

Scope

Field-level mapping for custom objects.

Summary

Field mapping is one of the most important steps as it creates a bidirectional linkage between the two systems and thereby gives greater control on the implications of the native salesforce settings.

If you are migrating your Chargebee site from Legacy Product Catalog to 2.0, the Salesforce integration package cannot be readily migrated. Contact support to perform the migration.

The tables provide a field-level mapping between the custom objects and Chargebee entities. The Chargebee fields mentioned in the tables are attributes of resources available in Chargebee APIv2 .

CB Item Price

CB Item Price in Salesforce is mapped to the Item Price resource in Chargebee.

Salesforce Field

(* indicates custom field)

Chargebee Field/Data
Trial Period Unittrial_period_unit
Trial Periodtrial_period
Statusstatus
Resource versionresource_version
Productname
Pricing Modelpricing_model
Price BookLookup to a Price Book record corresponding to the Chargebee site that the Item Price belongs to.
Priceprice
Period Unitperiod_unit
Periodperiod
Free Quantityfree_quantity
External Idid
Currencycurrency_code
CB Item Price Namename
Billing Cyclesbilling_cycles

CB Subscription CB Subscription in Salesforce is mapped to the Subscription

resource in Chargebee.

Salesforce FieldsChargebee Fields
AccountMaster-Detail(Account)
Action at term endsubscription.contract_term.action_at_term_end
Address Line 1subscription.shipping_address.line1
Address Line 2subscription.shipping_address.line2
Address Line 3subscription.shipping_address.line3
CB Customer Idsubscription.customer_id
CB Id"domain name of the Chargebee site"+"subscription.id"
CB Plan Idsubscription.subscription_items[].item_price_id of the plan.
CB SiteLookup(CB Site)
CB Subscription Idsubscription.id
CB Subscription Namesubscription.id
Chargebee Modified Timesubscription.updated_at
Citysubscription.shipping_address.city
Companysubscription.shipping_address.company
ContactLookup(Contact)
Countrysubscription.shipping_address.country
Created ByUser who triggers the sync or turns on auto sync.
Currencysubscription.currency_code
Current Term Endsubscription.current_term_end
Current Term Startsubscription.current_term_start
Due Invoices Countsubscription.due_invoices_count
Due Sincesubscription.due_since
Emailsubscription.shipping_address.email
First Namesubscription.shipping_address.first_name
Last Modified ByUser who triggers the sync or turns on auto sync.
Last Namesubscription.shipping_address.last_name
MRRsubscription.mrr
Next billing Amountinvoice_estimate.total
Next billing atsubscription.next_billing_at
OpportunityLookup(Opportunity)
Phonesubscription.shipping_address.phone
Plan Amountsubscription.subscription_items[].amount or subscription.subscription_items[].amount_in_decimal  of the plan.
Plan Quantitysubscription.subscription_items[].quantity or subscription.subscription_items[].quantity_in_decimal of the plan.
Plan Unit Pricesubscription.subscription_items[].unit_price or subscription.subscription_items[].unit_price_in_decimal of the plan.
.PO Numbersubscription.po_number
ProductLookup(Product)
Reason for cancellationsubscription.cancel_reason
Remaining Billing Cyclessubscription.remaining_billing_cycles
Resource Version 
Resource Versionsubscription.resource_version Site(Deprecated) State/ County/ Provincesubscription.shipping_address.state Subcription Activated Atsubscription.activated_at Subcription Cancelled Atsubscription.cancelled_at Subscription Created Atsubscription.created_at Subscription Id"domain name of the Chargebee site"+"subscription.id" Subscription Started Atsubscription.started_at Subscription statussubscription.status Total Duessubscription.total_dues Trial Endsubscription.trial_end Trial Startsubscription.trial_start Zip/ Postal Codesubscription.shipping_address.zip

Related Articles

Why deals are being automatically closed won in Salesforce?
Salesforce - Subscription ID not being passed to the opportunity page
Is it possible for Salesforce to use read-only API key for syncronization?
Contract terms are enabled in Chargebee but they are not visible on CB subscription - Salesforce
How to create/update subscription using Salesforce Flow Builder?
How can I add CB quotes as a tab in Salesforce?
Subscription creation on renewal opportunity
'Sync Rule for Opportunities in Salesforce: Allow Chargebee to update the opportunity products in Salesforce with subscription''s products in Chargebee setting'
Salesforce- populate Customer.Billing_Address.Company
Business Entity is not showing up for selection in Chargebee Settings of Salesforce

Show more

Was this article helpful?