> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/central/apps/business-systems/cin7-core.md).

# Cin7 Core

Connect OrderEazi Central to Cin7 Core, so Sales Orders go to Cin7 and products, prices, clients, suppliers, and stock come back.

When your sales team works in OrderEazi but your stock lives in Cin7 Core, recapturing every order twice costs time and causes mistakes. The Cin7 Core app (**Cin7 Integration** in the App Gallery) connects OrderEazi Central to Cin7 Core, an inventory system. Your Sales Orders go to Cin7, and products, prices, clients, suppliers, and stock come back.

### Before you start

You'll need:

* **A Cin7 Core account with API access:** Create an Application Key in Cin7 Core under **Integrations** > **API**, and note your Account ID. The API is the connection other systems use to exchange data with Cin7.
* **Cin7 customers set up:** Each client you send a Sales Order for must already exist in Cin7, or be linked on the app's **Mappings** tab.
* **Permissions:** You need **View Installed Apps** and **Configure and Open Installed Apps**, in the **App Gallery** permission group. See [App Gallery](/central/apps/app-gallery.md).

Each Cin7 account can be connected to one OrderEazi site only. Cin7 allows each account 60 API calls a minute, shared with your other Cin7 integrations, so the app paces its requests.

### Setup order

Every sync from Cin7 is on by default, and runs as soon as it's due. Set the app up in this order, so nothing comes across before your defaults are in place:

> **Warning:** **Documents → OE** is on by default. Once you choose a **Sales Channel**, every Cin7 sale that didn't come from OrderEazi is created as a new OrderEazi order, whatever its status in Cin7. The first check can include older sales. Clear **Documents → OE**, or leave **Sales Channel** blank, until you want this. Clearing it also stops Tax Invoices coming from Cin7 invoices.

* **Install and connect:** Install **Cin7 Integration** from the App Gallery. On its **Configuration** tab, clear **Cin7 → OrderEazi (pull-back)**, enter your credentials, and save. See [Configuration](/central/apps/business-systems/cin7-core/configuration.md).
* **Bring in Cin7's lists:** On the **Reference Data** tab, select **Sync Now**. This brings in Cin7's tax rules, price tiers, and locations, and creates matching pricelists and locations in OrderEazi. See [Mappings](/central/apps/business-systems/cin7-core/mappings.md).
* **Choose your defaults:** On the **Configuration** tab, choose your **Sales Channel**, **Default supplier (stock items)**, and **Excluded price tiers**. Then tick **Cin7 → OrderEazi (pull-back)** again, and save.
* **Run the first syncs:** On the **Master Sync** tab, sync items, then clients and suppliers, then stock. See [Master data sync](/central/apps/business-systems/cin7-core/master-data-sync.md).

From then on, the syncs run on their schedule. See [Sync schedule](/central/apps/business-systems/cin7-core/sync-schedule.md).

### What moves between the systems

**From OrderEazi to Cin7:**

* **Sales Orders:** Each Sales Order created in OrderEazi becomes a draft sale in Cin7 within a few minutes. See [Sales documents and statuses](/central/apps/business-systems/cin7-core/sales-documents-and-statuses.md).
* **With the rules engine:** Quotes, Sales Orders, Tax Invoices, and stock transfers go to Cin7 at the points in your workflow you choose. See [Rules](/central/apps/business-systems/cin7-core/rules.md).

**From Cin7 to OrderEazi, on a schedule:**

* **Products:** Products are created or updated by SKU (the product code). Each Cin7 price tier's prices go on a matching [pricelist](/central/order-management/pricelists.md).
* **Clients and suppliers:** New Cin7 customers and suppliers are added as clients and suppliers.
* **Stock:** Each Cin7 location's stock is written to a location in your main OrderEazi warehouse. See [Stock and locations](/central/apps/business-systems/cin7-core/stock-and-locations.md).
* **Status, invoices, and orders:** Cin7 status updates are noted on the project's history. Cin7 invoices can become Tax Invoices, and sales that start in Cin7 can become new OrderEazi orders.
* **Images:** Product images can come across as each product's main image. This is off by default.

### The app's tabs

* **Configuration:** Your Cin7 connection, OrderEazi defaults, sync switches, sync schedule, and the rules engine.
* **Reference Data:** The Cin7 tax rules, price tiers, locations, and other lists the app keeps a copy of.
* **Mappings:** How Cin7 records and values are linked to OrderEazi.
* **Rules:** What happens in Cin7 at each step of a project, when the rules engine is on.
* **Master Sync:** Run a product, client, supplier, image, or stock sync straight away.
* **Sale Logs, Product Logs, and Status Logs:** A record of what was sent and received. See [Logs](/central/apps/business-systems/cin7-core/logs.md).

### What the Cin7 Core app does not do

* **Delete or deactivate records:** Products, clients, suppliers, pricelists, and locations deleted in Cin7 stay in OrderEazi.
* **Create Cin7 products:** OrderEazi products aren't sent to Cin7.
* **Update clients and suppliers:** Ones already in OrderEazi aren't changed by later syncs.
* **Create credit notes or delivery documents:** Only Tax Invoices and orders come back from Cin7.

### Related pages

* [Configuration](/central/apps/business-systems/cin7-core/configuration.md): connect the app and choose what syncs
* [Sales documents and statuses](/central/apps/business-systems/cin7-core/sales-documents-and-statuses.md): how Sales Orders reach Cin7
* [Simple Inventory Management](/central/order-management/products/inventory/simple-inventory-management.md): how stock levels work in OrderEazi