@disruptive-learning/n8n-nodes-gigstack 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +173 -0
  2. package/package.json +4 -3
package/README.md ADDED
@@ -0,0 +1,173 @@
1
+ # n8n-nodes-gigstack
2
+
3
+ ![npm](https://img.shields.io/npm/v/@disruptive-learning/n8n-nodes-gigstack)
4
+ ![license](https://img.shields.io/npm/l/@disruptive-learning/n8n-nodes-gigstack)
5
+ ![n8n](https://img.shields.io/badge/n8n-community--node-orange)
6
+
7
+ **n8n community node for [Gigstack](https://gigstack.io)** - Mexican tax compliance, invoicing (CFDI 4.0), and payment processing.
8
+
9
+ Automate your Mexican billing workflows with SAT-compliant invoices, receipts, payments, and more.
10
+
11
+ ---
12
+
13
+ ## Installation
14
+
15
+ ### In n8n (Recommended)
16
+
17
+ 1. Go to **Settings** > **Community Nodes**
18
+ 2. Enter `@disruptive-learning/n8n-nodes-gigstack`
19
+ 3. Click **Install**
20
+
21
+ ### Manual Installation
22
+
23
+ ```bash
24
+ cd ~/.n8n/custom
25
+ npm install @disruptive-learning/n8n-nodes-gigstack
26
+ ```
27
+
28
+ ### Docker
29
+
30
+ ```dockerfile
31
+ RUN cd /home/node/.n8n/custom && npm install @disruptive-learning/n8n-nodes-gigstack
32
+ ```
33
+
34
+ ---
35
+
36
+ ## Features
37
+
38
+ | Resource | Operations |
39
+ |----------|------------|
40
+ | **Clients** | Create, Get, Get All, Update, Delete, Validate (SAT), Customer Portal, Stamp Pending Receipts |
41
+ | **Invoices** | Create Income (CFDI I), Create Egress (CFDI E), Get, Get All, Cancel, Get Files (PDF/XML) |
42
+ | **Payments** | Request, Register, Get, Get All, Cancel, Mark as Paid, Refund |
43
+ | **Receipts** | Create, Get, Get All, Cancel, Stamp (convert to CFDI) |
44
+ | **Services** | Create, Get, Get All, Update, Delete |
45
+ | **Teams** | Create, Get, Get All, Update, Add/Remove Members, Series Management, Settings |
46
+ | **Users** | Create, Get, Get All, Update, Reset Password, Login Link |
47
+ | **Webhooks** | Create, Get, Get All, Update, Delete |
48
+
49
+ ### Trigger Node
50
+
51
+ Listen for real-time events:
52
+ - `invoice.created`, `invoice.cancelled`
53
+ - `payment.completed`, `payment.failed`
54
+ - `receipt.stamped`
55
+ - And more...
56
+
57
+ ---
58
+
59
+ ## Credentials
60
+
61
+ 1. Get your API key from [Gigstack Dashboard](https://app.gigstack.io/settings/api)
62
+ 2. In n8n, go to **Credentials** > **New Credential**
63
+ 3. Search for **Gigstack API**
64
+ 4. Enter your API key
65
+ 5. Select environment: **Production** or **Sandbox**
66
+
67
+ ---
68
+
69
+ ## Usage Examples
70
+
71
+ ### Create a Client
72
+
73
+ ```json
74
+ {
75
+ "email": "cliente@empresa.mx",
76
+ "name": "Juan Perez",
77
+ "legal_name": "Juan Perez Garcia",
78
+ "tax_id": "PEGJ850101ABC",
79
+ "tax_system": "612",
80
+ "zip": "06600"
81
+ }
82
+ ```
83
+
84
+ ### Create an Invoice (CFDI)
85
+
86
+ ```json
87
+ {
88
+ "clientId": "client_abc123",
89
+ "items": [
90
+ {
91
+ "description": "Servicio de consultoría",
92
+ "quantity": 1,
93
+ "unit_price": 5000,
94
+ "product_key": "80141503",
95
+ "unit_key": "E48"
96
+ }
97
+ ],
98
+ "payment_method": "PUE",
99
+ "payment_form": "03",
100
+ "use": "G03"
101
+ }
102
+ ```
103
+
104
+ ### Request Payment
105
+
106
+ ```json
107
+ {
108
+ "clientId": "client_abc123",
109
+ "amount": 5800,
110
+ "currency": "MXN",
111
+ "description": "Payment for consulting services"
112
+ }
113
+ ```
114
+
115
+ ---
116
+
117
+ ## SAT Compliance
118
+
119
+ This node supports **CFDI 4.0** Mexican tax requirements:
120
+
121
+ - **Tax Regimes** (Regimen Fiscal): 601, 603, 605, 606, 612, 616, 621, 625, 626
122
+ - **CFDI Uses** (Uso de CFDI): G01, G02, G03, P01, S01, and more
123
+ - **Payment Methods**: PUE (single payment), PPD (partial/deferred)
124
+ - **Payment Forms**: Cash, Transfer, Credit Card, etc. (01-99)
125
+ - **Cancellation Motives**: 01, 02, 03, 04
126
+
127
+ ---
128
+
129
+ ## Multi-Team Support (Gigstack Connect)
130
+
131
+ For Gigstack Connect users managing multiple teams:
132
+
133
+ 1. Add the **Team ID** field in any operation
134
+ 2. Leave empty to use your default team
135
+ 3. Specify a team ID to operate on behalf of that team
136
+
137
+ ---
138
+
139
+ ## Development
140
+
141
+ ```bash
142
+ # Clone the repository
143
+ git clone https://github.com/disruptive-learning/n8n_v2.git
144
+ cd n8n_v2
145
+
146
+ # Install dependencies
147
+ npm install
148
+
149
+ # Build
150
+ npm run build
151
+
152
+ # Sync with Gigstack API (check for updates)
153
+ npm run sync-swagger
154
+
155
+ # Link for local testing
156
+ npm link
157
+ cd ~/.n8n/custom && npm link @disruptive-learning/n8n-nodes-gigstack
158
+ ```
159
+
160
+ ---
161
+
162
+ ## Resources
163
+
164
+ - [Gigstack Website](https://gigstack.io)
165
+ - [Gigstack API Documentation](https://docs.gigstack.io)
166
+ - [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
167
+ - [Report Issues](https://github.com/disruptive-learning/n8n_v2/issues)
168
+
169
+ ---
170
+
171
+ ## License
172
+
173
+ [MIT](LICENSE) - Built with love by [Gigstack](https://gigstack.io) and [Disruptive Learning](https://github.com/disruptive-learning)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@disruptive-learning/n8n-nodes-gigstack",
3
- "version": "1.1.2",
3
+ "version": "1.1.3",
4
4
  "description": "n8n community node for Gigstack API - Mexican tax compliance, invoicing, and payment processing",
5
5
  "keywords": [
6
6
  "n8n-community-node-package",
@@ -21,7 +21,7 @@
21
21
  },
22
22
  "repository": {
23
23
  "type": "git",
24
- "url": "https://github.com/gigstack/n8n-nodes-gigstack.git"
24
+ "url": "https://github.com/disruptive-learning/n8n_v2.git"
25
25
  },
26
26
  "main": "index.js",
27
27
  "scripts": {
@@ -36,7 +36,8 @@
36
36
  "build-missing": "npx ts-node scripts/build-missing-operations.ts"
37
37
  },
38
38
  "files": [
39
- "dist"
39
+ "dist",
40
+ "README.md"
40
41
  ],
41
42
  "n8n": {
42
43
  "n8nNodesApiVersion": 1,