n8n-nodes-dk-ms 0.1.0

package/README.md

@@ -0,0 +1,111 @@
+# n8n-nodes-dk-ms
+
+`n8n-nodes-dk-ms` là custom community node cho n8n dùng để tích hợp AMIS MISA.
+
+Phiên bản đầu tiên hỗ trợ thao tác:
+
+- **AMIS MISA → Customer → Get Many**: lấy danh sách khách hàng từ AMIS MISA, dựa trên Apps Script đã chạy thành công trong `docs/LayDanhSachKhachHang.txt`.
+
+## Tính năng
+
+- Có credential riêng `AMIS MISA API` để lưu cookie an toàn trong n8n.
+- Không hardcode cookie/token vào source code.
+- Hỗ trợ phân trang tự động.
+- Output mỗi khách hàng là một item n8n.
+- Có thể build và publish lên npm như community node.
+
+## Cài đặt để phát triển local
+
+```cmd
+cd /d "D:\Github\2026.06.09 n8n MISA"
+npm install
+npm run build
+```
+
+> Tôi không tự chạy các lệnh trên trong session này vì bạn chưa yêu cầu test/build.
+
+## Publish lên npm
+
+Sau khi kiểm tra local thành công:
+
+```cmd
+cd /d "D:\Github\2026.06.09 n8n MISA"
+npm login
+npm publish
+```
+
+Nếu tên package `n8n-nodes-dk-ms` đã tồn tại trên npm, cần đổi trường `name` trong `package.json` trước khi publish.
+
+## Cài trong n8n
+
+Trong n8n v2.0:
+
+1. Mở `Settings`.
+2. Vào `Community Nodes`.
+3. Chọn cài package.
+4. Nhập package name:
+
+```text
+n8n-nodes-dk-ms
+```
+
+5. Khởi động lại n8n nếu hệ thống yêu cầu.
+
+## Cấu hình credential
+
+Tạo credential mới loại **AMIS MISA API**.
+
+Các trường cần nhập:
+
+| Field | Giá trị gợi ý |
+|---|---|
+| AMIS Cookie | Cookie đăng nhập lấy từ trình duyệt sau khi đăng nhập AMIS MISA |
+| Customer Endpoint | `https://amisapp.misa.vn/warehouse/g1/api/di/v1/Customer/v2/datapaging` |
+| Origin | `https://amisapp.misa.vn` |
+| User Agent | `Mozilla/5.0 AutoKhoHang` |
+
+Không ghi cookie thật vào `README.md`, workflow, hoặc source code.
+
+## Cách dùng node
+
+1. Tạo workflow mới trong n8n.
+2. Thêm node **AMIS MISA**.
+3. Chọn credential **AMIS MISA API**.
+4. Chọn:
+   - `Resource`: `Customer`
+   - `Operation`: `Get Many`
+5. Cấu hình:
+   - `Return All`: bật nếu muốn lấy toàn bộ khách hàng.
+   - `Limit`: số khách hàng tối đa nếu tắt `Return All`.
+   - `Page Size`: mặc định `100`.
+   - `Filter`: để trống nếu không lọc.
+   - `Sort JSON`: mặc định sắp xếp theo `CustomerCode` tăng dần.
+6. Execute node.
+
+## Output
+
+Mỗi item output có các field:
+
+```text
+CustomerCode
+CustomerName
+Address
+ShippingAddress
+CustomerTaxCode
+Mobile
+ContactMobilePhone
+Inactive
+CustomerID
+IsCorp
+```
+
+## Ghi chú bảo mật
+
+- Cookie AMIS MISA là secret, không commit vào git.
+- Các file `.env`, `.credentials.json`, `config.json` đã được đưa vào `.gitignore`.
+- Nếu cookie hết hạn, cập nhật lại credential trong n8n.
+
+## Nguồn tham khảo
+
+- `docs/Endpoint.txt`
+- `docs/LayDanhSachKhachHang.txt`

