UK Companies House accounts filing for GnuCash users
Project description
gnucash-ch-filing
Introduction
Very partial implementation of the Companies House Software Filing interface. There is enough support to file company accounts.
This utility is designed to take a UK company accounts file formatted using
gnucash-ixbrl
and
submits in accordance with the Software Filing API.
gnucash-ch-filing
presently understands a small subset of the accounts
management process, and may be useful for a small business with simple
accounting affairs. It really is no use to a complex business.
Status
This is a command-line utility, which has been tested with the Software Filing API.
Credentials
In order to use this, you need production credentials (presenter ID, authentication value and the company authentication code) for the company you are filing for.
Companies House documentation:
Installing
pip3 install git+https://github.com/cybermaggedon/gnucash-ch-filing
Testing
I can't share my test credentials with you, you would need to email Companies House to get some.
You need to edit the config.json
file to contain the right details for
you. Check the credentials work by fetching company information:
% ch-filing --get-company-data
Company accounts should be an iXBRL file which conforms to the CH accepted taxonomies. Once you are ready to file:
% ch-filing --submit-accounts --accounts accts.html
You get a submission ID in return. To check the process of the submitted accounts:
% ch-filing --get-submission-status -i S00027
S00027: PENDING
Usage
usage: ch-filing [-h] [--config CONFIG] [--state STATE] [--accounts ACCOUNTS]
[--get-company-data] [--submit-accounts]
[--get-submission-status] [--submission-id SUBMISSION_ID]
Submittion to HMRC Corporation Tax API
optional arguments:
-h, --help show this help message and exit
--config CONFIG, -c CONFIG
Configuration file (default: config.json)
--state STATE, -s STATE
Transaction counter state (default: state.json)
--accounts ACCOUNTS, -a ACCOUNTS
Company accounts iXBRL file
--get-company-data, -C
Get company details, to check the authentication
--submit-accounts, -S
Submit company accounts
--get-submission-status, -G
Get status of previous filing
--submission-id SUBMISSION_ID, -i SUBMISSION_ID
Submission ID of previous filing
Licences, Compliance, etc.
Warranty
This code comes with no warranty whatsoever. See the LICENCE file for details. Further, I am not an accountant. It is possible that this code could be useful to you in meeting regulatory reporting requirements for your business. It is also possible that the software could report misleading information which could land you in a lot of trouble if used for regulatory purposes. Really, you should check with a qualified accountant.
Licence
Copyright (C) 2021, Cyberapocalypse Limited
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
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
File details
Details for the file gnucash-ch-filing-0.2.1.tar.gz
.
File metadata
- Download URL: gnucash-ch-filing-0.2.1.tar.gz
- Upload date:
- Size: 7.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.5.0.1 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.62.1 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70aadfa00dfd6325375bdb8c39abd273bf31da18e22c4a5b9d474370d1fc5591 |
|
MD5 | 3fb4617d1bc0e524849ed6f0387efd09 |
|
BLAKE2b-256 | 8bafe28b5a1568e3eb5d948e1e16e7f487f3c2a51a776f8fb258875c001e5e56 |