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.
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.
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, orvat_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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c072349f1421dc625fe99f22e9415371ee6e53bc0f999e912800673765cf26d1
|
|
| MD5 |
b33d8ba5e19fc3e9fe17f900b570ce46
|
|
| BLAKE2b-256 |
a592a15193801c98411572378eb295cd0dd03a0d1aa0b2ad51f006acd0de906d
|
Provenance
The following attestation bundles were made for administracli-0.0.0.tar.gz:
Publisher:
upload-pypi.yml on spmvg/AdministraCLI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
administracli-0.0.0.tar.gz -
Subject digest:
c072349f1421dc625fe99f22e9415371ee6e53bc0f999e912800673765cf26d1 - Sigstore transparency entry: 999890360
- Sigstore integration time:
-
Permalink:
spmvg/AdministraCLI@888b99334f5526a6e5f7f00995bc086dce4c72f1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/spmvg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
upload-pypi.yml@888b99334f5526a6e5f7f00995bc086dce4c72f1 -
Trigger Event:
workflow_dispatch
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26dc77cfa63f8ab96ce17a2bcee114e03dfa79cb5852c24511995e20db299e2b
|
|
| MD5 |
d67e68c57ddecb1b2b8e1bb908b39cbb
|
|
| BLAKE2b-256 |
ad0f0d00b93b22f71e14da045d95a89310de208823a0b0eb69d1558b133e54bd
|
Provenance
The following attestation bundles were made for administracli-0.0.0-py3-none-any.whl:
Publisher:
upload-pypi.yml on spmvg/AdministraCLI
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
administracli-0.0.0-py3-none-any.whl -
Subject digest:
26dc77cfa63f8ab96ce17a2bcee114e03dfa79cb5852c24511995e20db299e2b - Sigstore transparency entry: 999890383
- Sigstore integration time:
-
Permalink:
spmvg/AdministraCLI@888b99334f5526a6e5f7f00995bc086dce4c72f1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/spmvg
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
upload-pypi.yml@888b99334f5526a6e5f7f00995bc086dce4c72f1 -
Trigger Event:
workflow_dispatch
-
Statement type: