Odoo integration reference

POST /companies/{companyId}/odoo/connect

{
  "url": "https://my-company.odoo.com",
  "database": "my-company",
  "username": "admin@example.com",
  "apiKey": "{odoo_api_key}",
  "connectionId": "existing-connection-uuid"
}

{
  "id": "connection-uuid",
  "integrationKey": "odoo",
  "companyId": "company-uuid",
  "status": "connected",
  "providerMetadata": {
    "url": "https://my-company.odoo.com",
    "database": "my-company",
    "username": "admin@example.com"
  }
}

POST /customers/{connectionId}

{
  "name": "Acme Corp",
  "email": "billing@acme.com"
}

{
  "customer": {
    "id": "customer-uuid",
    "customerCode": "CUST-XXXXXXXX-XXXXXX",
    "name": "Acme Corp",
    "email": "billing@acme.com",
    "syncStatus": "pending"
  },
  "message": "Customer created successfully and queued for sync",
  "syncBatchId": "sync-batch-uuid",
  "syncedToBookkeeping": false
}

POST /suppliers/connection/{connectionId}

{
  "supplierName": "Office Supplies Co",
  "emailAddress": "ap@officesupplies.example"
}

POST /accounts/{connectionId}

{
  "name": "Office Expenses",
  "code": "6100",
  "category": "Expense"
}

POST /bills

{
  "supplierRef": { "id": "supplier-uuid" },
  "issueDate": "2026-01-15",
  "lineItems": [
    {
      "description": "Consulting services",
      "quantity": 1,
      "unitAmount": 500,
      "accountRef": { "id": "account-uuid" }
    }
  ]
}

{
  "move_type": "in_invoice",
  "partner_id": 42,
  "invoice_date": "2026-01-15",
  "invoice_line_ids": [
    [0, 0, {
      "name": "Consulting services",
      "quantity": 1,
      "price_unit": 500,
      "account_id": 30
    }]
  ]
}