1001fx - NoCode functionsInstall

Overview

The Render Carbone Template operation in the "carbone" resource allows you to generate documents by merging a template file (such as DOCX, ODT, PDF, etc.) with dynamic data. This is particularly useful for automating the creation of reports, invoices, certificates, or any document that requires templated content filled with variable data.

Common scenarios:

• Generating personalized invoices for each customer from a template.
• Creating custom reports based on user input or database records.
• Automating the production of certificates, contracts, or letters with unique information per recipient.

Practical example:
You have a DOCX invoice template and a list of customers with their purchase details. Using this node, you can automatically produce a ready-to-send invoice for each customer in PDF format.

Properties

Output

• The node outputs an item with a binary field.
• The rendered document (e.g., PDF, DOCX, etc.) is available under the property name specified in Binary Property (default: data).
• The binary field contains:
  • The file data (buffer)
  • Metadata such as filename and MIME type
• The json field is preserved from the input item.

Example output structure:

{
  "json": { /* original input json */ },
  "binary": {
    "data": {
      "data": "<base64-encoded file>",
      "fileName": "output.pdf",
      "mimeType": "application/pdf"
    }
  }
}

Dependencies

• External Service: Requires access to the 1001fx API.
• API Key: You must configure the 1001fxApi credential in n8n.
• Environment: No special environment variables are required beyond standard n8n configuration.

Troubleshooting

Common issues:

• Missing or invalid template file: Ensure the template file is correctly uploaded and referenced.
• Malformed data: The data property must be valid JSON or a properly stringified object matching the template's placeholders.
• Incorrect binary property name: If you change the default, ensure you reference the correct property in downstream nodes.
• Authentication errors: Make sure your 1001fx API credentials are set up and valid.

Error messages:

• "error": "Invalid template file" – Check that the file is a supported template format.
• "error": "Data does not match template" – Ensure your data keys correspond to the placeholders in your template.
• "error": "Authentication failed" – Verify your API key in the n8n credentials.

Links and References

• Carbone Templating Documentation
• 1001fx API Documentation
• n8n Docs: Working with Binary Data