# frappe/ecommerce_integrations architecture

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

- Interactive diagram: https://gitdiagram.com/frappe/ecommerce_integrations
- Repository: https://github.com/frappe/ecommerce_integrations

## Overview

This Frappe/ERPNext app synchronizes commerce and operations data between ERPNext and Shopify, Unicommerce, Zenoti, and Amazon. The user-facing workflow is to configure an integration, then synchronize incoming events or scheduled data into ERPNext records; supported capabilities also include product, inventory, order, fulfillment, invoicing, returns, and stock flows. The graph preserves these integration branches and shared item/log layers. Some subsystem links reflect README capabilities rather than inspected implementation; edges are limited to documented dispatches and source-index references.

Main entry points: [`ecommerce_integrations/unicommerce/api_client.py`](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/api_client.py) (API client), [`ecommerce_integrations/unicommerce/invoice.py`](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/invoice.py) (Invoices and delivery), [`ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py`](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py) (Settings and scheduling), [`ecommerce_integrations/shopify/order.py`](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/order.py) (Orders and invoices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopify["Shopify"]
  node_shopify_settings["Settings and webhooks<br/>[shopify_setting.py]"]
  node_shopify_events["Webhook routing<br/>[constants.py]"]
  node_shopify_orders["Orders and invoices<br/>[order.py]"]
  node_shopify_products["Products<br/>[product.py]"]
  node_shopify_fulfillment["Fulfillment<br/>[fulfillment.py]"]
  node_shopify_connection["API connection<br/>[connection.py]"]
end

subgraph group_unicommerce["Unicommerce"]
  node_uni_settings["Settings and sync"]
  node_uni_api["API client<br/>[api_client.py]"]
  node_uni_orders["Orders and returns<br/>[order.py]"]
  node_uni_returns["Cancellation and returns"]
  node_uni_invoices["Invoices and delivery<br/>[invoice.py]"]
  node_uni_manifest["Shipment manifests"]
end

subgraph group_zenoti["Zenoti"]
  node_zenoti_settings["Settings and scheduling<br/>[zenoti_settings.py]"]
  node_zenoti_sales["Sales transactions"]
  node_zenoti_purchases["Purchase transactions"]
  node_zenoti_stock["Stock reconciliation"]
  node_zenoti_api["Zenoti API utilities<br/>[utils.py]"]
end

subgraph group_shared["Shared ERPNext"]
  node_amazon_settings["Amazon settings"]
  node_amazon_repository["Amazon data access"]
  node_ecommerce_item[("Item mapping<br/>[ecommerce_item.py]")]
  node_integration_log[("Sync logs and retry")]
  node_taxation["Tax handling<br/>[taxation.py]"]
end

node_operator(("ERPNext user"))

node_operator -.->|"configures"| node_shopify_settings
node_operator -.->|"configures"| node_uni_settings
node_operator -.->|"configures"| node_zenoti_settings
node_operator -.->|"configures"| node_amazon_settings
node_shopify_settings -->|"uses"| node_shopify_connection
node_shopify_events -->|"routes orders"| node_shopify_orders
node_shopify_events -->|"routes fulfillment"| node_shopify_fulfillment
node_shopify_orders -->|"calls"| node_shopify_connection
node_shopify_orders -->|"uses item lookup"| node_shopify_products
node_shopify_fulfillment -->|"loads sales order"| node_shopify_orders
node_shopify_fulfillment -->|"copies tax details"| node_taxation
node_shopify_products -->|"maps items"| node_ecommerce_item
node_uni_settings -.->|"uses client"| node_uni_api
node_uni_orders -.->|"calls"| node_uni_api
node_uni_invoices -->|"calls"| node_uni_api
node_uni_manifest -->|"calls"| node_uni_api
node_uni_invoices -->|"uses order data"| node_uni_orders
node_uni_invoices -->|"uses return data"| node_uni_returns
node_uni_api -->|"records errors"| node_integration_log
node_zenoti_settings -->|"schedules sync"| node_zenoti_sales
node_zenoti_settings -->|"dispatches sync"| node_zenoti_purchases
node_zenoti_settings -->|"dispatches sync"| node_zenoti_stock
node_zenoti_sales -->|"uses utilities"| node_zenoti_api
node_zenoti_purchases -->|"uses utilities"| node_zenoti_api
node_zenoti_stock -->|"uses utilities"| node_zenoti_api
node_amazon_settings -->|"uses repository"| node_amazon_repository
node_amazon_repository -.->|"links items"| node_ecommerce_item
node_uni_invoices -->|"uses tax handling"| node_taxation

click node_shopify_settings "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/doctype/shopify_setting/shopify_setting.py"
click node_shopify_events "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/constants.py"
click node_shopify_orders "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/order.py"
click node_shopify_products "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/product.py"
click node_shopify_fulfillment "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/fulfillment.py"
click node_shopify_connection "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/connection.py"
click node_uni_settings "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/doctype/unicommerce_settings/unicommerce_settings.py"
click node_uni_api "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/api_client.py"
click node_uni_orders "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/order.py"
click node_uni_returns "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/cancellation_and_returns.py"
click node_uni_invoices "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/invoice.py"
click node_uni_manifest "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/doctype/unicommerce_shipment_manifest/unicommerce_shipment_manifest.py"
click node_zenoti_settings "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py"
click node_zenoti_sales "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/sales_transactions.py"
click node_zenoti_purchases "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/purchase_transactions.py"
click node_zenoti_stock "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/stock_reconciliation.py"
click node_zenoti_api "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/utils.py"
click node_amazon_settings "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_sp_api_settings.py"
click node_amazon_repository "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_repository.py"
click node_ecommerce_item "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_item/ecommerce_item.py"
click node_integration_log "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_integration_log/ecommerce_integration_log.py"
click node_taxation "https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/utils/taxation.py"

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_shopify_settings,node_shopify_events,node_shopify_orders,node_shopify_products,node_shopify_fulfillment,node_shopify_connection,node_operator toneBlue
class node_uni_settings,node_uni_api,node_uni_orders,node_uni_returns,node_uni_invoices,node_uni_manifest toneAmber
class node_zenoti_settings,node_zenoti_sales,node_zenoti_purchases,node_zenoti_stock,node_zenoti_api toneMint
class node_amazon_settings,node_amazon_repository,node_ecommerce_item,node_integration_log,node_taxation toneRose
```

## Components

### Shopify

- [Settings and webhooks](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/doctype/shopify_setting/shopify_setting.py): `ecommerce_integrations/shopify/doctype/shopify_setting/shopify_setting.py`
- [Webhook routing](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/constants.py): `ecommerce_integrations/shopify/constants.py`
- [Orders and invoices](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/order.py): `ecommerce_integrations/shopify/order.py`
- [Products](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/product.py): `ecommerce_integrations/shopify/product.py`
- [Fulfillment](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/fulfillment.py): `ecommerce_integrations/shopify/fulfillment.py`
- [API connection](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/shopify/connection.py): `ecommerce_integrations/shopify/connection.py`

### Unicommerce

- [Settings and sync](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/doctype/unicommerce_settings/unicommerce_settings.py): `ecommerce_integrations/unicommerce/doctype/unicommerce_settings/unicommerce_settings.py`
- [API client](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/api_client.py): `ecommerce_integrations/unicommerce/api_client.py`
- [Orders and returns](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/order.py): `ecommerce_integrations/unicommerce/order.py`
- [Cancellation and returns](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/cancellation_and_returns.py): `ecommerce_integrations/unicommerce/cancellation_and_returns.py`
- [Invoices and delivery](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/invoice.py): `ecommerce_integrations/unicommerce/invoice.py`
- [Shipment manifests](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/unicommerce/doctype/unicommerce_shipment_manifest/unicommerce_shipment_manifest.py): `ecommerce_integrations/unicommerce/doctype/unicommerce_shipment_manifest/unicommerce_shipment_manifest.py`

### Zenoti

- [Settings and scheduling](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py): `ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py`
- [Sales transactions](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/sales_transactions.py): `ecommerce_integrations/zenoti/sales_transactions.py`
- [Purchase transactions](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/purchase_transactions.py): `ecommerce_integrations/zenoti/purchase_transactions.py`
- [Stock reconciliation](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/stock_reconciliation.py): `ecommerce_integrations/zenoti/stock_reconciliation.py`
- [Zenoti API utilities](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/zenoti/utils.py): `ecommerce_integrations/zenoti/utils.py`

### Shared ERPNext

- [Amazon settings](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_sp_api_settings.py): `ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_sp_api_settings.py`
- [Amazon data access](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_repository.py): `ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_repository.py`
- [Item mapping](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_item/ecommerce_item.py): `ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_item/ecommerce_item.py`
- [Sync logs and retry](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_integration_log/ecommerce_integration_log.py): `ecommerce_integrations/ecommerce_integrations/doctype/ecommerce_integration_log/ecommerce_integration_log.py`
- [Tax handling](https://github.com/frappe/ecommerce_integrations/blob/develop/ecommerce_integrations/utils/taxation.py): `ecommerce_integrations/utils/taxation.py`

### Other components

- **ERPNext user**

## Connections

- ERPNext user → Settings and webhooks: configures
- ERPNext user → Settings and sync: configures
- ERPNext user → Settings and scheduling: configures
- ERPNext user → Amazon settings: configures
- Settings and webhooks → API connection: uses (evidence: `ecommerce_integrations/shopify/doctype/shopify_setting/shopify_setting.py`)
- Webhook routing → Orders and invoices: routes orders (evidence: `ecommerce_integrations/shopify/constants.py`)
- Webhook routing → Fulfillment: routes fulfillment (evidence: `ecommerce_integrations/shopify/constants.py`)
- Orders and invoices → API connection: calls (evidence: `ecommerce_integrations/shopify/order.py`)
- Orders and invoices → Products: uses item lookup (evidence: `ecommerce_integrations/shopify/order.py`)
- Fulfillment → Orders and invoices: loads sales order (evidence: `ecommerce_integrations/shopify/fulfillment.py`)
- Fulfillment → Tax handling: copies tax details (evidence: `ecommerce_integrations/shopify/fulfillment.py`)
- Products → Item mapping: maps items (evidence: `ecommerce_integrations/shopify/product.py`)
- Settings and sync → API client: uses client
- Orders and returns → API client: calls
- Invoices and delivery → API client: calls (evidence: `ecommerce_integrations/unicommerce/invoice.py`)
- Shipment manifests → API client: calls (evidence: `ecommerce_integrations/unicommerce/doctype/unicommerce_shipment_manifest/unicommerce_shipment_manifest.py`)
- Invoices and delivery → Orders and returns: uses order data (evidence: `ecommerce_integrations/unicommerce/invoice.py`)
- Invoices and delivery → Cancellation and returns: uses return data (evidence: `ecommerce_integrations/unicommerce/invoice.py`)
- API client → Sync logs and retry: records errors (evidence: `ecommerce_integrations/unicommerce/api_client.py`)
- Settings and scheduling → Sales transactions: schedules sync (evidence: `ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py`)
- Settings and scheduling → Purchase transactions: dispatches sync (evidence: `ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py`)
- Settings and scheduling → Stock reconciliation: dispatches sync (evidence: `ecommerce_integrations/zenoti/doctype/zenoti_settings/zenoti_settings.py`)
- Sales transactions → Zenoti API utilities: uses utilities (evidence: `ecommerce_integrations/zenoti/sales_transactions.py`)
- Purchase transactions → Zenoti API utilities: uses utilities (evidence: `ecommerce_integrations/zenoti/purchase_transactions.py`)
- Stock reconciliation → Zenoti API utilities: uses utilities (evidence: `ecommerce_integrations/zenoti/stock_reconciliation.py`)
- Amazon settings → Amazon data access: uses repository (evidence: `ecommerce_integrations/amazon/doctype/amazon_sp_api_settings/amazon_sp_api_settings.py`)
- Amazon data access → Item mapping: links items
- Invoices and delivery → Tax handling: uses tax handling (evidence: `ecommerce_integrations/unicommerce/invoice.py`)
