接 Odoo：拉订单与客户进来，查库存
在 Odoo 的 My Profile → Account Security 里新建 API Key，把实例地址、数据库名、用户名和 API Key 填进 Integration，测试、配 Mapping、激活——销售订单与客户拉进来，库存可查。
Odoo 连接器把您 Odoo ERP 里的销售订单与客户拉进本系统，还能查 Odoo 里的库存数量。它是从 Odoo 读数据：不把库存变化推回 Odoo，不拉发票，也不把履约回传 Odoo。一个 Odoo 实例加数据库对应一个连接。
前置条件#
- 一个能登录的 Odoo 实例，以及一个供集成使用的 Odoo 用户登录名。
- Odoo Online 注意：只有 Custom 套餐才开放外部 API。其他 Odoo Online 套餐填什么都连不上——开始前先确认套餐。
- 您知道实例地址（如 https://mycompany.odoo.com；自建则填自有服务器地址）和数据库名——数据库名在 Odoo 登录页的数据库选择器里，Odoo Online 通常就是子域名。
- 在 Odoo 里有打开 My Profile 并在 Account Security 页签下新建 API Key 的权限。
拿凭证#
- 用集成用户登录 Odoo，点右上角头像，打开 My Profile。
- 打开 Account Security 页签，点 New API Key。
- 复制 Odoo 生成的 API Key。本连接里 API Key 在登录时当密码用，所以不用再找单独的密码——Key 本身就填在密码的位置。
- 同时记下另外三个值：实例地址、数据库名（在 Odoo 登录页的数据库选择器里，Odoo Online 通常是子域名），以及同一个用户的登录名。
填进 Integration#
- 打开 Integration → 连接器市场 → Odoo → 新建连接。
- base_url——必填，Odoo 实例地址：填您的实例地址，例如 https://mycompany.odoo.com。自建实例填自有服务器地址。必须以 http:// 或 https:// 开头。
- database——必填，数据库名：填 Odoo 登录页数据库选择器里显示的数据库名，例如 mycompany。Odoo Online 通常就是实例地址的子域名。
- username——必填，用户名（登录名）：填集成用 Odoo 用户的登录名，例如 admin。要用创建 API Key 的同一个用户的登录名——登录名的具体形态以您的实例为准。
- api_key——必填，API Key：粘贴从 My Profile → Account Security → New API Key 复制的 API Key。这是密码类型字段，按密码的方式使用，作为秘密保存。
测试连接#
点测试连接。测试做两步真实校验。第一步不登录、先向实例问版本号，确认地址能应答并读到服务器版本。第二步用您的 database、username 和 api_key 真的登录一次——Key 当密码用——登录成功才算测通。也就是说：地址对但 Key 错，测不通；地址只证明实例可达，登录才证明凭证对。base_url 缺失或不以 http://、https:// 开头，测试会以 MISSING_BASE_URL 停下；database、username、api_key 任一缺失，会以 MISSING_CREDENTIALS 停下，因为真实登录三者缺一不可。
配 Mapping / 选模板#
选 Odoo 标准 Mapping。它对接 Odoo 的标准模型：销售订单来自 sale.order，客户来自 res.partner，库存查询读 product.product。测试通过后先拉一次，把一个真实订单对照核对——订单号、客户、明细行与数量——再拿一个产品的数量和 Odoo 里显示的对一遍，确认后再激活。如果您实例上的某个字段与标准模型不同，在 Mapping 里调整那个字段，不要去改 Odoo 里的东西。
激活#
激活后，连接按您设的频率把 Odoo 的销售订单与客户拉进本系统，库存查询从 Odoo 读当前数量。先在 运行监控 / 日志里盯头几次拉取、和 Odoo 对照无误，再放手跑。
这个连接不做的事：不把库存变化推回 Odoo，不从 Odoo 拉发票，也不把履约或发货结果回传 Odoo。这些事请继续在 Odoo 里处理，或在实际作业的系统里处理。
常见问题#
地址能打开，但测试报 AUTH_FAILED
实例是可达的——问版本号那步应答了——但真实登录被拒了。这说明 database、username 或 api_key 对不上：三个值必须是一套，Key 必须是与 username 同一个用户的。光地址对，这个测试是过不了的。
给集成用户重新建一个 API Key（右上头像 → My Profile → Account Security 页签 → New API Key），原样复制进 api_key 字段；再到 Odoo 登录页的数据库选择器核对 database、用该用户的登录名核对 username，然后重新测试。
测试以 MISSING_CREDENTIALS 或 MISSING_BASE_URL 停下
四个字段里有空的，或地址不可用。MISSING_BASE_URL 表示 base_url 缺失或不以 http://、https:// 开头。MISSING_CREDENTIALS 表示 database、username、api_key 有缺失——三者不全，测试没法做真实登录。
按填进 Integration 一节把四个字段补全：base_url 填含 http:// 或 https:// 的完整实例地址，database、username 补齐，api_key 完整粘贴不要截断。保存后重新测试。
每个值看着都对，但 Odoo Online 就是连不上
您的 Odoo Online 套餐不包含外部 API 访问。Odoo Online 只有 Custom 套餐才开放外部 API，其他套餐在浏览器里能打开实例，但外部 API 调用用不了——问题不在填的值。
先确认 Odoo Online 实例的套餐。把实例升到 Custom 套餐后，用同样的四个值重新测试同一个连接——这期间不要反复改值。
连接成功，但没有销售订单拉进来
连接是通的——测试已经真实登录成功——只是没有新单可拉：Odoo 数据库在拉单范围内没有新的销售订单，或那里的单据不是 sale.order 上的销售订单。
在 Odoo 里新建或确认一个销售订单，确认它在连接使用的同一个数据库里，再手动拉一次，在预览或 运行监控 / 日志里确认订单出现。