package/dist/credentials/AmisMisaApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class AmisMisaApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/AmisMisaApi.credentials.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmisMisaApi = void 0;
+const DEFAULT_CUSTOMER_ENDPOINT = 'https://amisapp.misa.vn/warehouse/g1/api/di/v1/Customer/v2/datapaging';
+const DEFAULT_ORIGIN = 'https://amisapp.misa.vn';
+const DEFAULT_USER_AGENT = 'Mozilla/5.0 AutoKhoHang';
+class AmisMisaApi {
+    name = 'amisMisaApi';
+    displayName = 'AMIS MISA API';
+    documentationUrl = 'https://github.com/dk-ms/n8n-nodes-dk-ms';
+    properties = [
+        {
+            displayName: 'AMIS Cookie',
+            name: 'cookie',
+            type: 'string',
+            typeOptions: {
+                password: true,
+            },
+            default: '',
+            required: true,
+            description: 'Cookie đăng nhập AMIS MISA. Không chia sẻ hoặc commit giá trị này.',
+        },
+        {
+            displayName: 'Customer Endpoint',
+            name: 'customerEndpoint',
+            type: 'string',
+            default: DEFAULT_CUSTOMER_ENDPOINT,
+            required: true,
+            description: 'Endpoint lấy danh sách khách hàng AMIS MISA.',
+        },
+        {
+            displayName: 'Origin',
+            name: 'origin',
+            type: 'string',
+            default: DEFAULT_ORIGIN,
+            required: true,
+            description: 'Header Origin khi gọi AMIS MISA.',
+        },
+        {
+            displayName: 'User Agent',
+            name: 'userAgent',
+            type: 'string',
+            default: DEFAULT_USER_AGENT,
+            required: true,
+            description: 'Header User-Agent khi gọi AMIS MISA.',
+        },
+    ];
+}
+exports.AmisMisaApi = AmisMisaApi;

