Skip to content

Latest commit

 

History

History
100 lines (74 loc) · 5.11 KB

chargebee.md

File metadata and controls

100 lines (74 loc) · 5.11 KB
Raw

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. presented in both Product Catalog 1.0 and Product Catalog 2.0:
    • Customers
    • Events
    • Invoices
    • Credit Notes
    • Orders
    • Coupons
    • Subscriptions
    • Transactions
  2. presented only in Product Catalog 1.0:
    • Plans
    • Addons
  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