@radzor/invoice-generator

Generate PDF invoices from structured data. Build invoices with line items, customer info, tax calculations, and export as PDF buffers or structured JSON.

Paymentv0.1.0typescriptpythonServerinvoicepdfbillingpaymentaccountingfinanceby Radzor

Install

View source on GitHub →

$npx radzor@latest add invoice-generator

⚠ Constraints: Server-side only. PDF generation requires pdfkit. Line items must be added before calling generate(). Customer must be set before generating.

Inputs

Name	Type	Default	Description
companyName*	string	—	Your company or business name for the invoice header.
companyAddress	string	—	Your company address for the invoice header.
currency	string	USD	Currency code (ISO 4217) for monetary amounts.
taxRate	number	0	Default tax rate as a percentage (e.g. 20 for 20%).
invoicePrefix	string	INV	Prefix for auto-generated invoice numbers.

companyName*string

Your company or business name for the invoice header.

{ "llm": { "constraints": "Server-side only. PDF generation requires pdfkit. Line items must be added before calling generate(). Customer must be set before generating.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/invoice-generator", "tags": [ "invoice", "pdf", "billing", "payment", "accounting", "finance" ], "events": [ { "name": "onGenerated", "payload": { "total": "number", "customerEmail": "string", "invoiceNumber": "string" }, "description": "Fired when a PDF invoice is successfully generated." }, { "name": "onError", "payload": { "code": "string", "message": "string" }, "description": "Fired when invoice generation fails." } ], "inputs": [ { "name": "companyName", "type": "string", "required": true, "description": "Your company or business name for the invoice header." }, { "name": "companyAddress", "type": "string", "required": false, "description": "Your company address for the invoice header." }, { "name": "currency", "type": "string", "default": "USD", "required": false, "description": "Currency code (ISO 4217) for monetary amounts." }, { "name": "taxRate", "type": "number", "default": 0, "required": false, "description": "Default tax rate as a percentage (e.g. 20 for 20%)." }, { "name": "invoicePrefix", "type": "string", "default": "INV", "required": false, "description": "Prefix for auto-generated invoice numbers." } ], "radzor": "1.0.0", "actions": [ { "name": "generate", "params": [], "returns": "Promise<{ pdf: Buffer; data: InvoiceData }>", "description": "Generate the PDF invoice from accumulated line items and customer info. Returns the PDF buffer and structured data." }, { "name": "addLineItem", "params": [ { "name": "description", "type": "string", "description": "Description of the line item." }, { "name": "quantity", "type": "number", "description": "Quantity of items." }, { "name": "unitPrice", "type": "number", "description": "Price per unit in the configured currency." } ], "returns": "void", "description": "Add a line item to the current invoice." }, { "name": "setCustomer", "params": [ { "name": "name", "type": "string", "description": "Customer full name or company name." }, { "name": "email", "type": "string", "description": "Customer email address." }, { "name": "address", "type": "string", "required": false, "description": "Customer billing address." } ], "returns": "void", "description": "Set the customer details for the invoice." } ], "outputs": [ { "name": "invoicePdf", "type": "Buffer", "description": "Generated PDF invoice as a Node.js Buffer." }, { "name": "invoiceData", "type": "InvoiceData", "fields": [ { "name": "invoiceNumber", "type": "string", "description": "Unique invoice number." }, { "name": "date", "type": "string", "description": "Invoice date (ISO 8601)." }, { "name": "customer", "type": "CustomerInfo", "description": "Customer name, email, and address." }, { "name": "lineItems", "type": "LineItem[]", "description": "Array of line items with description, quantity, unit price, and total." }, { "name": "subtotal", "type": "number", "description": "Sum of all line item totals before tax." }, { "name": "taxAmount", "type": "number", "description": "Tax amount calculated from subtotal." }, { "name": "total", "type": "number", "description": "Final total including tax." } ], "description": "Structured invoice data with totals and line items." } ], "runtime": "server", "version": "0.1.0", "category": "payment", "languages": [ "typescript", "python" ], "description": "Generate PDF invoices from structured data. Build invoices with line items, customer info, tax calculations, and export as PDF buffers or structured JSON.", "dependencies": { "radzor": [], "packages": { "pdfkit": "^0.15.0" } }, "composability": { "connectsTo": [ { "output": "invoicePdf", "compatibleWith": [ "@radzor/email-send.action.send.message", "@radzor/s3-upload.action.upload.body" ] }, { "output": "invoiceData", "mapField": "invoiceNumber", "compatibleWith": [ "@radzor/csv-export.action.generate.data" ] } ] } }

@radzor/invoice-generator

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Name	Type	Description
invoicePdf	Buffer	Generated PDF invoice as a Node.js Buffer.
invoiceData	InvoiceData	Structured invoice data with totals and line items. .invoiceNumberstring .datestring .customerCustomerInfo .lineItemsLineItem[] .subtotalnumber .taxAmountnumber .totalnumber