n8n-nodes-qonto-api 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# n8n-nodes-qonto
+
+This is an n8n community node. It lets you use Qonto banking API in your n8n workflows.
+
+Qonto is a business banking platform that provides banking services for SMEs and freelancers. This node allows you to automate operations with your Qonto account, including managing transactions, transfers, beneficiaries, and more.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+[Installation](#installation)  
+[Operations](#operations)  
+[Credentials](#credentials)  
+[Compatibility](#compatibility)  
+[Resources](#resources)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+## Operations
+
+This node supports the following Qonto resources:
+
+- **Organizations**: Get organization and bank accounts information
+- **Transactions**: List and retrieve transactions
+- **External Transfers**: Create and list external transfers
+- **Beneficiaries**: Manage beneficiaries (list, show, create, trust/untrust)
+- **Labels**: Manage transaction labels
+- **Memberships**: Manage organization memberships
+- **Attachments**: Upload and retrieve attachments
+- **Attachments in a Transaction**: Manage attachments linked to transactions
+- **Cards**: Manage cards (list, retrieve, create)
+- **Requests**: Manage payment requests
+- **Statements**: Retrieve account statements
+- **Internal Transactions**: List internal transactions
+- **Supplier Invoices**: Manage supplier invoices
+- **Client Invoices**: Manage client invoices
+- **Credit Notes**: Manage credit notes
+- **Clients**: Manage clients
+- **Teams**: Manage teams
+- **Insurance Contracts**: Manage insurance contracts
+
+## Credentials
+
+This node supports two authentication methods:
+
+### Login and Secret Key (API Key)
+
+1. Log in to your Qonto account
+2. Go to Settings > API & Integrations
+3. Generate an API key
+4. Use the login (e.g., `scep-1111`) and secret key for authentication
+5. Select your environment (Production or Sandbox)
+6. For sandbox access, you may need to provide an X-Qonto-Staging-Token
+
+### OAuth2
+
+1. Create an OAuth2 application in your Qonto account
+2. Configure the OAuth2 credentials in n8n with:
+   - Client ID
+   - Client Secret
+   - Environment (Production or Sandbox)
+   - Scopes required for your operations
+3. For sandbox access with Machine-to-Machine, provide X-Qonto-Staging-Token
+
+Refer to the [Qonto API documentation](https://api-doc.qonto.com/docs/business-api) for more information.
+
+## Compatibility
+
+Compatible with n8n@1.60.0 or later
+
+## Resources
+
+* [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+* [Qonto API documentation](https://api-doc.qonto.com/docs/business-api)
+* [Qonto website](https://qonto.com)

package/dist/credentials/QontoApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class QontoApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: Icon;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/QontoApi.credentials.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QontoApi = void 0;
+class QontoApi {
+    constructor() {
+        this.name = 'qontoApi';
+        this.displayName = 'Qonto API';
+        this.documentationUrl = 'https://api-doc.qonto.com/docs/business-api';
+        this.icon = 'file:../icons/qonto.svg';
+        this.properties = [
+            {
+                displayName: 'Environment Type',
+                name: 'environment',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Production',
+                        value: 'production',
+                    },
+                    {
+                        name: 'Sandbox',
+                        value: 'sandbox',
+                    },
+                ],
+                default: 'production',
+            },
+            {
+                displayName: 'Login',
+                name: 'login',
+                type: 'string',
+                default: '',
+                placeholder: 'scep-1111',
+            },
+            {
+                displayName: 'Secret Key',
+                name: 'secretKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                placeholder: 'f8952b8244c0ce693c8f793a07e807f8',
+            },
+            {
+                displayName: 'X-Qonto-Staging-Token',
+                name: 'stagingToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                displayOptions: {
+                    show: {
+                        environment: ['sandbox'],
+                    },
+                },
+                default: '',
+                description: 'Required for Machine-to-Machine access in sandbox environment',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '={{$credentials.login}}:{{$credentials.secretKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.environment === "sandbox" ? "https://thirdparty-sandbox.staging.qonto.co/v2" : "https://thirdparty.qonto.com/v2"}}',
+                url: '/organization',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.QontoApi = QontoApi;
+//# sourceMappingURL=QontoApi.credentials.js.map

package/dist/credentials/QontoApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QontoApi.credentials.js","sourceRoot":"","sources":["../../credentials/QontoApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAClB,gBAAW,GAAG,WAAW,CAAC;QAC1B,qBAAgB,GAAG,6CAA6C,CAAC;QACjE,SAAI,GAAS,yBAAyB,CAAC;QAEvC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,YAAY;wBAClB,KAAK,EAAE,YAAY;qBACnB;oBACD;wBACC,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,SAAS;qBAChB;iBACD;gBACD,OAAO,EAAE,YAAY;aACrB;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,WAAW;aACxB;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,kCAAkC;aAC/C;YACD;gBACC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,cAAc,EAAE;oBACf,IAAI,EAAE;wBACL,WAAW,EAAE,CAAC,SAAS,CAAC;qBACxB;iBACD;gBACD,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,+DAA+D;aAC5E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,oDAAoD;iBACnE;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,oIAAoI;gBAC7I,GAAG,EAAE,eAAe;gBACpB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AAzED,4BAyEC"}

package/dist/credentials/QontoOAuth2Api.credentials.d.ts

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

package/dist/credentials/QontoOAuth2Api.credentials.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QontoOAuth2Api = void 0;
+class QontoOAuth2Api {
+    constructor() {
+        this.name = 'qontoOAuth2Api';
+        this.extends = ['oAuth2Api'];
+        this.displayName = 'Qonto OAuth2 API';
+        this.documentationUrl = 'https://api-doc.qonto.com/docs/business-api';
+        this.icon = 'file:../icons/qonto.svg';
+        this.properties = [
+            {
+                displayName: 'Environment Type',
+                name: 'environment',
+                type: 'options',
+                options: [
+                    {
+                        name: 'Production',
+                        value: 'production',
+                    },
+                    {
+                        name: 'Sandbox',
+                        value: 'sandbox',
+                    },
+                ],
+                default: 'production',
+            },
+            {
+                displayName: 'Authorization URL',
+                name: 'authUrl',
+                type: 'hidden',
+                required: true,
+                default: '={{ $self["environment"] === "sandbox" ? "https://sandbox.staging.qonto.co/oauth2/auth" : "https://oauth.qonto.com/oauth2/auth" }}',
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'hidden',
+                required: true,
+                default: '={{ $self["environment"] === "sandbox" ? "https://sandbox.staging.qonto.co/oauth2/token" : "https://oauth.qonto.com/oauth2/token" }}',
+            },
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'authorizationCode',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'body',
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'string',
+                required: true,
+                default: '',
+                description: 'All scope details here: https://api-doc.qonto.com/docs/business-api/6434cbb9d968d-qonto',
+            },
+            {
+                displayName: 'X-Qonto-Staging-Token',
+                name: 'stagingToken',
+                type: 'string',
+                typeOptions: { password: true },
+                displayOptions: {
+                    show: {
+                        environment: ['sandbox'],
+                    },
+                },
+                default: '',
+                description: 'Required for Machine-to-Machine access in sandbox environment',
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                required: false,
+                default: '',
+                description: '',
+            },
+        ];
+    }
+}
+exports.QontoOAuth2Api = QontoOAuth2Api;
+//# sourceMappingURL=QontoOAuth2Api.credentials.js.map

package/dist/credentials/QontoOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QontoOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/QontoOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IAA3B;QACC,SAAI,GAAG,gBAAgB,CAAC;QACxB,YAAO,GAAG,CAAC,WAAW,CAAC,CAAC;QACxB,gBAAW,GAAG,kBAAkB,CAAC;QACjC,qBAAgB,GAAG,6CAA6C,CAAC;QACjE,SAAI,GAAS,yBAAyB,CAAC;QAEvC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,YAAY;wBAClB,KAAK,EAAE,YAAY;qBACnB;oBACD;wBACC,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,SAAS;qBAChB;iBACD;gBACD,OAAO,EAAE,YAAY;aACrB;YACD;gBACC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EACN,oIAAoI;aACrI;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EACN,sIAAsI;aACvI;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,mBAAmB;aAC5B;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM;aACf;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,yFAAyF;aACtG;YACD;gBACC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,cAAc,EAAE;oBACf,IAAI,EAAE;wBACL,WAAW,EAAE,CAAC,SAAS,CAAC;qBACxB;iBACD;gBACD,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,+DAA+D;aAC5E;YACD;gBACC,WAAW,EAAE,2BAA2B;gBACxC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,EAAE;aACf;SACD,CAAC;IACH,CAAC;CAAA;AAlFD,wCAkFC"}

package/dist/icons/qonto.svg

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Generator: Adobe Illustrator 19.2.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+
+<svg
+   version="1.1"
+   id="layer"
+   x="0px"
+   y="0px"
+   viewBox="0 0 60 60"
+   xml:space="preserve"
+   sodipodi:docname="Qonto.svg"
+   width="60"
+   height="60"
+   inkscape:version="1.2 (dc2aedaf03, 2022-05-15)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"><defs
+   id="defs11" /><sodipodi:namedview
+   id="namedview9"
+   pagecolor="#ffffff"
+   bordercolor="#666666"
+   borderopacity="1.0"
+   inkscape:pageshadow="2"
+   inkscape:pageopacity="0.0"
+   inkscape:pagecheckerboard="0"
+   showgrid="false"
+   width="60px"
+   inkscape:zoom="15.14857"
+   inkscape:cx="27.065261"
+   inkscape:cy="30.464922"
+   inkscape:window-width="2560"
+   inkscape:window-height="1412"
+   inkscape:window-x="2560"
+   inkscape:window-y="1080"
+   inkscape:window-maximized="1"
+   inkscape:current-layer="layer"
+   inkscape:showpageshadow="2"
+   inkscape:deskcolor="#d1d1d1" />
+<style
+   type="text/css"
+   id="style2">
+	.st0{fill:#262A3E;}
+	.st1{fill:#6B5AED;}
+</style>
+
+<path
+   class="st1"
+   d="M 12.31047,21.319131 C 16.687726,25.71623 22.509026,28.20943 28.555957,28.662739 28.149818,22.588397 25.622746,16.740708 21.245488,12.343609 16.868231,7.94651 11.227437,5.4533092 5,5 c 0.4061383,6.074343 2.933215,11.922032 7.31047,16.319131 z m 35.379061,0 C 43.312272,25.71623 37.490974,28.20943 31.444043,28.662739 31.850182,22.588397 34.377254,16.740708 38.754513,12.343609 42.906137,7.94651 48.772563,5.4533092 55,5 54.548738,11.074343 52.066786,16.922032 47.689531,21.319131 Z m 0,17.361741 C 43.312272,34.283773 37.490974,31.790573 31.444043,31.337263 31.850182,37.411607 34.377254,43.259295 38.754512,47.656392 43.131767,52.05349 48.953069,54.546691 55,55 54.548738,48.744333 52.066786,42.851317 47.689531,38.680872 Z m -35.379061,0 C 16.687726,34.283773 22.509026,31.790573 28.781589,31.337263 28.375451,37.411607 25.848374,43.259295 21.47112,47.656392 16.868231,52.05349 11.227437,54.592022 5,55 5.4061383,48.744333 7.933215,42.851317 12.31047,38.680872 Z"
+   id="path6"
+   style="stroke-width:0.452285;fill:#1d1d1b;fill-opacity:1" />
+</svg>

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

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