n8n-nodes-json-to-pdf-invoice

This is an n8n community node that converts JSON data into beautifully formatted PDF invoices with a modern, elegant design.

✨ NEW: Professional Blue Theme & Logo Support!

Your invoices now feature a professional design with:

• 🔵 Blue table headers - Material Design blue theme
• 💙 Alternating blue/white rows for easy reading
• 🖼️ Company Logo Support - Add your logo to invoices!
• 📦 Styled totals boxes with blue backgrounds
• 📄 Clean receipt layout with modern spacing
• ⏰ Automatic timestamps (Receipt No., Date, Time)

See BLUE_THEME_AND_LOGO.md for details!

Features

• 📄 Professional Invoice Generation: Create polished PDF invoices from JSON data
• 🎨 Modern Design: Blue-themed receipt style with elegant spacing
• 🖼️ Logo Support: Add your company logo to every invoice
• 🎨 Customizable Branding: Add your company name, address, and invoice details
• 📊 Automatic Calculations: Handles subtotals, VAT/discounts, and final totals
• 💾 Flexible Output: Export as base64 or binary data for easy saving/sharing
• 🔄 Seamless Integration: Works perfectly in n8n workflows

Installation

Follow the installation guide in the n8n community nodes documentation.

Option 1: Install via n8n UI

1. Go to Settings > Community Nodes
2. Click Install
3. Enter n8n-nodes-json-to-pdf-invoice
4. Click Install

Option 2: Install via npm

Navigate to your n8n installation directory and run:

npm install n8n-nodes-json-to-pdf-invoice

Option 3: Manual Installation (Development)

1. Clone this repository
2. Navigate to the directory
3. Run npm install
4. Run npm run build
5. Link the package: npm link
6. In your n8n directory: npm link n8n-nodes-json-to-pdf-invoice
7. Restart n8n

Usage

Input Data Format

The node expects JSON input with the following structure:

[
  {
    "Items": [
      {
        "Item": "plot",
        "Quantity": 23,
        "Price": 200
      },
      {
        "Item": "milk",
        "Quantity": 2,
        "Price": 900
      },
      {
        "Item": "bird",
        "Quantity": 2,
        "Price": 200
      }
    ],
    "Discount": 2317.4,
    "TotalAfterDiscount": 20856.6
  }
]

Node Parameters

Parameter	Description	Default	Required
Invoice Title	Title displayed at the top	INVOICE	No
Company Name	Your company name	Your Company Name	No
Company Address	Your company address (use \n for line breaks)	123 Business Street...	No
Invoice Number	Unique invoice number	Auto-generated	No
Invoice Date	Invoice date	Current date	No
Customer Name	Customer's name	From JSON or default	No
Customer Address	Customer's address	From JSON or default	No
Items Field Name	JSON field containing items array	Items	Yes
Discount Field Name	JSON field containing discount value	Discount	Yes
Total After Discount Field Name	JSON field containing final total	TotalAfterDiscount	Yes
Currency Symbol	Currency symbol to display	$	No
Output Format	base64 or binary	binary	No

Example Workflow

1. HTTP Request Node: Fetch invoice data from your API
2. JSON to PDF Invoice Node: Configure parameters and generate PDF
3. Write Binary File Node: Save the PDF to disk or send via email

Output

The node outputs:

Binary Format (default):

• Binary data ready to be saved as a PDF file
• Can be used with "Write Binary File" node or email attachments

Base64 Format:

• JSON object with pdfBase64 field containing the encoded PDF
• Useful for API responses or database storage

Example Configuration

// In the JSON to PDF Invoice node:
Company Name: "Acme Corporation"
Company Address: "123 Main Street\nNew York, NY 10001\nUSA"
Invoice Number: INV-{{$now.format("yyyyMMdd")}}-{{$runIndex}}
Invoice Date: {{$now.format("yyyy-MM-dd")}}
Customer Name: {{$json["customerName"]}}
Items Field Name: Items
Discount Field Name: Discount
Total After Discount Field Name: TotalAfterDiscount
Currency Symbol: $
Output Format: binary

Generated Invoice Features

The generated PDF includes:

• ✅ Professional header with invoice title
• ✅ Company information block
• ✅ Invoice number and date
• ✅ Customer billing information
• ✅ Itemized table with:
  • Item names
  • Quantities
  • Individual prices
  • Line totals
• ✅ Automatic calculations:
  • Subtotal
  • Discount amount
  • Final total
• ✅ Color-coded header and totals
• ✅ Zebra-striped table rows for readability
• ✅ Professional footer message

Technical Details

Dependencies

• pdfkit: Open-source PDF generation library
• n8n-workflow: n8n core workflow functionality

Node Type

• Type: Transform
• Inputs: 1
• Outputs: 1

Troubleshooting

Issue: Field not found error

Solution: Ensure your JSON field names match the configured parameters (e.g., "Items", "Discount", "TotalAfterDiscount")

Issue: PDF not displaying correctly

Solution:

• Check that quantity and price values are numbers, not strings
• Verify all required fields are present in the input JSON

Issue: Special characters not rendering

Solution: PDFKit supports Unicode. Ensure your input data is properly UTF-8 encoded

Development

# Install dependencies
npm install

# Build the node
npm run build

# Watch for changes during development
npm run dev

# Lint the code
npm run lint

# Format the code
npm run format

License

MIT

Resources

• n8n community nodes documentation
• PDFKit documentation
• n8n

Support

For issues, questions, or contributions, please open an issue in the GitHub repository.

Version History

1.0.0

• Initial release
• JSON to PDF invoice conversion
• Customizable company and customer information
• Automatic calculations
• Multiple output formats (base64 and binary)