How rusik636/nalogo works
NaloGO is an asynchronous Python client for Russia’s Moy Nalog self-employed tax API. The principal workflow is to authenticate a user, activate a client, then create or cancel income receipts; the library also exposes receipt, profile, payment-method, and tax-reporting APIs. The graph includes the shared HTTP/authentication layer, timezone normalization, and DTOs. Some API modules are unsampled, so their capabilities are grounded in the README and module references; unsupported internal call details are omitted.
Main entry points: client.py Client · _http.py HTTP middleware · auth.py Authentication · income.py Income and cancellation
Components 18
Client facade
- Client
nalogo/client.py
Auth and transport
- Authentication
nalogo/auth.py - HTTP middleware
nalogo/_http.py
Domain APIs
- Income and cancellation
nalogo/income.py - Receipt operations
nalogo/receipt.py - User profile
nalogo/user.py - Payment methods
nalogo/payment_type.py - Tax reporting
nalogo/tax.py
Models and errors
- Timezone handling
nalogo/timezone.py - Income models
nalogo/dto/income.py - Device model
nalogo/dto/device.py - Invoice model
nalogo/dto/invoice.py - Payment models
nalogo/dto/payment_type.py - Tax models
nalogo/dto/tax.py - User models
nalogo/dto/user.py - Domain errors
nalogo/exceptions.py
Other components
- Library user
- Moy Nalog API
Connections 25
- Library user → Client: configures and calls
README.md - Client → Authentication: delegates auth
nalogo/client.py - Client → HTTP middleware: shares client
nalogo/client.py - Client → Income and cancellation: creates API
nalogo/client.py - Client → Receipt operations: creates API
nalogo/client.py - Client → User profile: creates API
nalogo/client.py - Client → Payment methods: creates API
nalogo/client.py - Client → Tax reporting: creates API
nalogo/client.py - Authentication → HTTP middleware: refreshes through
nalogo/_http.py - Authentication → Device model: builds device data
nalogo/auth.py - Authentication → Moy Nalog API: requests tokens
nalogo/auth.py - Income and cancellation → HTTP middleware: sends requests
nalogo/income.py - Receipt operations → HTTP middleware: uses transport
nalogo/receipt.py - User profile → HTTP middleware: uses transport
nalogo/user.py - Payment methods → HTTP middleware: uses transport
nalogo/payment_type.py - Tax reporting → HTTP middleware: uses transport
nalogo/tax.py - HTTP middleware → Moy Nalog API: sends API requests
nalogo/_http.py - Income and cancellation → Income models: builds requests
nalogo/income.py - Income and cancellation → Timezone handling: normalizes time
nalogo/income.py - Income models → Timezone handling: serializes time
nalogo/dto/income.py - User profile → User models: returns profile data
- Payment methods → Payment models: returns payment data
- Tax reporting → Tax models: returns tax data
- HTTP middleware → Domain errors: raises API errors
nalogo/_http.py - Timezone handling → Domain errors: raises input errors
nalogo/timezone.py