n8n-nodes-tiendanube

This is an n8n community node that lets you use Tiendanube/Nuvemshop in your n8n workflows.

Tiendanube (also known as Nuvemshop in Brazil) is a leading e-commerce platform in Latin America that allows you to create and manage online stores.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node Installation

1. Go to Settings > Community Nodes in n8n
2. Select Install
3. Enter n8n-nodes-tiendanube in Enter npm package name
4. Agree to the risks and click Install

Manual Installation

To install manually, navigate to your n8n installation and run:

npm install n8n-nodes-tiendanube

For docker installations, add the following line before the n8n starts:

docker exec -it -u node <container-name> npm install n8n-nodes-tiendanube

Configuration

Getting Tiendanube Credentials

1. Log in to your Tiendanube admin panel
2. Go to Apps section
3. Create a new app or use an existing one
4. Get your Store ID (numeric ID visible in your store URL)
5. Get your Access Token from the app credentials

Setting up Credentials in n8n

1. In n8n, go to Credentials → New
2. Search for Tiendanube API
3. Enter your Store ID
4. Enter your Access Token
5. Click Save

Operations

Products

Get

Retrieve a single product by ID.

Parameters:

• Product ID (required): The ID of the product to retrieve

Get Many

Retrieve multiple products with filtering and pagination.

Parameters:

• Return All: Whether to return all results or limit them
• Limit: Maximum number of results to return (1-200)
• Additional Fields:
  • Published: Filter by published status
  • Free Shipping: Filter by free shipping
  • Category ID: Filter by category
  • Search Query: Search by name or description
  • Sort By: Sort results by created-at, updated-at, name, or price (ascending/descending)

Create

Create a new product.

Parameters:

• Name (required): Product name
• Additional Fields:
  • Description: Product description
  • Price: Product price
  • Promotional Price: Sale price
  • Cost Price: Cost of the product
  • SKU: Stock keeping unit
  • Stock: Available quantity
  • Published: Whether the product is visible
  • Free Shipping: Whether shipping is free
  • Weight, Width, Height, Depth: Physical dimensions
  • Brand: Product brand
  • Categories (JSON): Array of category objects
  • Images (JSON): Array of image objects
  • Variants (JSON): Array of variant objects

Example Categories JSON:

[
  {"id": 123},
  {"id": 456}
]

Example Images JSON:

[
  {"src": "https://example.com/image1.jpg"},
  {"src": "https://example.com/image2.jpg"}
]

Update

Update an existing product.

Parameters:

• Product ID (required): The ID of the product to update
• Update Fields: Any fields you want to modify (same as Create operation)

Delete

Delete a product by ID.

Parameters:

• Product ID (required): The ID of the product to delete

Multilingual Support

Tiendanube supports multiple languages. You can provide text fields in two ways:

1. Simple text (defaults to Spanish):

Mi Producto

2. JSON format (multiple languages):

{
  "es": "Mi Producto",
  "en": "My Product",
  "pt": "Meu Produto"
}

This applies to fields like name and description.

Compatibility

• Minimum n8n version: 1.0.0
• Tested against: Tiendanube API v1

Resources

• n8n community nodes documentation
• Tiendanube API documentation

Development

Building the Package

# Install dependencies
npm install

# Build the package
npm run build

# Link for local testing
npm link

In your n8n installation directory:

npm link n8n-nodes-tiendanube

Project Structure

n8n-nodes-tiendanube/
├── credentials/
│   └── TiendanubeApi.credentials.ts
├── nodes/
│   └── Tiendanube/
│       ├── Tiendanube.node.ts
│       └── tiendanube.svg
├── package.json
├── tsconfig.json
└── gulpfile.js

License

MIT

Author

Sergio Keberlein

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.