DEV Community

Lucas Gragg
Lucas Gragg

Posted on

PDF invoices with dynamic branding

#python #tutorial #productivity

Creating PDF invoices with dynamic branding can be a lifesaver for freelancers and small businesses. You want your invoices to look professional, reflect your brand, and be easy to generate without manually tweaking them every time. Let me walk you through how you can achieve this using Python, because, let's face it, automating this process can save a ton of time and hassle.

Setting Up the Environment

First things first, you need a couple of libraries to handle PDF generation and image processing. ReportLab is an excellent choice for creating PDFs, and Pillow works well for handling images like logos. Install these using pip:

pip install reportlab pillow
Enter fullscreen mode Exit fullscreen mode

Generating a Basic PDF Invoice

Here's a basic example of how you can generate a PDF invoice with dynamic content:

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from PIL import Image

def create_invoice(company_logo, company_name, client_name, items):
    c = canvas.Canvas("invoice.pdf", pagesize=letter)
    width, height = letter

    # Add the company logo
    logo = Image.open(company_logo)
    c.drawImage(company_logo, 50, height - 100, width=100, height=50)

    # Add company and client information
    c.setFont("Helvetica", 12)
    c.drawString(50, height - 150, f"Company: {company_name}")
    c.drawString(50, height - 170, f"Client: {client_name}")

    # Add item details
    y_position = height - 220
    for item, price in items:
        c.drawString(50, y_position, f"{item}: ${price}")
        y_position -= 20

    # Finish up
    c.save()

create_invoice("logo.png", "My Company", "John Doe", [("Design Work", 300), ("Consultation", 150)])
Enter fullscreen mode Exit fullscreen mode

This script creates a simple PDF invoice with a placeholder logo, company name, client name, and a list of services with prices. The drawImage and drawString methods from reportlab.pdfgen.canvas allow you to customize the positioning of elements.

Customizing the Template

Now, you might want your invoices to stand out more with your brand colors, fonts, and layouts. This is where the flexibility of ReportLab really shines. For instance, you can change the font or add a colored background:

from reportlab.lib import colors

def create_custom_invoice(company_logo, company_name, client_name, items):
    c = canvas.Canvas("custom_invoice.pdf", pagesize=letter)
    width, height = letter

    # Set a background color
    c.setFillColor(colors.lightgrey)
    c.rect(0, 0, width, height, fill=True, stroke=False)

    # Add the company logo and details (remaining code as before)
    # ...

create_custom_invoice("logo.png", "My Company", "John Doe", [("Design Work", 300), ("Consultation", 150)])
Enter fullscreen mode Exit fullscreen mode

A Real-World Solution

I ended up needing a more robust solution for generating invoices in my projects, especially when it came to handling complex items, multi-currency, and client management. That's why I packaged all the essential features into a tool called Invoice Generator. It includes customizable templates, automatic calculations, and client management, making it easy to create professional PDF invoices in seconds.

Developing this tool was a game-changer for me, and it might be a helpful addition to your workflow as well. If you're looking for something that handles invoice generation and client management seamlessly, it’s worth checking out.

Also available on Payhip with instant PayPal checkout.

If you need a server to run your bots 24/7, I use DigitalOcean — $200 free credit for new accounts.

Top comments (0)