henrri-connect 0.2.2

Bibliothèque souveraine pour utiliser l'API de facturation Henrri.

Henrri Connect

Bibliothèque Python souveraine pour l'API de facturation Henrri. Fournit un client synchrone et asynchrone pour interagir avec l'ensemble des ressources de l'API : clients, factures, articles, unités, revenus, etc.

Ce SDK est un client Python non officiel pour l’API Henrri. Il n’est ni affilié, ni soutenu, ni approuvé par Henrri. Henrri est une marque déposée appartenant à son éditeur.

---

Sommaire

• Henrri Connect
  • Sommaire
  • Installation
  • Démarrage rapide
    • Authentification
    • Mode synchrone
    • Mode asynchrone
  • Modules disponibles
  • Gestion des erreurs
  • Développement
  • Contribution
  • Licence

---

Installation

pip install henrri-connect

Dépendances : httpx et pydantic v2.

---

Démarrage rapide

Authentification

Le client se connecte automatiquement à la première requête et gère le renouvellement du token. Il n'est pas nécessaire d'appeler authenticate() explicitement.

from henrri_connect import SyncHenrriClient

client = SyncHenrriClient("votre_client_id", "votre_client_secret")

L'URL par défaut est l'environnement sandbox (https://api-sandbox.henrri.io). Pour pointer vers la production, passez base_url :

client = SyncHenrriClient(
    "votre_client_id",
    "votre_client_secret",
    base_url="https://api.henrri.io",
)

Mode synchrone

Voir le guide complet d'utilisation synchrone : docs/usage_sync.md

Mode asynchrone

Voir le guide complet d'utilisation asynchrone : docs/usage_async.md

---

Modules disponibles

Le client expose un sous-client par ressource API. Chaque sous-client est identique en synchrone et asynchrone (les méthodes async renvoient des coroutines).

Attribut	Description	Documentation
client.secures	Endpoint de santé de l'API	docs/secures.md
client.users	Utilisateurs et entreprises associées	docs/users.md
client.companies	Entreprises	docs/companies.md
client.customers	Clients (CRUD + contacts)	docs/customers.md
client.documents	Documents (factures, devis, BL…)	docs/documents.md
client.document_lines	Lignes de document	docs/document_lines.md
client.document_types	Types de document (référentiel)	docs/document_types.md
client.document_line_types	Types de ligne de document (référentiel)	docs/document_line_types.md
client.items	Articles / produits	docs/items.md
client.item_categories	Catégories d'articles	docs/item_categories.md
client.units	Unités de mesure	docs/units.md
client.revenues	Statistiques de revenus	docs/revenues.md

Référence API complète : remiv1.github.io/henrri-connect

---

Gestion des erreurs

Toutes les erreurs HTTP sont converties en exceptions typées héritant de HenrriError :

Exception	Code HTTP
HenrriAuthError	401 — Non authentifié
HenrriForbiddenError	403 — Accès interdit
HenrriNotFoundError	404 — Ressource introuvable
HenrriValidationError	400 / 422 — Données invalides
HenrriServerError	5xx — Erreur serveur

from henrri_connect import SyncHenrriClient
from henrri_connect.exc import HenrriNotFoundError, HenrriAuthError

client = SyncHenrriClient("client_id", "client_secret")

try:
    customer = client.customers.get(9999)
except HenrriNotFoundError:
    print("Client introuvable.")
except HenrriAuthError:
    print("Identifiants invalides.")

---

Développement

# Cloner le dépôt
git clone https://github.com/remiv1/henrri-connect.git
cd henrri-connect

# Créer un environnement virtuel et installer les dépendances dev
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

# Lancer les tests
make test

# Générer la documentation
make docs

# Prévisualiser la documentation
make docs-serve

Commandes disponibles :

make test          # Lancer les 96 tests
make build         # Construire la distribution (wheel + sdist)
make build-verify  # Vérifier les artefacts avec twine
make publish       # Publier sur PyPI (demande confirmation)
make docs          # Générer la doc HTML dans docs/
make docs-serve    # Servir la doc localement (port 8080)
make docs-clean    # Nettoyer les fichiers générés
make all           # test + build + build-verify + publish + clean

---

Contribution

Les contributions sont les bienvenues ! Consultez CONTRIBUTING.md pour les conventions de code, le workflow de PR et les bonnes pratiques.

---

Licence

Distribué sous licence MIT. Voir LICENSE.

↑ Retour en haut