n8n-nodes-gigstack

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": "[email protected]",
  "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

• Gigstack Website
• Gigstack API Documentation
• n8n Community Nodes
• Report Issues

License

MIT - Built with love by Gigstack and Disruptive Learning