Installation

pip install smartbills

# poetry
poetry add smartbills

# pipenv
pipenv install smartbills

# uv
uv add smartbills

from smartbills import SmartbillsClient, SmartbillsClientOptions

options = SmartbillsClientOptions(
    access_token="VOTRE_CLE_API",
    business_id=123,
    locale="fr-CA",
)

async with SmartbillsClient(options) as client:
    result = await client.expenses.list_business()
    print(f"{len(result.data)} dépenses trouvées")

async with SmartbillsClient(options) as client:
    # Utiliser le client
    expenses = await client.expenses.list_business()

client = SmartbillsClient(options)
try:
    expenses = await client.expenses.list_business()
finally:
    await client.close()

# Mettre à jour le jeton d'acces
client.set_access_token("NOUVEAU_JETON")

# Changer le contexte d'entreprise
client.set_business_id(456)

# Changer la locale
client.set_locale("en-CA")

print(client.access_token)  # jeton actuel ou None
print(client.business_id)   # ID d'entreprise actuel ou None
print(client.locale)        # locale actuelle

from smartbills.http_client import RequestOptions

# Surcharger le contexte d'entreprise pour une seule requête
result = await client.expenses.list_business(
    options=RequestOptions(business_id=789, locale="en-CA")
)

@dataclass
class RequestOptions:
    business_id: int | None = None
    locale: str | None = None
    access_token: str | None = None
    extra_headers: dict[str, str] = field(default_factory=dict)

# .env
SMARTBILLS_API_KEY=votre_cle_api_ici
SMARTBILLS_BUSINESS_ID=123

import os
from smartbills import SmartbillsClient, SmartbillsClientOptions

options = SmartbillsClientOptions(
    access_token=os.environ["SMARTBILLS_API_KEY"],
    business_id=int(os.environ["SMARTBILLS_BUSINESS_ID"]),
)

async with SmartbillsClient(options) as client:
    ...