Automated script for retrieving, indexing, and archiving invoices from the OVH API.
Handles logging, database persistence, and email notifications for both normal operations and errors.

Overview

This application connects to the OVH API to:

Fetch all invoice IDs.
Compare them with previously downloaded or recorded invoices.
Download missing invoice PDFs.
Store metadata in a SQLite database.
Send an email report with the list of newly downloaded invoices.

It automatically categorizes invoices by year and stores them in year-specific directories.

Requirements

Python 3.10+
Valid OVH API credentials
SMTP server access for email notifications

Installation

You would need to create a .env file that contain:

APP_KEY
APP_SECRET
CONSUMER_KEY
PATH_OVH
DB_PATH
EMAIL
EMAIL_PASSWORD
SMTP_MAIL_ADDRESS
SMTP_PORT
EMAIL_TO
YEAR

Installation

git clone git@github.com:Fare-spec/get_ovh_bills.git
cd get_ovh_bills
pip install -r requirements.txt

With uv:


git clone git@github.com:Fare-spec/get_ovh_bills.git
cd get_ovh_bills
uv venv
uv run main.py