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

# Odoo

## Introduction

Qobra connects to Odoo thanks to a user API key.

The integration is used to synchronize tables, with their fields and their
content. This integration is readonly and does not write anything in your Odoo
account.

## Setup

1. Create your API key, as documented [here](https://www.odoo.com/documentation/18.0/developer/reference/external_api.html#api-keys).
2. Fill in information in Qobra:

   * `Username`: the email of the person who created the API key
   * `Password / API Key`: API key (it is not advised connecting directly with password)
   * `Instance URL`: Your Odoo instance URL
   * `Database`: Odoo Database

   <img src="https://mintcdn.com/qobra/4g7tQyP7wYl6AlCt/integration_documentation/images/odoo_screenshot_1.png?fit=max&auto=format&n=4g7tQyP7wYl6AlCt&q=85&s=fdbe8c7e2e1884d852cf170450754de2" alt="Odoo setup in Qobra" width="70%" data-path="integration_documentation/images/odoo_screenshot_1.png" />

## Synchronization

### Refresh Frequency

For Odoo integrations, we maintain a different synchronization schedule than other CRMs:

* **Bi-hourly Full Refresh**: Every 2 hours throughout the day, we perform a complete sync of your Odoo data
* **On-Demand Updates**: Need the latest data right away? Just click the refresh button in your integration settings

Note: Unlike other CRM integrations, Odoo uses full refreshes every 2 hours instead of combining daily full refreshes with incremental updates.

### Supported types

You’ll find below the fields types supported by the Qobra integration,
and their mapping to Qobra types.

| **Odoo type** | **Qobra type**     |
| ------------- | ------------------ |
| `float`       | `number`, `amount` |
| `integer`     | `number`, `user`   |
| `monetary`    | `amount`           |
| `text`        | `string`           |
| `char`        | `string`, `user`   |
| `boolean`     | `bool`             |
| `selection`   | `picklist`         |
| `date`        | `date`             |
| `datetime`    | `date`             |
| `user`        | `user`             |