# rnsaway/n8n-nodes-moca architecture

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

- Interactive diagram: https://gitdiagram.com/rnsaway/n8n-nodes-moca
- Repository: https://github.com/rnsaway/n8n-nodes-moca

## Overview

This is an n8n community node for running MOCA commands—including local SQL—against a warehouse-management MOCA service. A workflow execution supplies credentials, an operation, and optionally published arguments; the node prepares the command, uses a session-aware transport to send MOCA XML, and maps the response into n8n items. The credential definition and operation UI are separate product capabilities. Source excerpts show the node, transport, and protocol flow; the credential implementation was not sampled, so its link to login is documented only at the README level.

Main entry points: [`nodes/Moca/Moca.node.ts`](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/Moca.node.ts) (MOCA execution), [`nodes/Moca/transport/index.ts`](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/index.ts) (Session transport), [`nodes/Moca/transport/protocol.ts`](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/protocol.ts) (Request and response), [`credentials/MocaApi.credentials.ts`](https://github.com/rnsaway/n8n-nodes-moca/blob/main/credentials/MocaApi.credentials.ts) (MOCA credentials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow Node"]
  node_moca_node["MOCA execution<br/>[Moca.node.ts]"]
  node_operation_ui["Operation options<br/>[MocaDescription.ts]"]
  node_item_mapping["Result mapping<br/>[Moca.node.ts]"]
end

subgraph group_connection["Connection"]
  node_credentials["MOCA credentials"]
  node_session_transport["Session transport<br/>[index.ts]"]
end

subgraph group_wire["MOCA Protocol"]
  node_request_response["Request and response<br/>[protocol.ts]"]
  node_xml_support["XML support<br/>[xml.ts]"]
end

node_workflow(("n8n workflow"))
node_moca_service{{"MOCA service"}}

node_workflow -->|"runs"| node_moca_node
node_moca_node -->|"reads options"| node_operation_ui
node_moca_node -->|"creates connection"| node_session_transport
node_moca_node -->|"prepares arguments"| node_request_response
node_session_transport -->|"builds and parses"| node_request_response
node_request_response -->|"uses XML helpers"| node_xml_support
node_session_transport -->|"posts XML"| node_moca_service
node_moca_service -->|"returns XML"| node_session_transport
node_session_transport -.->|"uses settings"| node_credentials
node_credentials -.->|"tests login"| node_moca_service
node_moca_node -->|"maps results"| node_item_mapping
node_item_mapping -->|"returns items"| node_workflow

click node_moca_node "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/Moca.node.ts"
click node_operation_ui "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/MocaDescription.ts"
click node_item_mapping "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/Moca.node.ts"
click node_credentials "https://github.com/rnsaway/n8n-nodes-moca/blob/main/credentials/MocaApi.credentials.ts"
click node_session_transport "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/index.ts"
click node_request_response "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/protocol.ts"
click node_xml_support "https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/xml.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_moca_node,node_operation_ui,node_item_mapping toneBlue
class node_credentials,node_session_transport toneAmber
class node_request_response,node_xml_support toneMint
class node_workflow,node_moca_service toneIndigo
```

## Components

### Workflow Node

- [MOCA execution](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/Moca.node.ts): `nodes/Moca/Moca.node.ts`
- [Operation options](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/MocaDescription.ts): `nodes/Moca/MocaDescription.ts`
- [Result mapping](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/Moca.node.ts): `nodes/Moca/Moca.node.ts`

### Connection

- [MOCA credentials](https://github.com/rnsaway/n8n-nodes-moca/blob/main/credentials/MocaApi.credentials.ts): `credentials/MocaApi.credentials.ts`
- [Session transport](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/index.ts): `nodes/Moca/transport/index.ts`

### MOCA Protocol

- [Request and response](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/protocol.ts): `nodes/Moca/transport/protocol.ts`
- [XML support](https://github.com/rnsaway/n8n-nodes-moca/blob/main/nodes/Moca/transport/xml.ts): `nodes/Moca/transport/xml.ts`

### Other components

- **n8n workflow**
- **MOCA service**

## Connections

- n8n workflow → MOCA execution: runs (evidence: `nodes/Moca/Moca.node.ts`)
- MOCA execution → Operation options: reads options (evidence: `nodes/Moca/Moca.node.ts`)
- MOCA execution → Session transport: creates connection (evidence: `nodes/Moca/Moca.node.ts`)
- MOCA execution → Request and response: prepares arguments (evidence: `nodes/Moca/Moca.node.ts`)
- Session transport → Request and response: builds and parses (evidence: `nodes/Moca/transport/index.ts`)
- Request and response → XML support: uses XML helpers (evidence: `nodes/Moca/transport/protocol.ts`)
- Session transport → MOCA service: posts XML (evidence: `nodes/Moca/transport/index.ts`)
- MOCA service → Session transport: returns XML (evidence: `nodes/Moca/transport/index.ts`)
- Session transport → MOCA credentials: uses settings (evidence: `README.md`)
- MOCA credentials → MOCA service: tests login (evidence: `README.md`)
- MOCA execution → Result mapping: maps results (evidence: `nodes/Moca/Moca.node.ts`)
- Result mapping → n8n workflow: returns items (evidence: `nodes/Moca/Moca.node.ts`)
