---
title: Odoo API Integration on Truto
slug: odoo
category: Accounting
canonical: "https://truto.one/integrations/detail/odoo/"
---

# Odoo API Integration on Truto



**Category:** Accounting  
**Status:** Generally available

## Unified APIs

### Unified Accounting API

- **Accounts** — Account represents bank accounts or a general ledger account
- **Attachments** — Attachment represents the company's attachment
- **Company Info** — Company Info represents the company's information
- **Contact Groups** — ContactGroup represents the groupings used by the company for their contacts
- **Contacts** — Contacts represents the company's vendor or a customer
- **Credit Notes** — Credit Notes represents the credit notes of the company
- **Currencies** — Currency represents the currencies used by the company
- **Employees** — Employee represents an employee of the company
- **Invoices** — Invoices represents the invoices of the company
- **Items** — Items represents the items of the company
- **Journal Entries** — Journal Entries represents the journal entries of the company
- **Payment Method** — Payment method represents the payment methods of the company
- **Payments** — Payments represents the payments of the company
- **Tax Rates** — TaxRates represents the tax rates of the company
- **Tracking Categories** — TrackingCategories represents the tracking categories of the company
- **Transactions** — Transactions represents the transactions of the company
- **Vendor Credits** — VendorCredits represents the vendor credits of the company

## MCP-ready AI tools

Truto exposes 199 tools for Odoo that AI agents can call directly.

