n8n-nodes-art-erp

ART ERP community node for n8n — community node gọi REST API của hệ thống ART ERP từ workflow n8n.

Các endpoint được ánh xạ từ postman_collection.json (collection ERP APIs).

Cài đặt

n8n (self-hosted)

Trong thư mục custom nodes của n8n:

npm install n8n-nodes-art-erp

Khởi động lại n8n sau khi cài.

Phát triển local

pnpm install
pnpm run build

Cấu trúc trong n8n

Credentials — ART ERP account

Credential ánh xạ các request Token trong Postman collection. Tất cả đều gọi {{baseUrl}}/Token và trả về access_token dùng làm Bearer token cho các API khác.

Khi test credential hoặc chạy node, package gọi /Token theo mode đã chọn, cache token theo domain + phương thức xác thực, và gửi Authorization: Bearer {access_token} cho các request API.

Mọi request (kể cả /Token) đều tự động thêm query param AppVersion theo format {package-name}-v{version} (ví dụ: AppVersion=n8n-nodes-art-erp-v1.0.2), tương đương script Postman pm.request.url.addQueryParams(["AppVersion=postman"]).

Nodes — theo phân hệ API

Mỗi phân hệ trong URL API tương ứng với một node trong n8n:

Cấu trúc URL:

{baseUrl}/api/v1/{PhânHệ}/{Nhóm}/{Action}

Ví dụ ánh xạ:

Cấu trúc mã nguồn

art-erp/
├── credentials/
│   └── ArtErpApi.credentials.ts    # ART ERP account
├── nodes/
│   ├── common/
│   │   ├── AppVersion.ts           # AppVersion query param helper
│   │   ├── GenericFunctions.ts     # HTTP helper (Bearer token)
│   │   ├── TokenHelpers.ts         # /Token auth (Basic, OAuth 2)
│   │   ├── NodeHelpers.ts          # Field helpers dùng chung
│   │   └── arterp.svg
│   ├── SYS/
│   │   ├── SYS.node.ts             # Node SYS
│   │   └── SYS.node.json
│   ├── BANK/
│   │   ├── BANK.node.ts            # Node BANK
│   │   └── BANK.node.json
│   ├── BRA/
│   │   ├── BRA.node.ts             # Node BRA
│   │   └── BRA.node.json
│   └── SALE/
│       ├── SALE.node.ts            # Node SALE
│       └── SALE.node.json
├── postman_collection.json
└── package.json

Phân hệ và endpoint

SYS

BANK

BRA

SALE

License

MIT