Updating data imported from a billing system

You’ll need to be an Owner, Admin or Staff to update data imported from a billing system.

If you’re using Stripe, Chargebee or the latest version of our Recurly and Braintree integrations, ChartMogul allows you to update data imported from the billing system. You can edit, add and disable invoices, invoice line items, transactions and subscription events. Any changes you make are stored in ChartMogul only and don’t affect your billing system data. Your edits are preserved even when you resync the source.

Learn about other ways you can correct data in ChartMogul:

Here’s what we cover in this article:

Before you begin

Reasons for updating data

Here are some common cases when you may want to update data imported from a billing system:

  • A subscription charge in your billing system is categorized as non-recurring — For example, you issued a one-time invoice for a subscription with custom pricing, additional agreements or a pricing change in the middle of a service period. In this case, change the invoice line item type from “Non-recurring” to “Subscription” and add relevant subscription information such as service period start and end dates, plan or subscription external ID.
  • The date of a subscription event recorded in the billing system is incorrect — For example, you recorded a cancellation too early or too late and want to correct its date in ChartMogul.
  • The billing system is missing records — For example, you’ve issued an invoice outside of the billing system and want to add it manually in ChartMogul.
  • The billing system contains duplicate records — For example, an invoice was accidentally recorded twice in your billing system, and you want to disable one of the records to prevent inflated metrics.

How updating data works

Here are some details you should understand about updating data:

  • You can update data imported from Stripe, Chargebee and the latest version of our Recurly and Braintree integrations.
  • ChartMogul preserves your changes during a resync.
  • You can edit, add and disable invoices, invoice line items, transactions and subscription events.
  • Manually added records contribute to your metrics.
  • Disabled records are ignored when calculating metrics.
  • It’s only possible to edit and disable records with an external ID. ChartMogul needs this information to associate your edits with the edited record.
  • For each added record, you must provide an external ID so ChartMogul can preserve it during a resync.
  • Your edits are stored in ChartMogul only and don’t affect your billing system data.
  • You can revert any of your edits. In this case, ChartMogul restores the record to its latest version imported from the billing system.
  • Custom and Google Sheets sources also allow you to edit data, but your changes overwrite the original data.

Editing imported records

To edit a record imported from a billing system:

  1. Navigate to Settings & Data > Sources and select a Stripe, Chargebee, Recurly or Braintree source.
  2. Select Invoices, Invoice Line Items, Transactions or Subscription Events.
    Screenshot of a Stripe source page showing the placement of the Invoices, Invoice Line Items, Transactions and Subscription Events tabs.
  3. Click the Edit   icon next to the record you want to modify.
  4. Apply your changes and click the Save   icon to submit them.

ChartMogul displays the History   next to user-edited records.

Screenshot of the history icon indicating a user-modified invoice line item.

Follow the instructions below for common data updating scenarios.

Changing the invoice line item type

To change the type of an invoice line item from “Non-recurring” to “Subscription”:

  1. Navigate to your source and select Invoice Line Items.
  2. Click the Edit   icon next to the line item you want to modify.
  3. Change the Type to Subscription.
  4. Complete the following details. Learn more about invoice line item properties.
    • Subscription ID
    • Service Period Start
    • Service Period End
    • Prorated?
    • Plan
  5. Click the Save   icon to submit your changes.

ChartMogul will treat this line item as a subscription and include it in your recurring revenue metrics.

Screencap of changing a non-recurrent invoice line item to a subscription one following the steps described here.

Changing the date of a subscription event

To change the date of a subscription event:

  1. Navigate to your source and select Subscription Events.
  2. Click the Edit   icon next to the event you want to modify.
  3. Set a new Effective Date or — if it’s a cancellation and you recognize churn the moment a customer cancels their subscription — Event Date. Learn the difference between the event date and the effective date.
  4. Click the Save   icon to submit your changes.

Adding records manually

To manually add an invoice, invoice line item, transaction or subscription event:

  1. Navigate to Settings & Data > Sources and select a Stripe, Chargebee, Recurly or Braintree source.
  2. Select Invoices, Invoice Line Items, Transactions or Subscription Events.
  3. Click New Invoice, New Invoice Line Item, New Transaction or New Subscription Event.
    Screenshot of a Stripe source’s Invoices table showing the location of the New Invoice button.
  4. Enter the required details, including an external ID under Invoice ID, Line Item ID, Transaction ID or Event ID. Learn more about adding invoices, invoice line items, transactions and subscription events using data tables.
  5. Click the Save   icon to create the record and Reload to refresh the table.

ChartMogul displays the History   icon next to manually added records.

Screenshot of the history icon indicating a manually added invoice line item.

Disabling imported records

To manually disable invoices, invoice line items, transactions or subscription event imported from a billing system:

  1. Navigate to Settings & Data > Sources and select a Stripe, Chargebee, Recurly or Braintree source.
  2. Select Invoices, Invoice Line Items, Transactions or Subscription Events.
  3. Use the checkboxes to select one or more records and click Disable Selected Rows.
    Screenshot of the Invoices tab with three rows selected and a button titled Disable 3 Selected Rows.
  4. Click OK to confirm.

Disabled records are grayed out and display the History   icon.

Screenshot of a disabled transaction row. The row is grayed out and displays the history icon.

Viewing user updates

User-edited and manually added invoices, invoice line items, transactions and subscription events are indicated by the History   icon.

Click the icon to display a dialog with the following information:

  • The time when the record was added or disabled and the user who did it (for manually added and disabled records)
    Screenshot of the Updates History dialog showing the time when the record was added and the user who added it.
  • User-edited version — the latest version of the record modified by a user
  • Original version created by [integration name] — the latest version of the record imported from the billing system (for user-edited records)
    Screenshot of the Updates History dialog showing a user-edited version of an invoice line item and its original version imported from Recurly.

Reverting user updates

To revert your changes, click the History   icon next to an invoice, invoice line item, transaction or subscription event, then follow the steps below based on the change type.

To restore a user-edited record to its latest version imported from the billing system, scroll to the right and click the Delete   icon under User-edited version. Click OK to confirm.

Screenshot of the Updates History dialog showing the placement of the delete icon.

To permanently delete a manually added record, click Delete and confirm by clicking OK.

Screenshot of the Updates History dialog showing the placement of the Delete button.

To enable a disabled record, click Enable and confirm by clicking OK.

Screenshot of the Updates History dialog showing the placement of the Enable button.

Was this article helpful?

We’re sorry to hear that. Would you like to share more feedback?


Thanks for your feedback!