Description

This is an n8n community node. It lets you use Quipu in your n8n workflows.

Quipu is an invoice and taxes software as a service for freelancers and
companies that helps you manage accounting, invoicing, and tax filing in one
place.

n8n is a
fair-code licensed workflow automation
platform.

Installation Operations
Credentials Compatibility
Development Resources

Installation

Follow the
installation guide
in the n8n community nodes documentation.

npm install n8n-nodes-quipu

Operations

This node supports the following Quipu API operations:

Contacts

• Get all contacts
• Get a contact by ID
• Create a new contact
• Update a contact
• Delete a contact

Invoices

• Get all invoices
• Get an invoice by ID
• Create a new invoice
• Update an invoice
• Delete an invoice

Tickets

• Get all tickets
• Get a ticket by ID
• Create a new ticket
• Update a ticket
• Delete a ticket

Paysheets

• Get all paysheets
• Get a paysheet by ID
• Create a new paysheet
• Update a paysheet
• Delete a paysheet

Other Operations

• Get all book entries
• Get all accounting categories and subcategories
• Manage numbering series for invoices and tickets
• Upload and manage attachments

Credentials

You need to obtain OAuth2 credentials from Quipu to authenticate with the API.

Prerequisites

1. Sign up for a Quipu account at getquipu.com
2. Enable API
3. Generate the credentials

Setting up credentials in n8n

1. Open your n8n workflow
2. Click on the Quipu node
3. Click on Create new credential
4. Enter your Client ID and Client Secret
5. Click Save

The node automatically handles token generation and renewal using the OAuth2
client credentials flow.

Compatibility

This node has been tested with n8n version 1.0+ and Quipu API v1.

Development

Standard Development

If you want to contribute to this node, you can set up your development
environment as follows:

# Clone the repository
git clone https://github.com/aldoborrero/n8n-nodes-quipu.git
cd n8n-nodes-quipu

# Install dependencies
npm install

# Build the node
npm run build

# Run in development mode
npm run dev

Development with Nix

This project provides a Nix flake for a reproducible development environment.

Prerequisites

• Nix package manager installed on your
  system
• direnv (optional but recommended)

Setup with direnv

If you have direnv installed and configured, simply clone the repository and
enter the directory:

git clone https://github.com/aldoborrero/n8n-nodes-quipu.git
cd n8n-nodes-quipu
direnv allow

This will automatically set up your development environment based on the flake.

Manual Nix Shell

If you don't use direnv, you can manually enter the development environment:

nix develop

You can create a .envrc.local file for your personal environment
customizations. This file is gitignored and will be automatically loaded by
direnv.

Resources

• n8n community nodes documentation
• Quipu API documentation
• Quipu website

Support

If you have any questions or issues with this node, please:

1. Check the n8n community forum for existing
   solutions
2. Open an issue on the
   GitHub repository