contaplus-reader
contaplus-reader reads Sage ContaPlus accounting exports — raw DIARIO.DBF
tables and ContaPlus backup .zip archives — and extracts all of their data
(the journal, subaccounts, the trial balance, and the operational tables) into a
styled .xlsx workbook. It ships as a Python library and as the
contaplus2xlsx command-line tool, and is intended for anyone migrating off
Sage ContaPlus who needs their data in an open, usable format.
Installation
Run the CLI without installing anything:
uvx contaplus2xlsx INPUT OUTPUT
Install the library (and the contaplus2xlsx CLI) from PyPI:
pip install contaplus-reader
CLI Usage
Convert a raw DIARIO.DBF journal export to a styled Excel workbook:
contaplus2xlsx DIARIO.DBF out.xlsx
Convert a ContaPlus backup .zip archive:
contaplus2xlsx backup.zip out.xlsx
Select one company from a multi-company backup with --company (the company
directory name inside the archive, e.g. Emp01):
contaplus2xlsx backup.zip out.xlsx --company Emp01
Use --lenient to extract everything readable from a damaged or non-standard
archive — unreadable rows and tables are collected into a separate problems
sheet and reported on stdout instead of aborting the conversion:
contaplus2xlsx backup.zip out.xlsx --lenient
Add --force (or --overwrite) to overwrite an existing output file.
Table Coverage
contaplus-reader extracts every table below into its own sheet of the output
workbook:
| Sheet | Source | Notes |
|---|---|---|
| Diario | DIARIO.DBF |
The accounting journal — strictly read and validated |
| Subcuentas | SUBCTA.DBF |
Subaccount master |
| Balance bruto | BALAN.DBF |
Raw trial balance as stored by ContaPlus |
| Sumas y Saldos — Cuentas | computed | Trial balance recomputed at account level |
| Sumas y Saldos — Subcuentas | computed | Trial balance recomputed at subaccount level |
| Vencimientos | venci.dbf |
Due dates / maturities |
| Predefinidos | prede.dbf |
Predefined entries |
| Amortizaciones / Inversiones | amoinv.dbf |
Depreciation and investments |
| Niveles | nivel.dbf |
Account level definitions |
| Empresa / Grupos / Usuarios | empresa.dbf, grupos.dbf, usuarios.dbf |
Company, group, and user metadata |
Strict vs. Lenient
By default the reader runs in strict mode: it fails on the first invalid
row, which is what a tax-grade reading of the journal requires. Lenient mode
(--lenient) instead extracts all readable data, collecting every problem
(table, row, column, and a plain-English reason) into a dedicated problems sheet
and printing the same detail on stdout — useful for recovering data from a
damaged or non-standard archive.
Browser PWA
A no-install browser version is in development — your ContaPlus file never leaves your machine.
License
contaplus-reader is released under the LGPL-3.0-or-later license.
1 maintainer
Metadata
1 maintainer
Release files for contaplus-reader 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| contaplus_reader-0.1.0.tar.gz | 39.9 kB | Without provenance | Details for contaplus_reader-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| contaplus_reader-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for contaplus_reader-0.1.0-py3-none-any.whl |
Total release size: 84.5 kB
Release files / contaplus_reader-0.1.0.tar.gz
| Download URL | contaplus_reader-0.1.0.tar.gz |
|---|---|
| Size | 39.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50e5638bd06ac0259e5f8dd7942c484875dd277d7b2f7e618eaf2f49c4de8e44
|
|
BLAKE2b-256 checksum How to use checksums |
dd3a20a72b29dda8f82211e778637e422b77a1929f036673a8225478e2a24673
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / contaplus_reader-0.1.0-py3-none-any.whl
| Download URL | contaplus_reader-0.1.0-py3-none-any.whl |
|---|---|
| Size | 44.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
719129e86f0ce04a9ff9c345edc6e03941c787ba43ec454a97eb81e88cca4f68
|
|
BLAKE2b-256 checksum How to use checksums |
043866df5949b8c57e8f6147d75e39df7f7af758ad0f525ab4bef76488109e3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for contaplus-reader 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
