Skip to main content

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


Download files

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

Source Distribution

gnucash-ch-filing-0.2.1.tar.gz (7.8 kB view details)

Uploaded Source

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

Hashes for gnucash-ch-filing-0.2.1.tar.gz
Algorithm Hash digest
SHA256 70aadfa00dfd6325375bdb8c39abd273bf31da18e22c4a5b9d474370d1fc5591
MD5 3fb4617d1bc0e524849ed6f0387efd09
BLAKE2b-256 8bafe28b5a1568e3eb5d948e1e16e7f487f3c2a51a776f8fb258875c001e5e56

See more details on using hashes here.

Supported by

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