django-sage-invoice

Django Sage Invoice

Django Sage Invoice is a Django application for managing invoices. It provides a robust admin interface to create, view, and manage invoices and their related components like categories, items, and totals.

Features

• Create and manage invoices with detailed customer information.
• Customize invoices with logos, backgrounds, signatures, and stamps.
• Add custom columns to each invoice for additional information.
• Generate invoice totals automatically, including tax and discount calculations.
• Export invoices as HTML files bundled in a ZIP archive.
• Choose from predefined templates or define your own.

Installation

Using pip with virtualenv

• Create a Virtual Environment:

  python -m venv .venv
  

• Activate the Virtual Environment:

  • On Windows:

    .venv\Scripts\activate
    

  • On macOS/Linux:

    source .venv/bin/activate
    

• Install django-sage-invoice:

  pip install django-sage-invoice
  

Using poetry

• Initialize Poetry (if not already initialized):

  poetry init
  

• Install django-sage-invoice:

  poetry add django-sage-invoice
  

• Apply Migrations:

  After installation, make sure to run the following commands to create the necessary database tables:

  python manage.py makemigrations
  python manage.py migrate
  

Configuration

Django Settings

Add django-sage-invoice to your INSTALLED_APPS in the Django settings and configure the SAGE_MODEL_PREFIX and SAGE_MODEL_TEMPLATE:

INSTALLED_APPS = [
    # other packages
    "sage_tools",
    "sage_invoice",
]
SAGE_MODEL_PREFIX = "invoice"
SAGE_MODEL_TEMPLATE = "sage_invoice"