1001fx - NoCode functionsInstall

Overview

The Render Carbone Cloud Template operation in the "carbone" resource allows you to generate documents by rendering a template stored on carbone.io with your provided data. This is useful for automating the creation of reports, invoices, certificates, or any document where a predefined layout needs to be filled with dynamic content.

Common scenarios:

• Generating PDF invoices from order data.
• Creating personalized certificates for event attendees.
• Producing custom reports in various formats (PDF, DOCX, CSV, etc.) based on user input or database records.

Practical example:
You have a template for an invoice stored on carbone.io. By providing the template ID and customer/order data, this node will return a filled-in invoice as a PDF or other supported format.

Properties

Output

• Binary Data:
  The node outputs the rendered document as binary data under the property name specified in "Binary Property" (default: data).
  • The binary field contains the generated file (e.g., PDF, DOCX).
  • The original JSON data is preserved in the output's json field.
  • If there was already binary data present, it is retained alongside the new output.

Example output structure:

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

• If an error occurs and "Continue On Fail" is enabled, the json field will contain an error property with details.

Dependencies

• External Service: Requires access to carbone.io and a valid API key.
• n8n Credentials: You must configure the "1001fxApi" credential in n8n with your API key.
• Environment: No additional environment variables are required beyond standard n8n setup.

Troubleshooting

Common issues:

• Invalid API Key:
  Error message: "error": "Unauthorized"
  Solution: Ensure your API Key is correct and has sufficient permissions.

• Template Not Found:
  Error message: "error": "Template not found"
  Solution: Double-check the Template ID; ensure the template exists in your carbone.io account.

• Malformed Data:
  Error message: "error": "Invalid data format"
  Solution: Make sure the "Data" property is valid JSON and matches the placeholders in your template.

• Output Format Issues:
  Error message: "error": "Unsupported output format"
  Solution: Use one of the supported formats: csv, docx, ods, odt, pdf, txt, xslx.

• Binary Property Name Conflicts:
  If the specified binary property name already exists, it may overwrite previous data. Choose unique names if needed.

Links and References

• Carbone.io Documentation
• n8n Docs: Working with Binary Data
• 1001fx Functions Overview