# marcfargas/n8n-nodes-odoo architecture

> Architecture diagram of the GitHub repository marcfargas/n8n-nodes-odoo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcfargas/n8n-nodes-odoo
- Repository: https://github.com/marcfargas/n8n-nodes-odoo

## Overview

This is an n8n community node that turns workflow inputs into Odoo operations and returns workflow data. The main path runs through the Odoo node, which obtains a credential-backed client, then executes CRUD, method, chatter, property, schema, or URL operations; its descriptions provide the n8n resource and operation controls. A separate polling trigger queries changed records and maintains its poll cursor. The excerpts show the node’s calls into the client and introspector, but not the internals of those external libraries or the credential implementation.

Main entry points: [`nodes/Odoo/Odoo.node.ts`](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/Odoo.node.ts) (Odoo Operations Node), [`nodes/Odoo/descriptions/index.ts`](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/index.ts) (Description Exports), [`nodes/Odoo/OdooTrigger.node.ts`](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/OdooTrigger.node.ts) (Polling Trigger), [`nodes/Odoo/GenericFunctions.ts`](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/GenericFunctions.ts) (Client Factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["n8n Workflow Nodes"]
  node_main_node["Odoo Operations Node<br/>[Odoo.node.ts]"]
  node_trigger["Polling Trigger"]
end

subgraph group_operations["Odoo Operations"]
  node_record["Record CRUD"]
  node_method["Model Methods"]
  node_message["Chatter Messages"]
  node_property["Dynamic Properties"]
  node_schema["Schema Introspection"]
  node_url["Record and Portal URLs<br/>[UrlDescription.ts]"]
end

subgraph group_adapter["Connection Adapter"]
  node_client_adapter["Client Factory"]
  node_odoo_client["Odoo Client Library"]
  node_introspection_library["Introspection Library"]
end

subgraph group_configuration["Node Configuration"]
  node_descriptions_index["Description Exports<br/>[index.ts]"]
end

node_workflow_user(("Workflow Author"))
node_n8n(("n8n Runtime"))
node_odoo[("Odoo ERP")]

node_workflow_user -->|"configures workflow"| node_n8n
node_n8n -->|"executes operations"| node_main_node
node_n8n -->|"runs polling"| node_trigger
node_main_node -->|"uses controls"| node_descriptions_index
node_descriptions_index -->|"exports controls"| node_record
node_descriptions_index -->|"exports controls"| node_method
node_descriptions_index -->|"exports controls"| node_message
node_descriptions_index -->|"exports controls"| node_property
node_descriptions_index -->|"exports controls"| node_schema
node_descriptions_index -->|"exports controls"| node_url
node_main_node -->|"gets client"| node_client_adapter
node_trigger -->|"gets client"| node_client_adapter
node_client_adapter -->|"creates and authenticates"| node_odoo_client
node_client_adapter -->|"creates introspector"| node_introspection_library
node_main_node -->|"performs CRUD and methods"| node_odoo_client
node_main_node -->|"posts chatter messages"| node_odoo_client
node_main_node -->|"reads and updates properties"| node_odoo_client
node_main_node -->|"lists models and fields"| node_introspection_library
node_main_node -->|"generates URLs"| node_odoo_client
node_trigger -->|"searches changed records"| node_odoo_client
node_odoo_client -.->|"accesses Odoo"| node_odoo
node_introspection_library -.->|"discovers schema"| node_odoo
node_main_node -->|"returns workflow data"| node_n8n
node_trigger -->|"emits records"| node_n8n

click node_main_node "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/Odoo.node.ts"
click node_trigger "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/OdooTrigger.node.ts"
click node_client_adapter "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/GenericFunctions.ts"
click node_record "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/RecordDescription.ts"
click node_method "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/MethodDescription.ts"
click node_message "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/MessageDescription.ts"
click node_property "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/PropertyDescription.ts"
click node_schema "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/SchemaDescription.ts"
click node_url "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/UrlDescription.ts"
click node_descriptions_index "https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main_node,node_trigger toneBlue
class node_record,node_method,node_message,node_property,node_schema,node_url,node_odoo toneAmber
class node_client_adapter,node_odoo_client,node_introspection_library toneMint
class node_descriptions_index toneRose
class node_workflow_user,node_n8n toneIndigo
```

## Components

### n8n Workflow Nodes

- [Odoo Operations Node](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/Odoo.node.ts): `nodes/Odoo/Odoo.node.ts`
- [Polling Trigger](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/OdooTrigger.node.ts): `nodes/Odoo/OdooTrigger.node.ts`

### Odoo Operations

- [Record CRUD](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/RecordDescription.ts): `nodes/Odoo/descriptions/RecordDescription.ts`
- [Model Methods](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/MethodDescription.ts): `nodes/Odoo/descriptions/MethodDescription.ts`
- [Chatter Messages](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/MessageDescription.ts): `nodes/Odoo/descriptions/MessageDescription.ts`
- [Dynamic Properties](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/PropertyDescription.ts): `nodes/Odoo/descriptions/PropertyDescription.ts`
- [Schema Introspection](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/SchemaDescription.ts): `nodes/Odoo/descriptions/SchemaDescription.ts`
- [Record and Portal URLs](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/UrlDescription.ts): `nodes/Odoo/descriptions/UrlDescription.ts`

### Connection Adapter

- [Client Factory](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/GenericFunctions.ts): `nodes/Odoo/GenericFunctions.ts`
- **Odoo Client Library**
- **Introspection Library**

### Node Configuration

- [Description Exports](https://github.com/marcfargas/n8n-nodes-odoo/blob/main/nodes/Odoo/descriptions/index.ts): `nodes/Odoo/descriptions/index.ts`

### Other components

- **Workflow Author**
- **n8n Runtime**
- **Odoo ERP**

## Connections

- Workflow Author → n8n Runtime: configures workflow (evidence: `README.md`)
- n8n Runtime → Odoo Operations Node: executes operations (evidence: `README.md`)
- n8n Runtime → Polling Trigger: runs polling (evidence: `README.md`)
- Odoo Operations Node → Description Exports: uses controls (evidence: `nodes/Odoo/Odoo.node.ts`)
- Description Exports → Record CRUD: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Description Exports → Model Methods: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Description Exports → Chatter Messages: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Description Exports → Dynamic Properties: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Description Exports → Schema Introspection: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Description Exports → Record and Portal URLs: exports controls (evidence: `nodes/Odoo/descriptions/index.ts`)
- Odoo Operations Node → Client Factory: gets client (evidence: `nodes/Odoo/Odoo.node.ts`)
- Polling Trigger → Client Factory: gets client (evidence: `nodes/Odoo/OdooTrigger.node.ts`)
- Client Factory → Odoo Client Library: creates and authenticates (evidence: `nodes/Odoo/GenericFunctions.ts`)
- Client Factory → Introspection Library: creates introspector (evidence: `nodes/Odoo/GenericFunctions.ts`)
- Odoo Operations Node → Odoo Client Library: performs CRUD and methods (evidence: `nodes/Odoo/Odoo.node.ts`)
- Odoo Operations Node → Odoo Client Library: posts chatter messages (evidence: `nodes/Odoo/Odoo.node.ts`)
- Odoo Operations Node → Odoo Client Library: reads and updates properties (evidence: `nodes/Odoo/Odoo.node.ts`)
- Odoo Operations Node → Introspection Library: lists models and fields (evidence: `nodes/Odoo/Odoo.node.ts`)
- Odoo Operations Node → Odoo Client Library: generates URLs (evidence: `nodes/Odoo/Odoo.node.ts`)
- Polling Trigger → Odoo Client Library: searches changed records (evidence: `nodes/Odoo/OdooTrigger.node.ts`)
- Odoo Client Library → Odoo ERP: accesses Odoo
- Introspection Library → Odoo ERP: discovers schema
- Odoo Operations Node → n8n Runtime: returns workflow data (evidence: `nodes/Odoo/Odoo.node.ts`)
- Polling Trigger → n8n Runtime: emits records (evidence: `nodes/Odoo/OdooTrigger.node.ts`)
