gigstack

n8n community node for Gigstack API - Mexican tax compliance, invoicing, and payment processing

Package Information

Downloads: 24 weekly / 171 monthly
Latest Version: 1.1.9
Author: Gigstack

Available Nodes

Gigstack icon
Gigstack
Interact with Gigstack API for Mexican tax-compliant invoicing and payments
Gigstack Trigger icon
Gigstack Trigger
Handle Gigstack webhook events

Documentation

n8n-nodes-gigstack

npm
license
n8n

n8n community node for Gigstack - Mexican tax compliance, invoicing (CFDI 4.0), and payment processing.

Automate your Mexican billing workflows with SAT-compliant invoices, receipts, payments, and more.

Installation

In n8n (Recommended)

  1. Go to Settings > Community Nodes
  2. Enter @disruptive-learning/n8n-nodes-gigstack
  3. Click Install

Manual Installation

cd ~/.n8n/custom
npm install @disruptive-learning/n8n-nodes-gigstack

Docker

RUN cd /home/node/.n8n/custom && npm install @disruptive-learning/n8n-nodes-gigstack

Features

Resource Operations
Clients Create, Get, Get All, Update, Delete, Validate (SAT), Customer Portal, Stamp Pending Receipts
Invoices Create Income (CFDI I), Create Egress (CFDI E), Get, Get All, Cancel, Get Files (PDF/XML)
Payments Request, Register, Get, Get All, Cancel, Mark as Paid, Refund
Receipts Create, Get, Get All, Cancel, Stamp (convert to CFDI)
Services Create, Get, Get All, Update, Delete
Teams Create, Get, Get All, Update, Add/Remove Members, Series Management, Settings
Users Create, Get, Get All, Update, Reset Password, Login Link
Webhooks Create, Get, Get All, Update, Delete

Trigger Node

Listen for real-time events:

  • invoice.created, invoice.cancelled
  • payment.completed, payment.failed
  • receipt.stamped
  • And more...

Credentials

  1. Get your API key from Gigstack Dashboard
  2. In n8n, go to Credentials > New Credential
  3. Search for Gigstack API
  4. Enter your API key
  5. Select environment: Production or Sandbox

Usage Examples

Create a Client

{
  "email": "cliente@empresa.mx",
  "name": "Juan Perez",
  "legal_name": "Juan Perez Garcia",
  "tax_id": "PEGJ850101ABC",
  "tax_system": "612",
  "zip": "06600"
}

Create an Invoice (CFDI)

{
  "clientId": "client_abc123",
  "items": [
    {
      "description": "Servicio de consultoría",
      "quantity": 1,
      "unit_price": 5000,
      "product_key": "80141503",
      "unit_key": "E48"
    }
  ],
  "payment_method": "PUE",
  "payment_form": "03",
  "use": "G03"
}

Request Payment

{
  "clientId": "client_abc123",
  "amount": 5800,
  "currency": "MXN",
  "description": "Payment for consulting services"
}

SAT Compliance

This node supports CFDI 4.0 Mexican tax requirements:

  • Tax Regimes (Regimen Fiscal): 601, 603, 605, 606, 612, 616, 621, 625, 626
  • CFDI Uses (Uso de CFDI): G01, G02, G03, P01, S01, and more
  • Payment Methods: PUE (single payment), PPD (partial/deferred)
  • Payment Forms: Cash, Transfer, Credit Card, etc. (01-99)
  • Cancellation Motives: 01, 02, 03, 04

Multi-Team Support (Gigstack Connect)

For Gigstack Connect users managing multiple teams:

  1. Add the Team ID field in any operation
  2. Leave empty to use your default team
  3. Specify a team ID to operate on behalf of that team

Development

# Clone the repository
git clone https://github.com/disruptive-learning/n8n_v2.git
cd n8n_v2

# Install dependencies
npm install

# Build
npm run build

# Sync with Gigstack API (check for updates)
npm run sync-swagger

# Link for local testing
npm link
cd ~/.n8n/custom && npm link @disruptive-learning/n8n-nodes-gigstack

Resources

License

MIT - Built with love by Gigstack and Disruptive Learning

Discussion