- **list_all_odoo_contacts** — List contact (company or individual: customers, vendors, addresses) records (`res.partner`, Contacts app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_contact_by_id** — Get one contact record (`res.partner`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_contact** — Create a contact record (`res.partner`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_contact_by_id** — Update a contact record (`res.partner`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_contact_by_id** — Permanently delete a contact record (`res.partner`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_companies** — List company (the user's own legal entities) records (`res.company`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_company_by_id** — Get one company record (`res.company`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_company** — Create a company record (`res.company`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_company_by_id** — Update a company record (`res.company`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_company_by_id** — Permanently delete a company record (`res.company`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_users** — List user records (`res.users`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_user_by_id** — Get one user record (`res.users`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_user** — Create a user record (`res.users`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `login`.
- **update_a_odoo_user_by_id** — Update a user record (`res.users`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_user_by_id** — Permanently delete a user record (`res.users`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_countries** — List country records (`res.country`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_country_by_id** — Get one country record (`res.country`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_country** — Create a country record (`res.country`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `code`.
- **update_a_odoo_country_by_id** — Update a country record (`res.country`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_country_by_id** — Permanently delete a country record (`res.country`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_country_states** — List country state / province records (`res.country.state`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_country_state_by_id** — Get one country state / province record (`res.country.state`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_country_state** — Create a country state / province record (`res.country.state`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `code`, `country_id`.
- **update_a_odoo_country_state_by_id** — Update a country state / province record (`res.country.state`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_country_state_by_id** — Permanently delete a country state / province record (`res.country.state`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_currencies** — List currency records (`res.currency`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_currency_by_id** — Get one currency record (`res.currency`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_currency** — Create a currency record (`res.currency`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `symbol`.
- **update_a_odoo_currency_by_id** — Update a currency record (`res.currency`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_currency_by_id** — Permanently delete a currency record (`res.currency`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_bank_accounts** — List partner bank account records (`res.partner.bank`, Base app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_bank_account_by_id** — Get one partner bank account record (`res.partner.bank`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_bank_account** — Create a partner bank account record (`res.partner.bank`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `acc_number`, `partner_id`.
- **update_a_odoo_bank_account_by_id** — Update a partner bank account record (`res.partner.bank`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_bank_account_by_id** — Delete a partner bank account. Odoo never hard-deletes bank accounts: `unlink` archives them (`active = false`) and returns `true`.
- **list_all_odoo_products** — List product variant records (`product.product`, Product app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_product_by_id** — Get one product variant record (`product.product`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_product** — Create a product variant record (`product.product`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_product_by_id** — Update a product variant record (`product.product`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_product_by_id** — Permanently delete a product variant record (`product.product`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_product_templates** — List product template records (`product.template`, Product app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_product_template_by_id** — Get one product template record (`product.template`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_product_template** — Create a product template record (`product.template`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_product_template_by_id** — Update a product template record (`product.template`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_product_template_by_id** — Permanently delete a product template record (`product.template`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_product_categories** — List product category records (`product.category`, Product app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_product_category_by_id** — Get one product category record (`product.category`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_product_category** — Create a product category record (`product.category`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_product_category_by_id** — Update a product category record (`product.category`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_product_category_by_id** — Permanently delete a product category record (`product.category`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_units_of_measure** — List unit of measure records (`uom.uom`, Product app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_units_of_measure_by_id** — Get one unit of measure record (`uom.uom`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_units_of_measure** — Create a unit of measure record (`uom.uom`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`. `relative_factor` needs `relative_uom_id` (the reference unit) set in the same call.
- **update_a_odoo_units_of_measure_by_id** — Update a unit of measure record (`uom.uom`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`. `relative_factor` needs `relative_uom_id` (the reference unit) set in the same call.
- **delete_a_odoo_units_of_measure_by_id** — Permanently delete a unit of measure record (`uom.uom`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_pricelists** — List pricelist records (`product.pricelist`, Product app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_pricelist_by_id** — Get one pricelist record (`product.pricelist`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_pricelist** — Create a pricelist record (`product.pricelist`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_pricelist_by_id** — Update a pricelist record (`product.pricelist`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_pricelist_by_id** — Permanently delete a pricelist record (`product.pricelist`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_sale_orders** — List sales order / quotation records (`sale.order`, Sales app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_sale_order_by_id** — Get one sales order / quotation record (`sale.order`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_sale_order** — Create a sales order / quotation record (`sale.order`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `partner_id`.
- **update_a_odoo_sale_order_by_id** — Update a sales order / quotation record (`sale.order`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_sale_order_by_id** — Permanently delete a sales order / quotation record (`sale.order`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **odoo_sale_orders_confirm** — Confirm a quotation into a sales order (`action_confirm`). Creates the delivery orders/stock moves for storable products.
- **odoo_sale_orders_cancel** — Cancel a sales order (`action_cancel`). May return an Odoo window action (a cancel-reason wizard) instead of `true` when the order has confirmed deliveries or invoices.
- **odoo_sale_orders_revert** — Set a cancelled or sent quotation back to draft (`action_draft`).
- **list_all_odoo_sale_order_lines** — List sales order line records (`sale.order.line`, Sales app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_sale_order_line_by_id** — Get one sales order line record (`sale.order.line`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_sale_order_line** — Create a sales order line record (`sale.order.line`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `order_id`, plus `product_id` unless `display_type` is `line_section` or `line_note`.
- **update_a_odoo_sale_order_line_by_id** — Update a sales order line record (`sale.order.line`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_sale_order_line_by_id** — Permanently delete a sales order line record (`sale.order.line`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_purchase_orders** — List purchase order / RFQ records (`purchase.order`, Purchase app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_purchase_order_by_id** — Get one purchase order / RFQ record (`purchase.order`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_purchase_order** — Create a purchase order / RFQ record (`purchase.order`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `partner_id`.
- **update_a_odoo_purchase_order_by_id** — Update a purchase order / RFQ record (`purchase.order`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_purchase_order_by_id** — Permanently delete a purchase order / RFQ record (`purchase.order`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **odoo_purchase_orders_confirm** — Confirm an RFQ into a purchase order (`button_confirm`). Creates the incoming receipts.
- **odoo_purchase_orders_cancel** — Cancel a purchase order (`button_cancel`).
- **odoo_purchase_orders_revert** — Set a cancelled purchase order back to RFQ (`button_draft`).
- **list_all_odoo_purchase_order_lines** — List purchase order line records (`purchase.order.line`, Purchase app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_purchase_order_line_by_id** — Get one purchase order line record (`purchase.order.line`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_purchase_order_line** — Create a purchase order line record (`purchase.order.line`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `order_id`, plus `product_id` unless `display_type` is `line_section` or `line_note`.
- **update_a_odoo_purchase_order_line_by_id** — Update a purchase order line record (`purchase.order.line`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_purchase_order_line_by_id** — Permanently delete a purchase order line record (`purchase.order.line`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_account_moves** — List journal entry (customer invoices, vendor bills, credit notes and misc. entries; filter by move_type) records (`account.move`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_account_move_by_id** — Get one journal entry record (`account.move`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_account_move** — Create a journal entry record (`account.move`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: none (other fields have defaults).
- **update_a_odoo_account_move_by_id** — Update a journal entry record (`account.move`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_account_move_by_id** — Permanently delete a journal entry record (`account.move`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **odoo_account_moves_confirm** — Post (confirm) a draft invoice, bill or journal entry (`action_post`). Assigns the final sequence number and books it in the ledger.
- **odoo_account_moves_revert** — Reset a posted or cancelled entry to draft (`button_draft`). Fails if the journal or lock date forbids it.
- **odoo_account_moves_cancel** — Cancel a draft entry (`button_cancel`).
- **list_all_odoo_account_move_lines** — List journal item (invoice/bill line or accounting line) records (`account.move.line`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_account_move_line_by_id** — Get one journal item record (`account.move.line`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_account_move_line** — Create a journal item record (`account.move.line`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `move_id`. Lines can only be added to or changed on draft entries; post the entry with `account_moves` `confirm` once debits and credits balance.
- **update_a_odoo_account_move_line_by_id** — Update a journal item record (`account.move.line`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`. Lines can only be added to or changed on draft entries; post the entry with `account_moves` `confirm` once debits and credits balance.
- **delete_a_odoo_account_move_line_by_id** — Permanently delete a journal item record (`account.move.line`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_payments** — List payment records (`account.payment`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_payment_by_id** — Get one payment record (`account.payment`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_payment** — Create a payment record (`account.payment`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `amount`.
- **update_a_odoo_payment_by_id** — Update a payment record (`account.payment`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_payment_by_id** — Permanently delete a payment record (`account.payment`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_accounts** — List chart-of-accounts account records (`account.account`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_account_by_id** — Get one chart-of-accounts account record (`account.account`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_account** — Create a chart-of-accounts account record (`account.account`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `code`, `account_type`.
- **update_a_odoo_account_by_id** — Update a chart-of-accounts account record (`account.account`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_account_by_id** — Permanently delete a chart-of-accounts account record (`account.account`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_journals** — List accounting journal records (`account.journal`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_journal_by_id** — Get one accounting journal record (`account.journal`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_journal** — Create a accounting journal record (`account.journal`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `code`, `type`.
- **update_a_odoo_journal_by_id** — Update a accounting journal record (`account.journal`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_journal_by_id** — Permanently delete a accounting journal record (`account.journal`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_taxes** — List tax records (`account.tax`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_tax_by_id** — Get one tax record (`account.tax`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_tax** — Create a tax record (`account.tax`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `amount`.
- **update_a_odoo_tax_by_id** — Update a tax record (`account.tax`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_tax_by_id** — Permanently delete a tax record (`account.tax`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_payment_terms** — List payment term records (`account.payment.term`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_payment_term_by_id** — Get one payment term record (`account.payment.term`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_payment_term** — Create a payment term record (`account.payment.term`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_payment_term_by_id** — Update a payment term record (`account.payment.term`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_payment_term_by_id** — Permanently delete a payment term record (`account.payment.term`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_analytic_accounts** — List analytic account records (`account.analytic.account`, Invoicing app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_analytic_account_by_id** — Get one analytic account record (`account.analytic.account`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_analytic_account** — Create a analytic account record (`account.analytic.account`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `plan_id`.
- **update_a_odoo_analytic_account_by_id** — Update a analytic account record (`account.analytic.account`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_analytic_account_by_id** — Permanently delete a analytic account record (`account.analytic.account`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_warehouses** — List warehouse records (`stock.warehouse`, Inventory app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_warehouse_by_id** — Get one warehouse record (`stock.warehouse`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_warehouse** — Create a warehouse record (`stock.warehouse`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`, `code`.
- **update_a_odoo_warehouse_by_id** — Update a warehouse record (`stock.warehouse`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_warehouse_by_id** — Delete a warehouse with `unlink`. Odoo normally refuses because its stock rules and operation types reference it; archive it with `update` `{"vals": {"active": false}}` instead. Returns `true` on success.
- **list_all_odoo_stock_locations** — List stock location records (`stock.location`, Inventory app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_stock_location_by_id** — Get one stock location record (`stock.location`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_stock_location** — Create a stock location record (`stock.location`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_stock_location_by_id** — Update a stock location record (`stock.location`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_stock_location_by_id** — Permanently delete a stock location record (`stock.location`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_stock_pickings** — List transfer (receipt, delivery or internal picking) records (`stock.picking`, Inventory app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_stock_picking_by_id** — Get one transfer record (`stock.picking`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_stock_picking** — Create a transfer record (`stock.picking`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `picking_type_id`.
- **update_a_odoo_stock_picking_by_id** — Update a transfer record (`stock.picking`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_stock_picking_by_id** — Permanently delete a transfer record (`stock.picking`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **odoo_stock_pickings_assign** — Check availability and reserve stock for a transfer (`action_assign`).
- **odoo_stock_pickings_validate** — Validate a transfer (`button_validate`). Moves with no quantity set are validated for their full demand. Returns `true` when done, or an Odoo window action (backorder wizard) when only part of the demand is done. Irreversible.
- **odoo_stock_pickings_cancel** — Cancel a transfer (`action_cancel`).
- **list_all_odoo_stock_moves** — List stock move records (`stock.move`, Inventory app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_stock_move_by_id** — Get one stock move record (`stock.move`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_stock_move** — Create a stock move record (`stock.move`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `product_id`, `location_id`, `location_dest_id`, `product_uom_qty`.
- **update_a_odoo_stock_move_by_id** — Update a stock move record (`stock.move`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_stock_move_by_id** — Permanently delete a stock move record (`stock.move`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_stock_quants** — List stock quant (on-hand quantity per product and location) records (`stock.quant`, Inventory app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_stock_quant_by_id** — Get one stock quant record (`stock.quant`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_stock_quant** — Create a stock quant record (`stock.quant`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `product_id`, `location_id`. To count stock, set `inventory_quantity` with query `context={"inventory_mode": true}`, then apply it with `model_methods` `execute` (`model=stock.quant`, `method=action_apply_inventory`, body `{"ids": [id]}`). Quants cannot be deleted.
- **update_a_odoo_stock_quant_by_id** — Update a stock quant record (`stock.quant`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`. To count stock, set `inventory_quantity` with query `context={"inventory_mode": true}`, then apply it with `model_methods` `execute` (`model=stock.quant`, `method=action_apply_inventory`, body `{"ids": [id]}`). Quants cannot be deleted.
- **list_all_odoo_crm_leads** — List CRM lead / opportunity records (`crm.lead`, CRM app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_crm_lead_by_id** — Get one CRM lead / opportunity record (`crm.lead`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_crm_lead** — Create a CRM lead / opportunity record (`crm.lead`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_crm_lead_by_id** — Update a CRM lead / opportunity record (`crm.lead`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_crm_lead_by_id** — Permanently delete a CRM lead / opportunity record (`crm.lead`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_crm_stages** — List CRM pipeline stage records (`crm.stage`, CRM app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_crm_stage_by_id** — Get one CRM pipeline stage record (`crm.stage`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_crm_stage** — Create a CRM pipeline stage record (`crm.stage`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_crm_stage_by_id** — Update a CRM pipeline stage record (`crm.stage`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_crm_stage_by_id** — Permanently delete a CRM pipeline stage record (`crm.stage`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_projects** — List project records (`project.project`, Project app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_project_by_id** — Get one project record (`project.project`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_project** — Create a project record (`project.project`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_project_by_id** — Update a project record (`project.project`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_project_by_id** — Permanently delete a project record (`project.project`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_tasks** — List project task records (`project.task`, Project app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_task_by_id** — Get one project task record (`project.task`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_task** — Create a project task record (`project.task`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_task_by_id** — Update a project task record (`project.task`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_task_by_id** — Permanently delete a project task record (`project.task`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_employees** — List employee records (`hr.employee`, Employees app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_employee_by_id** — Get one employee record (`hr.employee`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_employee** — Create a employee record (`hr.employee`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_employee_by_id** — Update a employee record (`hr.employee`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_employee_by_id** — Permanently delete a employee record (`hr.employee`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **list_all_odoo_departments** — List department records (`hr.department`, Employees app) with `search_read`. Filter with an Odoo `domain`, choose `fields`, sort with `order`. Paginates with offset/limit (200 per page by default).
- **get_single_odoo_department_by_id** — Get one department record (`hr.department`) by ID with `read`. Returns 404 when the ID does not exist or is not readable.
- **create_a_odoo_department** — Create a department record (`hr.department`). Body: `{"vals_list": {...field values}}` (or an array of value objects to create several). Returns the new IDs as an array. Required fields: `name`.
- **update_a_odoo_department_by_id** — Update a department record (`hr.department`) with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_department_by_id** — Permanently delete a department record (`hr.department`) with `unlink`. Odoo refuses to delete referenced or locked records (posted invoices, confirmed orders); archive those with `update` `{"active": false}` instead. Returns `true`.
- **create_a_odoo_crm_lead_win** — Mark an opportunity as won (`action_set_won` on `crm.lead`).
- **create_a_odoo_crm_lead_loss** — Mark a lead/opportunity as lost (`action_set_lost` on `crm.lead`); archives it. Optional body: `lost_reason_id` (a `crm.lost.reason` ID).

- **list_all_odoo_records** — List records of any Odoo model (including custom `x_` models) with `search_read`. Same filtering as the per-model resources.
- **get_single_odoo_record_by_id** — Get one record of any Odoo model by ID with `read`.
- **create_a_odoo_record** — Create a record in any Odoo model. Body: `{"vals_list": {...field values}}` (or an array of value objects). Returns the new IDs.
- **update_a_odoo_record_by_id** — Update a record in any Odoo model with `write`. Body: `{"vals": {...fields to change}}`. Returns `true`.
- **delete_a_odoo_record_by_id** — Permanently delete a record in any Odoo model with `unlink`. Returns `true`.
- **list_all_odoo_record_counts** — Count the records of a model that match a domain (`search_count`). Returns a single number.
- **list_all_odoo_model_fields** — Describe the fields of a model (`fields_get`): label, type, required/readonly, relation and selection values. Returns one object keyed by field name. Fields vary with the installed apps and custom fields, so use this to discover what a database supports.
- **list_all_odoo_models** — List the models installed in the database (`ir.model`), including custom ones. Needs Settings/technical access rights.
- **odoo_model_methods_execute** — Call any public method of any model, e.g. `sale.order/action_quotation_send` or `res.partner/name_search`. The request body is passed to Odoo as-is: `ids` (array of record IDs, omit for model-level methods), `context`, plus the method's own keyword arguments. Unknown arguments are rejected with an error. Can have side effects.
- **list_all_odoo_current_user** — Get the context of the user the API key belongs to: `uid`, `lang`, `tz`. Use `users` `get` with `uid` for the full profile.
- **list_all_odoo_server_version** — Get the Odoo server version. The JSON-2 API needs version 19.0 or later (Odoo Online 19.0+).

## How it works

1. **Link your customer's Odoo account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Odoo.** The Proxy API is a 1-to-1 mapping of the Odoo API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Embed AP automation and spend management** — Let your customers push approved vendor bills, journal entries, and payments from your spend platform directly into Odoo Accounting. Sync their chart of accounts, taxes, vendors, and analytic accounts so coding happens automatically.
- **Offer native ERP sync for e-commerce and B2B ordering** — Pull product catalogs, pricelists, and real-time stock from Odoo so buyers see accurate availability and contract pricing. Push checkout events as confirmed sales orders that flow into fulfillment and invoicing.
- **Power 3PL and warehouse management integrations** — Keep Odoo as the ERP source of truth while your WMS owns physical operations. Read ready-to-ship pickings, update stock moves, and validate transfers to trigger downstream invoicing automatically.
- **Sync CRM and RevOps data with the ERP** — Push closed-won deals from your sales platform into Odoo as sales orders, keep contacts and companies in sync, and read back order and invoice status so revenue teams work from one record.
- **Build HRIS and payroll journal sync** — Sync employees and departments from your HR platform into Odoo and post summarized payroll journal entries to the general ledger on a recurring schedule, eliminating manual GL uploads.

## What you can build

- **Two-way invoice and bill sync** — Create draft account moves, add line items, and call the confirm action to post invoices or vendor bills to the general ledger with proper sequencing.
- **Chart of accounts and tax mapping UI** — List accounts, journals, taxes, and analytic accounts so your users can map their Odoo coding structure to your product's categories inside your own settings page.
- **Sales order to fulfillment pipeline** — Create sale orders and lines, confirm them to auto-generate stock pickings, then validate pickings to close the loop between your app and Odoo inventory.
- **Real-time product and inventory sync** — Read products, product templates, categories, units of measure, and stock quants to keep catalog and on-hand quantities aligned between Odoo and your storefront.
- **Payment reconciliation flows** — Create payments against posted invoices or bills to mark them paid in Odoo and reflect reconciliation status back in your product.
- **Custom field discovery and mapping** — Use model and field listing to detect each tenant's custom x_ fields on partners, moves, or products and expose them as mappable attributes in your onboarding flow.

## FAQs

### How do end users authenticate their Odoo account?

Odoo connections are established with the user's Odoo instance URL, database name, and either a user password or API key. Truto handles credential storage, token refresh where applicable, and routing requests to each tenant's instance.

### Does this integration support both Odoo Online and self-hosted instances?

Yes. Because connections are made per-instance URL, Truto works with Odoo Online, Odoo.sh, and self-hosted Community or Enterprise deployments, as long as the external API (XML-RPC/JSON-RPC) is reachable.

### How are custom fields and custom models handled?

Odoo tenants frequently add x_ prefixed fields and even custom models. You can use list_all_odoo_models and list_all_odoo_model_fields to discover a tenant's schema at runtime, and the generic list/get/create/update/delete record tools let you read and write any model, including custom ones.

### Can I trigger Odoo's business logic, not just CRUD?

Yes. State-transition actions are exposed as dedicated tools, including confirm/cancel/revert for sale orders, purchase orders, and account moves, plus assign/validate/cancel for stock pickings. You can also invoke arbitrary model methods via odoo_model_methods_execute.

### How does Truto handle invoices, bills, and journal entries?

Odoo stores all of these in account.move with different move_type values. Truto exposes account moves and account move lines directly, so you create the move, add lines, and call the confirm action to post it to the ledger.

### How fresh is the data and how is pagination handled?

Reads hit Odoo's API in real time, so data is as fresh as the instance itself. Truto normalizes pagination and filtering across list endpoints so you don't have to deal with Odoo's offset/limit and domain filter syntax directly.
