Connector Catalog
Sources
Chargebee

Overview

The Chargebee source supports both Full Refresh and Incremental syncs. You can choose if this connector will copy only the new or updated data, or all rows in the tables and columns you set up for replication, every time a sync is run.
This Chargebee source uses the Chargebee Python Client Library.

Output schema

This connector outputs the following streams:

Notes

Some streams may depend on Product Catalog version and be accessible only on sites with specific Product Catalog version. This means that we have following streams:
  1. 1.
    presented in both Product Catalog 1.0 and Product Catalog 2.0:
    • Customers
    • Events
    • Invoices
    • Credit Notes
    • Orders
    • Coupons
    • Subscriptions
    • Transactions
  2. 2.
    presented only in Product Catalog 1.0:
    • Plans
    • Addons
  3. 3.
    presented only in Product Catalog 2.0:
    • Items
    • Item Prices
    • Attached Items
Also, 12 streams from the above 13 incremental streams are pure incremental meaning that they:
  • read only new records;
  • output only new records.
Attached Items incremental stream is also incremental but with one difference, it:
  • read all records;
  • output only new records.
This means that syncing the Attached Items stream, even in incremental mode, is expensive in terms of your Chargebee API quota. Generally speaking, it incurs a number of API calls equal to the total number of attached items in your chargebee instance divided by 100, regardless of how many AttachedItems were actually changed or synced in a particular sync job.

Features

Feature
Supported?
Full Refresh Sync
Yes
Incremental - Append Sync
Yes
Replicate Incremental Deletes
No
SSL connection
Yes
Namespaces
No

Performance considerations

The Chargebee connector should not run into Chargebee API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

Getting started

Requirements

  • Chargebee Account;
  • site_api_key - Chargebee API Key wih the necessary permissions (described below);
  • site - Chargebee site prefix for your instance;
  • start_date - start date for incremental streams;
  • product_catalog - Product Catalog version of your Chargebee site (described below).

Setup guide

Log into Chargebee and then generate an API Key. Then follow these instructions, under API Version section, on how to find your Product Catalog version.

Changelog

Version
Date
Pull Request
Subject
0.1.11
2022-03-03
10827
Fix Credit Note stream
0.1.10
2022-03-02
10795
Add support for Credit Note stream
0.1.9
2022-0224
10312
Add support for Transaction Stream
0.1.8
2022-02-22
10366
Fix broken coupon stream + add unit tests
0.1.7
2022-02-14
10269
Add support for Coupon stream
0.1.6
2022-02-10
10143
Add support for Event stream
0.1.5
2021-12-23
8434
Update fields in source-connectors specifications
0.1.4
2021-09-27
6454
Fix examples in spec file
0.1.3
2021-08-17
5421
Add support for "Product Catalog 2.0" specific streams: Items, Item prices and Attached Items
0.1.2
2021-07-30
5067
Prepare connector for publishing
0.1.1
2021-07-07
4539
Add entrypoint and bump version for connector
0.1.0
2021-06-30
3410
New Source: Chargebee
Last modified 6mo ago
Copy link
On this page
Overview
Output schema
Notes
Features
Performance considerations
Getting started
Requirements
Setup guide
Changelog