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="YOUR_API_KEY",
    business_id=123,
    locale="en-CA",
)

async with SmartbillsClient(options) as client:
    result = await client.expenses.list_business()
    print(f"Found {len(result.data)} expenses")

async with SmartbillsClient(options) as client:
    # Use the client
    expenses = await client.expenses.list_business()

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

# Update the access token
client.set_access_token("NEW_TOKEN")

# Switch business context
client.set_business_id(456)

# Change locale
client.set_locale("fr-CA")

print(client.access_token)  # current token or None
print(client.business_id)   # current business ID or None
print(client.locale)        # current locale

from smartbills.http_client import RequestOptions

# Override business context for a single request
result = await client.expenses.list_business(
    options=RequestOptions(business_id=789, locale="fr-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=your_api_key_here
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:
    ...