Quickstart¶
This chapter covers the steps needed in order to set up kescher to start accounting.
Initialization¶
It is useful to have a directory dedicated to kescher. Documents, bank statements, etc. can and should be stored here.
Note
It is not recommended to import documents from outside the kescher directory, as this is can cause problems when using exports.
Create the kescher working directory
$ mkdir accounting_2020
$ cd accounting_2020
Next, you initialize the kescher in this directory. This will create the database kescher.db and a log file kescher.log here.
Account Creation¶
The easiest way to set up your chart of accounts is by creating a yaml file with the following structure
Customers:
- "1000"
- "1001"
- "1002"
VAT:
- VAT_in
- VAT_out
Expenses:
- Internet
- Power
- Rent
- Phone
- Aquisition:
- Hardware
- Materials
Revenue:
- Internet_Connections
This will create four base accounts (Customers, VAT, Expenses, Revenue) with child accounts. The base accounts are not meant to be used to directly assign bookings to, but rather to allow for easier balance aggregation.
Invoice Import¶
Invoices can be imported directly from a rechnung working directory. Of course it is possible to import invoices from another invoicing tool, but currently only the format rechnung uses is supported (yaml file for data and a pdf as the real document).
$ kescher import-invoices --nested ../rechnung_2020/invoices cid total\_gross date
This will import all invoices from rechnung located in the given directory. This will create virtual bookings for each invoice. These virtual bookings are virtual as they are not the basis for tax calculations. Non existing customer accounts will be created (yet, not assigned to the Customer parent account!). The pdf documents are imported as documents, ready to be assigned to entries in your journal.
If you want to import invoices from another tool, you can also convert the necessary data to the desired data, an store them in a directory and use the –flat option for the import. A minimal invoice to be imported into kescher would look like this:
cid: "1000"
total_gross: 24.00
date: "2020-02-11"