package/dist/nodes/AmisMisa/AmisMisa.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class AmisMisa implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/AmisMisa/AmisMisa.node.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmisMisa = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const DEFAULT_PAGE_SIZE = 100;
+const DEFAULT_LIMIT = 100;
+const DEFAULT_COLUMNS = [
+    'CustomerCode',
+    'CustomerName',
+    'Address',
+    'ShippingAddress',
+    'CustomerTaxCode',
+    'Mobile',
+    'ContactMobilePhone',
+    'Inactive',
+    'CustomerID',
+    'IsCorp',
+];
+const DEFAULT_SORT = '[{"Selector":"CustomerCode","Desc":false}]';
+const REQUEST_TIMEOUT_MS = 30_000;
+class AmisMisa {
+    description = {
+        displayName: 'AMIS MISA',
+        name: 'amisMisa',
+        icon: 'file:amisMisa.svg',
+        group: ['transform'],
+        version: 1,
+        subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+        description: 'Tích hợp AMIS MISA cho n8n',
+        defaults: {
+            name: 'AMIS MISA',
+        },
+        inputs: ['main'],
+        outputs: ['main'],
+        credentials: [
+            {
+                name: 'amisMisaApi',
+                required: true,
+            },
+        ],
+        properties: [
+            {
+                displayName: 'Resource',
+                name: 'resource',
+                type: 'options',
+                noDataExpression: true,
+                options: [
+                    {
+                        name: 'Customer',
+                        value: 'customer',
+                    },
+                ],
+                default: 'customer',
+            },
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                    },
+                },
+                options: [
+                    {
+                        name: 'Get Many',
+                        value: 'getMany',
+                        description: 'Lấy danh sách khách hàng',
+                        action: 'Lấy danh sách khách hàng',
+                    },
+                ],
+                default: 'getMany',
+            },
+            {
+                displayName: 'Return All',
+                name: 'returnAll',
+                type: 'boolean',
+                default: true,
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                        operation: ['getMany'],
+                    },
+                },
+                description: 'Có lấy toàn bộ dữ liệu qua phân trang hay không',
+            },
+            {
+                displayName: 'Limit',
+                name: 'limit',
+                type: 'number',
+                default: DEFAULT_LIMIT,
+                typeOptions: {
+                    minValue: 1,
+                },
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                        operation: ['getMany'],
+                        returnAll: [false],
+                    },
+                },
+                description: 'Số khách hàng tối đa cần lấy khi không bật Return All',
+            },
+            {
+                displayName: 'Page Size',
+                name: 'pageSize',
+                type: 'number',
+                default: DEFAULT_PAGE_SIZE,
+                typeOptions: {
+                    minValue: 1,
+                    maxValue: 500,
+                },
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                        operation: ['getMany'],
+                    },
+                },
+                description: 'Số bản ghi lấy trong mỗi request phân trang',
+            },
+            {
+                displayName: 'Filter',
+                name: 'filter',
+                type: 'string',
+                default: '',
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                        operation: ['getMany'],
+                    },
+                },
+                description: 'Chuỗi Filter gửi tới AMIS MISA. Để trống để lấy tất cả.',
+            },
+            {
+                displayName: 'Sort JSON',
+                name: 'sort',
+                type: 'string',
+                default: DEFAULT_SORT,
+                displayOptions: {
+                    show: {
+                        resource: ['customer'],
+                        operation: ['getMany'],
+                    },
+                },
+                description: 'Chuỗi JSON Sort gửi tới AMIS MISA.',
+            },
+        ],
+    };
+    async execute() {
+        const resource = this.getNodeParameter('resource', 0);
+        const operation = this.getNodeParameter('operation', 0);
+        if (resource === 'customer' && operation === 'getMany') {
+            return [await get_many_customers.call(this)];
+        }
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Operation chưa được hỗ trợ: ${resource}.${operation}`);
+    }
+}
+exports.AmisMisa = AmisMisa;
+async function get_many_customers() {
+    const credentials = (await this.getCredentials('amisMisaApi'));
+    const return_all = this.getNodeParameter('returnAll', 0);
+    const limit = return_all ? Number.POSITIVE_INFINITY : this.getNodeParameter('limit', 0);
+    const page_size = this.getNodeParameter('pageSize', 0);
+    const filter = this.getNodeParameter('filter', 0);
+    const sort = this.getNodeParameter('sort', 0);
+    const customers = [];
+    let page_index = 1;
+    validate_credentials(credentials, this);
+    while (customers.length < limit) {
+        const response = await request_customer_page.call(this, credentials, page_index, page_size, filter, sort);
+        const page_data = response.Data ?? [];
+        for (const customer of page_data) {
+            customers.push(normalize_customer(customer));
+            if (customers.length >= limit) {
+                break;
+            }
+        }
+        if (page_data.length < page_size) {
+            break;
+        }
+        page_index += 1;
+    }
+    return customers.map((customer) => ({ json: customer }));
+}
+async function request_customer_page(credentials, page_index, page_size, filter, sort) {
+    // Payload giữ cấu trúc giống Apps Script đã chạy thành công.
+    const payload = {
+        PageIndex: page_index,
+        PageSize: page_size,
+        Columns: DEFAULT_COLUMNS.join(','),
+        Filter: filter,
+        Sort: sort,
+        CustomFilter: '',
+        UseSp: false,
+        ColumnsSummary: '',
+        QuickSearch: {},
+        CustomParam: {},
+    };
+    const options = {
+        method: 'POST',
+        url: credentials.customerEndpoint,
+        headers: {
+            Accept: 'application/json, text/plain, */*',
+            Cookie: credentials.cookie,
+            Origin: credentials.origin,
+            'User-Agent': credentials.userAgent,
+        },
+        body: payload,
+        json: true,
+        timeout: REQUEST_TIMEOUT_MS,
+    };
+    try {
+        const response = (await this.helpers.httpRequest(options));
+        if (!response.Success) {
+            const message = response.UserMessage ?? response.ErrorMessage ?? 'AMIS MISA API trả về Success=false';
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), message, {
+                description: `PageIndex=${page_index}, PageSize=${page_size}`,
+            });
+        }
+        return response;
+    }
+    catch (error) {
+        if (error instanceof n8n_workflow_1.NodeOperationError) {
+            throw error;
+        }
+        throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Không gọi được AMIS MISA Customer API', {
+            description: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function validate_credentials(credentials, context) {
+    if (!credentials.cookie) {
+        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'Thiếu AMIS Cookie trong credential');
+    }
+    if (!credentials.customerEndpoint) {
+        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'Thiếu Customer Endpoint trong credential');
+    }
+}
+function normalize_customer(customer) {
+    return DEFAULT_COLUMNS.reduce((result, column) => {
+        result[column] = customer[column] ?? '';
+        return result;
+    }, {});
+}

package/dist/nodes/AmisMisa/amisMisa.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="AMIS MISA">
+  <rect width="64" height="64" rx="14" fill="#1f6feb"/>
+  <path d="M14 44L24 18h8l10 26h-7l-2-6H23l-2 6h-7zm12-12h7l-3.5-10L26 32z" fill="#fff"/>
+  <path d="M43 18h7v26h-7V18z" fill="#b6e3ff"/>
+</svg>

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "n8n-nodes-dk-ms",
+  "version": "0.1.0",
+  "description": "Community node cho n8n để tích hợp AMIS MISA.",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "amis",
+    "misa",
+    "warehouse"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/dk-ms/n8n-nodes-dk-ms",
+  "author": {
+    "name": "DK MS"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dk-ms/n8n-nodes-dk-ms.git"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier --write \"credentials/**/*.ts\" \"nodes/**/*.ts\"",
+    "lint": "eslint credentials nodes --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/AmisMisaApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/AmisMisa/AmisMisa.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "20.11.30",
+    "eslint": "8.57.0",
+    "gulp": "4.0.2",
+    "n8n-workflow": "2.0.0",
+    "prettier": "3.2.5",
+    "typescript": "5.4.5"
+  },
+  "peerDependencies": {
+    "n8n-workflow": ">=2.0.0"
+  }
+}