invoice-generation

id	SKL-invoice-INVOICEGENERATION
name	Invoice Generation
description	This skill provides comprehensive patterns for generating invoices in billing systems. It covers invoice data structure, PDF generation using PDFKit and Puppeteer, invoice templates, line item calcula
version	1.0.0
status	active
owner	@cerebra-team
last_updated	2026-02-22
category	Backend
tags	["api","backend","server","database"]
stack	["Python","Node.js","REST API","GraphQL"]
difficulty	Intermediate

Invoice Generation

Skill Profile

(Select at least one profile to enable specific modules)

• DevOps
• Backend
• Frontend
• AI-RAG
• Security Critical

Overview

This skill provides comprehensive patterns for generating invoices in billing systems. It covers invoice data structure, PDF generation using PDFKit and Puppeteer, invoice templates, line item calculation, tax calculation, invoice numbering, storage and retrieval, email delivery, status tracking, and compliance requirements.

Why This Matters

• Professionalism: Professional invoices build customer trust
• Compliance: Proper invoices meet tax and accounting requirements
• Automation: Automated generation reduces manual overhead
• Customer Experience: Timely invoice delivery improves cash flow

---

Core Concepts & Rules

1. Core Principles

• Follow established patterns and conventions
• Maintain consistency across codebase
• Document decisions and trade-offs

2. Implementation Guidelines

• Start with the simplest viable solution
• Iterate based on feedback and requirements
• Test thoroughly before deployment

Inputs / Outputs / Contracts

• Inputs:
  • Environment variables: PDF_STORAGE_PATH, EMAIL_FROM, SMTP_HOST
  • Configuration: invoice template, tax rates, invoice number format
  • Database schema: invoices, invoice_line_items, invoice_taxes
• Entry Conditions:
  • Database tables created for invoices
  • PDF generation library installed
  • Email service configured
• Outputs:
  • Generated PDF invoices
  • Invoice records in database
  • Email delivery confirmations