Skip to main content

Command line tool for small business administration with local data in an Excel sheet

Project description

AdministraCLI

Minimal transaction-matching and invoicing tool for small businesses. All data lives in a single local Excel file — no server, no database.

Balance sheet and P&L

AdministraCLI is not a full accounting package. It tracks bank transactions and invoices only — no fixed assets, loans, or depreciation. Create a separate workbook for each reporting year. Because you only enter mutations, the balance sheet shows differences, not absolute positions. Use AdministraCLI's output as input for a complete balance sheet if needed.

Installation

pip install administracli

Usage

administracli init   # create administracli.xlsx
# fill in transactions and invoices in Excel
administracli run    # categorise and view reports

run walks you through each uncategorised transaction. Open invoices appear alongside categories so you can match them in one step. Once everything is categorised, the balance sheet and P&L are shown.

Transaction matching

Corporate income tax

Categorise CIT advance payments as Corporate income tax. Set the definitive amount in the settings sheet (cit_amount).

  • Not yet assessed — advances show as CIT prepayment on the balance sheet; nothing in the P&L.
  • Assessed — the definitive amount appears as expense in the P&L. The difference with advances shows as CIT receivable or CIT payable on the balance sheet.

VAT

Add periods in vat_declarations (start inclusive, end exclusive). Computed fields are recalculated on every run, rounded to whole euros (Dutch BTW).

  • Outgoing invoices require vat_rate. Amounts are including VAT.
  • Incoming invoices require exactly one of vat_rate, vat_rate_abroad_from_outside_eu, or vat_rate_abroad_from_inside_eu. Domestic amounts are including VAT; reverse-charge amounts are excluding VAT.

Categorise VAT payments as VAT. Link to a declaration for definitive payments.

License

AGPL-3.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

administracli-0.0.0.tar.gz (28.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

administracli-0.0.0-py3-none-any.whl (26.4 kB view details)

Uploaded Python 3

File details

Details for the file administracli-0.0.0.tar.gz.

File metadata

  • Download URL: administracli-0.0.0.tar.gz
  • Upload date:
  • Size: 28.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for administracli-0.0.0.tar.gz
Algorithm Hash digest
SHA256 c072349f1421dc625fe99f22e9415371ee6e53bc0f999e912800673765cf26d1
MD5 b33d8ba5e19fc3e9fe17f900b570ce46
BLAKE2b-256 a592a15193801c98411572378eb295cd0dd03a0d1aa0b2ad51f006acd0de906d

See more details on using hashes here.

Provenance

The following attestation bundles were made for administracli-0.0.0.tar.gz:

Publisher: upload-pypi.yml on spmvg/AdministraCLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file administracli-0.0.0-py3-none-any.whl.

File metadata

  • Download URL: administracli-0.0.0-py3-none-any.whl
  • Upload date:
  • Size: 26.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for administracli-0.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 26dc77cfa63f8ab96ce17a2bcee114e03dfa79cb5852c24511995e20db299e2b
MD5 d67e68c57ddecb1b2b8e1bb908b39cbb
BLAKE2b-256 ad0f0d00b93b22f71e14da045d95a89310de208823a0b0eb69d1558b133e54bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for administracli-0.0.0-py3-none-any.whl:

Publisher: upload-pypi.yml on spmvg/AdministraCLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page