npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

n8n-nodes-carbone

v1.2.0

Published

n8n node for Carbone.io services - template management and document generation. Easily integrate the generation of PDF, DOCX, XLS, XLSX, ODT, PPTX, ODS, CSV and XML reports and documents into your applications, using data from your existing JSON APIs. The

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

steevepaysteevepayguillaume-carboneguillaume-carbonedgrelauddgrelaud

Keywords

n8n-community-node-packagedocument-automationpdf-generationdocx-generationodt-generationreport-generationtemplate-enginedocument-templatesdynamic-documentsautomated-documentsnocode-document-automationlowcode-document-automationgenerate-pdf-from-templategenerate-docx-from-templategenerate-xlsx-from-templategenerate-pptx-from-templatefill-pdf-templatesfill-docx-templatesfill-odt-templatesautomate-document-creationbulk-document-generation

Readme

n8n-nodes-carbone

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

Carbone.io is a powerful document generation service that allows you to create professional PDF, DOCX, XLS, XLSX, ODT, PPTX, ODS, CSV and XML reports and documents from templates using JSON data. The easy-to-implement template concept frees you from design constraints, with a No/Low code approach.

Features

  • Generate documents from templates using JSON data.
  • Upload, manage, and delete templates.
  • Advanced options: localization, currency conversion, and template versioning.
  • Supports Carbone API v4 and v5.

Real-World Use Cases for Carbone.io Carbone.io is ideal for generating:

  • Invoices and Receipts: Automate billing with dynamic data.
  • Contracts: Populate legal templates with customer details.
  • Reports: Financial, sales, or operational reports with charts and tables.
  • Proposals: Customized business proposals for clients.
  • Certificates: Automated certificates for training or events.
  • Labels and Packing Slips: Shipping and logistics documents.
  • Personalized Letters: Mass mail with custom recipient data.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Document

Generate Document

Generate a document from a template and JSON data.

Parameters:

  • Use Base64 Template On The Fly: Whether to use a base64 template instead of a template ID
  • Template ID: The template ID to use for generating the document (when not using base64 template)
  • Template File (Base64): The template file encoded as base64 string (when using base64 template)
  • Data: JSON data-set to merge into the template
  • Convert To: Optional: Convert the document to another format (PDF, DOCX, HTML, ODT)
  • Download Rendered Document: Whether to download the rendered document directly or just get the render ID to fetch it later

Document Generation Additional Options:

  • Complement: Additional data to complement the main dataset
  • Currency Rates: Currency conversion rates
  • Currency Source: The source currency for conversion
  • Currency Target: The target currency for conversion
  • Enum: Enumeration values for the template
  • Hard Refresh: Whether to force a hard refresh of the template
  • Language: The language to use for localization (default: fr)
  • Report Name: The name of the generated report
  • Timezone: The timezone to use for date formatting (default: Europe/Paris)
  • Translations: Translation mappings for the template
  • Variable String: A string containing variables to be processed

Download Document

Retrieve a generated document from render ID.

Parameters:

  • Render ID: The render ID of the generated document to retrieve

Templates

List Templates

Retrieve a list of all templates from your Carbone.io account with optional filtering capabilities.

Parameters:

  • Template ID: Filter by specific template ID
  • Version ID: Filter by specific version ID
  • Category: Filter by template category
  • Include Versions: Include all versions for a specific template ID
  • Search: Search in template name (fuzzy search), version ID (exact) or template ID (exact)
  • Limit: Maximum number of results to return (default: 50)
  • Cursor: Cursor for pagination

Upload Template

Upload a new template file to Carbone.io or update an existing template.

Parameters:

  • Binary Property Name: The name of the binary property that contains the template file
  • Template Additional Options:
    • Deployed At: When a report is generated using the new template ID, Carbone selects the template version with the highest deployedAt timestamp that is not in the future
    • Enable Versioning: Whether to enable template versioning (default: true)
    • Template Comment: Comment for the template
    • Template ID: The unique identifier of the template to update
    • Template Name: Name for the template

Delete Template

Delete a template from your Carbone.io account.

Parameters:

  • Template ID: The unique identifier of the template to delete

Credentials

To use the Carbone.io node, you need to authenticate with your Carbone.io account.

Prerequisites

  1. Sign up for a Carbone.io account at carbone.io
  2. Obtain your API key from your Carbone.io dashboard

Authentication Setup

  1. API Key: Your Carbone.io API key for authentication
  2. API URL: The base URL for Carbone.io API (default: https://api.carbone.io)
    • Change this if you're using a self-hosted instance
  3. Carbone API Version: The version of the Carbone API to use (4 or 5, default: 5)

The node uses Bearer token authentication with the Authorization header and includes the carbone-version header for API versioning.

Compatibility

Tested with:

  • n8n: 1.111.1, 1.112.5
  • Carbone API: v4, v5
  • NodeJS: 22.10.0

Usage

Basic Template Upload

  1. Add a Carbone node to your workflow
  2. Select "Template" as resource and "Upload" as operation
  3. Connect a node that provides the template file as binary data (e.g., Read Binary File node)
  4. Configure the binary property name to match the output of the previous node
  5. Optionally set template name and other metadata

Basic Document Generation

  1. Add a Carbone node to your workflow
  2. Select "Render Document" as resource and "Generate" as operation
  3. Choose between using a template ID or base64 template
  4. Provide the JSON data to merge into the template
  5. Select the desired output format
  6. Choose whether to download the document directly or get a render ID

Advanced Usage

  • Template Versioning: Enable versioning to keep track of template changes
  • Localization: Set language, timezone, and translations for multilingual documents
  • Currency Conversion: Use currency rates and source/target currency for financial documents

Resources

Version history

1.2.0

  • Removed all requestWithAuthentication calls with httpRequestWithAuthentication.
  • Using now n8n-node-cli to lint/build/release

1.1.0

  • Removed redundant routing configurations from operation descriptions.
  • Replaced all helpers.request() calls with this.helpers.httpRequestWithAuthentication().
  • Translate French error messages to English.

1.0.0

  • Initial release.
  • Template management operations: List, Upload, Delete.
  • Document rendering operations: Generate, Get.
  • Advanced options for document generation (localization, currency, etc.).
  • Support for both template ID and base64 template approaches.