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

# Odoo

> Connect your Odoo ERP for inventory tracking, serial numbers, and order data

## Overview

Integrate your Odoo ERP system with Telemetron to enable the AI agent to look up serial numbers, check inventory levels, and access order data. This is especially useful for hardware companies that need traceability across orders and serial numbers.

## Prerequisites

* An Odoo instance with External API access enabled (requires a **Custom Odoo plan** for Odoo Online)
* A user account with read access to **Sales**, **Inventory**, and **Contacts** modules
* The **Lots & Serial Numbers** feature enabled in Odoo Inventory settings
* An API key generated for the connecting user

## Setup

<Steps>
  <Step title="Open Odoo integration settings">
    In Telemetron, go to **Settings > Integrations > Odoo**.
  </Step>

  <Step title="Enter your Odoo URL">
    Enter your Odoo instance URL (e.g., `https://yourcompany.odoo.com`).
  </Step>

  <Step title="Enter the database name">
    Enter the **Database Name** for your Odoo instance.
  </Step>

  <Step title="Enter your username">
    Enter your **Username** (typically your email address).
  </Step>

  <Step title="Generate and enter an API key">
    In Odoo, go to **Preferences > Account Security > API Keys** and generate a new API key. Copy it and paste it into the API Key field in Telemetron.
  </Step>

  <Step title="Connect">
    Click **Connect Odoo** to complete the setup.
  </Step>
</Steps>

## Configuration

Once connected, the integration page displays your Odoo URL, database name, and username. You can update credentials or disconnect at any time from the integration settings page.

## How It Works

With Odoo connected, the AI agent can:

* **Look up serial numbers** by Shopify order reference to find which units were shipped
* **Get full traceability** for a serial number, including manufacturing, shipping, and delivery history
* **Check inventory levels** for specific products or warehouses
* **Search serial numbers by pattern** to quickly locate units across your system

## Troubleshooting

| Issue                    | Solution                                                                                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| Connection fails         | Verify that your Odoo plan supports External API access. Odoo Online requires a **Custom plan** for API access.       |
| Authentication error     | Double-check your username and API key. Ensure the API key was generated for the correct user.                        |
| Serial numbers not found | Confirm that the **Lots & Serial Numbers** feature is enabled in Odoo under **Inventory > Configuration > Settings**. |
| Permission errors        | Ensure the connecting user has read access to the Sales, Inventory, and Contacts modules.                             |