# alemarquina/odoo-amazon architecture

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

- Interactive diagram: https://gitdiagram.com/alemarquina/odoo-amazon
- Repository: https://github.com/alemarquina/odoo-amazon

## Overview

This Odoo add-on centralizes Amazon marketplace data and account configuration. Its documented user workflow is to configure an Amazon instance, choose it as the default, then use an import wizard for categories, products, customers, or orders; however, the sampled wizard’s synchronization action is a stub, so completed imports are not evidenced. The module also models Amazon listing and order details and refreshes account tokens through Amazon endpoints. The README documents automatic order and product synchronization, but the sampled source does not establish those runtime paths.

Main entry points: [`models/amz_marketplace_mixin.py`](https://github.com/alemarquina/odoo-amazon/blob/main/models/amz_marketplace_mixin.py) (Marketplace assignment), [`models/inherit_vex_instance.py`](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_vex_instance.py) (Amazon instance), [`models/res_config_settings.py`](https://github.com/alemarquina/odoo-amazon/blob/main/models/res_config_settings.py) (Default instance setting), [`wizard/wizard_action.py`](https://github.com/alemarquina/odoo-amazon/blob/main/wizard/wizard_action.py) (Import wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and access"]
  node_instance["Amazon instance"]
  node_instance_model["Amazon instance model<br/>[amazon_intance.py]"]
end

subgraph group_records["Marketplace records"]
  node_marketplace_mixin["Marketplace assignment"]
  node_products["Amazon products<br/>[amz_product.py]"]
  node_product_template["Product listings"]
  node_categories["Product categories"]
  node_orders["Sales orders"]
  node_customers["Customer partners"]
  node_order_view["Order views<br/>[amz_sale_order.xml]"]
  node_product_views["Product views"]
  node_category_view["Category views"]
  node_partner_view["Partner views"]
end

subgraph group_operations["Import operations"]
  node_wizard["Import wizard<br/>[wizard_action.py]"]
end

subgraph group_settings["Configuration"]
  node_settings["Default instance setting"]
  node_settings_view["Settings and wizard views"]
end

node_odoo_user(("Odoo user"))
node_amazon_api["Amazon auth API"]

node_odoo_user -.->|"configures"| node_instance
node_instance -->|"requests tokens"| node_amazon_api
node_instance -->|"fetches profile"| node_amazon_api
node_product_template -->|"inherits"| node_marketplace_mixin
node_categories -->|"inherits"| node_marketplace_mixin
node_orders -->|"inherits"| node_marketplace_mixin
node_customers -->|"inherits"| node_marketplace_mixin
node_odoo_user -.->|"selects import"| node_wizard
node_settings -->|"provides default"| node_wizard
node_odoo_user -.->|"configures"| node_settings
node_settings_view -.->|"configures"| node_settings
node_settings_view -.->|"presents"| node_wizard
node_order_view -.->|"presents"| node_orders
node_product_views -.->|"presents"| node_product_template
node_category_view -.->|"presents"| node_categories
node_partner_view -.->|"presents"| node_customers

click node_instance "https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_vex_instance.py"
click node_instance_model "https://github.com/alemarquina/odoo-amazon/blob/main/models/amazon_intance.py"
click node_marketplace_mixin "https://github.com/alemarquina/odoo-amazon/blob/main/models/amz_marketplace_mixin.py"
click node_products "https://github.com/alemarquina/odoo-amazon/blob/main/models/amz_product.py"
click node_product_template "https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_product_template_amazon.py"
click node_categories "https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_category_amazon.py"
click node_orders "https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_order_amazon.py"
click node_customers "https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_res_partner_amazon.py"
click node_wizard "https://github.com/alemarquina/odoo-amazon/blob/main/wizard/wizard_action.py"
click node_settings "https://github.com/alemarquina/odoo-amazon/blob/main/models/res_config_settings.py"
click node_settings_view "https://github.com/alemarquina/odoo-amazon/blob/main/wizard/wizard_res_config_settings.xml"
click node_order_view "https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_sale_order.xml"
click node_product_views "https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_product_template.xml"
click node_category_view "https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_product_category.xml"
click node_partner_view "https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_res_partner.xml"

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_instance,node_instance_model,node_odoo_user toneBlue
class node_marketplace_mixin,node_products,node_product_template,node_categories,node_orders,node_customers,node_order_view,node_product_views,node_category_view,node_partner_view toneAmber
class node_wizard,node_amazon_api toneMint
class node_settings,node_settings_view toneRose
```

## Components

### Accounts and access

- [Amazon instance](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_vex_instance.py): `models/inherit_vex_instance.py`
- [Amazon instance model](https://github.com/alemarquina/odoo-amazon/blob/main/models/amazon_intance.py): `models/amazon_intance.py`

### Marketplace records

- [Marketplace assignment](https://github.com/alemarquina/odoo-amazon/blob/main/models/amz_marketplace_mixin.py): `models/amz_marketplace_mixin.py`
- [Amazon products](https://github.com/alemarquina/odoo-amazon/blob/main/models/amz_product.py): `models/amz_product.py`
- [Product listings](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_product_template_amazon.py): `models/inherit_product_template_amazon.py`
- [Product categories](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_category_amazon.py): `models/inherit_category_amazon.py`
- [Sales orders](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_order_amazon.py): `models/inherit_order_amazon.py`
- [Customer partners](https://github.com/alemarquina/odoo-amazon/blob/main/models/inherit_res_partner_amazon.py): `models/inherit_res_partner_amazon.py`
- [Order views](https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_sale_order.xml): `views/amz_sale_order.xml`
- [Product views](https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_product_template.xml): `views/amz_product_template.xml`
- [Category views](https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_product_category.xml): `views/amz_product_category.xml`
- [Partner views](https://github.com/alemarquina/odoo-amazon/blob/main/views/amz_res_partner.xml): `views/amz_res_partner.xml`

### Import operations

- [Import wizard](https://github.com/alemarquina/odoo-amazon/blob/main/wizard/wizard_action.py): `wizard/wizard_action.py`

### Configuration

- [Default instance setting](https://github.com/alemarquina/odoo-amazon/blob/main/models/res_config_settings.py): `models/res_config_settings.py`
- [Settings and wizard views](https://github.com/alemarquina/odoo-amazon/blob/main/wizard/wizard_res_config_settings.xml): `wizard/wizard_res_config_settings.xml`

### Other components

- **Odoo user**
- **Amazon auth API**

## Connections

- Odoo user → Amazon instance: configures (evidence: `README.md`)
- Amazon instance → Amazon auth API: requests tokens (evidence: `models/inherit_vex_instance.py`)
- Amazon instance → Amazon auth API: fetches profile (evidence: `models/inherit_vex_instance.py`)
- Product listings → Marketplace assignment: inherits (evidence: `models/inherit_product_template_amazon.py`)
- Product categories → Marketplace assignment: inherits (evidence: `models/inherit_category_amazon.py`)
- Sales orders → Marketplace assignment: inherits (evidence: `models/inherit_order_amazon.py`)
- Customer partners → Marketplace assignment: inherits (evidence: `models/inherit_res_partner_amazon.py`)
- Odoo user → Import wizard: selects import (evidence: `README.md`)
- Default instance setting → Import wizard: provides default (evidence: `wizard/wizard_action.py`)
- Odoo user → Default instance setting: configures (evidence: `README.md`)
- Settings and wizard views → Default instance setting: configures
- Settings and wizard views → Import wizard: presents
- Order views → Sales orders: presents
- Product views → Product listings: presents
- Category views → Product categories: presents
- Partner views → Customer partners: presents
