New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
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

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

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


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


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

Taxes


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

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • 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
  • 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 One-Time Orders
  • Mobile 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
    • QuickBooks Online
      • Configuring QuickBooks
      • Record Mapping in QuickBooks
      • Customer Mapping
      • Reconciling Chargebee Invoices with QuickBooks
      • Reconnecting QuickBooks to Chargebee
      • Objects and Fields Mapped between Chargebee and QuickBooks
      • QuickBooks custom field mapping
      • Quickbooks common sync errors
    • Xero
    • Sage Intacct
    • Oracle NetSuite
  • Tax
  • eInvoicing
  • 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. Finance
  4. QuickBooks Online
  5. Record Mapping in QuickBooks
  1. Billing
  2. Integrations
  3. Finance
  4. QuickBooks Online
  5. Record Mapping in QuickBooks

Record Mapping in QuickBooks

Chargebee provides a user-friendly interface to manage Object-to-Record mapping for QuickBooks integration.

Key benefits include:

  • Migrating smaller data batches at your convenience.
  • Correcting incorrect record mappings post-migration.

Setting up the Record Mapping feature

Step 1: Set up the Integration

  1. Log in to your Chargebee site.
  2. Navigate to Apps > QuickBooks.
  3. Click Manage record mapping.
    image

Step 2: Map Objects Between Chargebee and QuickBooks

Once you click Manage record mapping, the system redirects you to the Map Objects with QuickBooks page.

  1. From the drop-down menu, select the object type (customers, invoices, credit notes, or transactions) for mapping.
    image
  2. Click Download CSV.
  3. The system creates an empty CSV with the following column headers:
    image
CSV HeadersDescription
Chargebee <entity> IDChargebee Customer/Invoice/Credit Note/Transaction ID
QuickBooks <entity> API IDCustomer/Invoice/Credit Note/Transaction ID
QuickBooks <entity> IDCustomer/Invoice/Credit Note/Transaction ID

Note

CSV headers are case-sensitive and are prepopulated in the CSV template.

Mapping fields between Chargebee and QuickBooks

The following table displays the available fields that can be used to map entities between Chargebee and QuickBooks.

QuickBooks FieldChargebee Object TypeQuickBooks Record type
Display NameCustomerCustomer
Invoice No.InvoiceInvoice
Credit Memo No.Credit NoteCreditMemo
Purchase No.Transaction (Refunds)Purchase
Reference No.Transaction (Payment)Payment

Step 3: Upload and Complete Mapping

  1. Click Upload mapped CSV to upload the mapping changes.

    image
  2. Once the mapping process is complete, the following screen displays:

    image

    Any errors in the provided data are captured in a new CSV file that can be downloaded by clicking Download Errors.

Possible Errors in QuickBooks

  • Chargebee ID is mandatory.
  • QuickBooks ID or API ID is mandatory.
  • Chargebee ID is invalid.
  • QuickBooks ID is invalid.
  • QuickBooks API ID is invalid.

After fixing these errors, reupload the CSV file.

image

Was this article helpful?