> ## Documentation Index
> Fetch the complete documentation index at: https://www.spacebring.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo Accounting

> Connect Odoo Accounting to automatically sync issued invoices and credit notes from Spacebring, understand the key prerequisites for successful synchronization, and how the integration works

Seamlessly sync issued invoices and credit notes from Spacebring to Odoo Accounting to cut manual accounting work. They land as drafts, ready for you to review and post.

<Info>
  Odoo is a distinct company not affiliated with Spacebring. For any inquiries regarding Odoo's solutions, services, or pricing, reach out to Odoo directly. We do not have the authority to provide information or support on behalf of Odoo.
</Info>

## Prerequisites

1. Have your Odoo instance ready, with a user login and an API key created in that user's account security settings.
2. Make sure the **Accounting** app is enabled in your Odoo instance, since that's what Spacebring syncs invoices and credit notes into.
3. If your Odoo instance is on Odoo Online, ensure you're on the Custom plan. It's required for API access.

## Connect the Odoo integration

1. Click the menu **(...)** next to the location's name > go to **Integrations**.<br />
   <Frame>
     <img src="https://mintcdn.com/spacebring/Cr6Ubsow5j3WT_8D/images/integrations-access-control-avigilon-alta-1.png?fit=max&auto=format&n=Cr6Ubsow5j3WT_8D&q=85&s=7179f2462c66853bf4ce5dcd2fd97e78" alt="Integrations Access Control Avigilon Alta 1" width="1716" height="779" data-path="images/integrations-access-control-avigilon-alta-1.png" />
   </Frame>
2. Open the **Odoo** integration page and click **Connect**.<br />
   <Frame>
     <img src="https://mintcdn.com/spacebring/DJlP76BpDEwA5Dfo/images/integrations-accounting-odoo-connect-the-odoo-integration-odoo-page.png?fit=max&auto=format&n=DJlP76BpDEwA5Dfo&q=85&s=27fa16173ae4e11a636c05eb37f6d639" alt="Integrations Accounting Odoo Connect The Odoo Integration Odoo Page" width="2366" height="1225" data-path="images/integrations-accounting-odoo-connect-the-odoo-integration-odoo-page.png" />
   </Frame>
3. Enter your Odoo instance **URL** (must start with `https://`, for example `https://mycompany.odoo.com`), **Database**, **Login**, and **API key**, then click **Connect**.<br />
   <Frame>
     <img src="https://mintcdn.com/spacebring/DJlP76BpDEwA5Dfo/images/integrations-accounting-odoo-connect-the-odoo-integration-connect-account.png?fit=max&auto=format&n=DJlP76BpDEwA5Dfo&q=85&s=fd964c3f93289e8c56f438cd7c5e226f" alt="Integrations Accounting Odoo Connect The Odoo Integration Connect Account" width="2062" height="1457" data-path="images/integrations-accounting-odoo-connect-the-odoo-integration-connect-account.png" />
   </Frame>
4. Select an Odoo **Sale journal** where Spacebring should create invoices and credit notes.

<Warning>
  The connection stays incomplete until you select a **Sale journal**. Invoices and credit notes don't sync until you do.
</Warning>

## How Odoo integration works

Once connected, Spacebring automatically syncs issued invoices and credit notes for unpaid invoices to Odoo as drafts, in real time.

<Warning>
  Spacebring only creates draft invoices and credit notes in Odoo. It doesn't post them or mark them as paid, even after the invoice is paid in Spacebring. You must post each draft and register its payment in Odoo yourself, including any e-invoicing that runs on posting.
</Warning>

<Info>
  Voiding an invoice in Spacebring doesn't sync to Odoo — the synced invoice stays in draft. To correct an invoice, issue a [credit note](/docs/billing/invoices/credit-notes) in Spacebring, which will sync to Odoo and link to that invoice.
</Info>

### How invoices sync

Invoices sync to the **Sale journal** you selected when connecting. The integration maps Spacebring invoice data to Odoo as follows:

| **Data in Spacebring**                            | **Data in Odoo**                                                                                                                            |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Customer name (or legal business name) and tax ID | Spacebring finds a matching customer in Odoo by tax ID, then by name. If no match is found, it creates a customer with that name and tax ID |
| Customer email                                    | ✗                                                                                                                                           |
| Currency                                          | ✗ — the invoice uses your Odoo company's currency; make sure it matches the currency you use in Spacebring, or amounts will be wrong        |
| Issue date                                        | ✓                                                                                                                                           |
| Due date                                          | ✓                                                                                                                                           |
| Invoice number                                    | Reference                                                                                                                                   |
| Invoice item name                                 | ✓                                                                                                                                           |
| Invoice item quantity                             | ✓                                                                                                                                           |
| Invoice item price                                | ✓                                                                                                                                           |
| Invoice item discount                             | ✓                                                                                                                                           |
| Tax                                               | ✗                                                                                                                                           |
| Invoice status                                    | ✗ — always created as a draft, regardless of the invoice's status in Spacebring                                                             |
| Invoice PDF                                       | Attachment                                                                                                                                  |

Invoice in Spacebring:

<Frame>
  <img src="https://mintcdn.com/spacebring/Fo24Eoiwd1mDGMUW/images/integrations-accounting-odoo-how-invoices-sync-invoice-in-spacebring.png?fit=max&auto=format&n=Fo24Eoiwd1mDGMUW&q=85&s=9096d36ef67d5340a31ff5a04a4a8354" alt="Integrations Accounting Odoo How Invoices Sync Invoice In Spacebring" width="2379" height="1238" data-path="images/integrations-accounting-odoo-how-invoices-sync-invoice-in-spacebring.png" />
</Frame>

Invoice in Odoo:

<Frame>
  <img src="https://mintcdn.com/spacebring/Fo24Eoiwd1mDGMUW/images/integrations-accounting-odoo-how-invoices-sync-invoice-in-odoo.png?fit=max&auto=format&n=Fo24Eoiwd1mDGMUW&q=85&s=2f3b213fc9bd4867dd930ec716e63db8" alt="Integrations Accounting Odoo How Invoices Sync Invoice In Odoo" width="2815" height="1460" data-path="images/integrations-accounting-odoo-how-invoices-sync-invoice-in-odoo.png" />
</Frame>

### How credit notes sync

Spacebring syncs credit notes issued in Spacebring for unpaid invoices to Odoo as draft credit notes, with their items, quantities, and prices. Each draft credit note links to the original invoice in Odoo.

<Warning>
  Applied balance, partial payments, credit notes for paid invoices, and refunds don't sync to Odoo.
</Warning>

## Disconnect the Odoo integration

1. Click the menu **(...)** next to the location's name > go to **Integrations**.
2. Select **Odoo** > press **Disconnect** and confirm your choice.
