version 1.1, 2020/09/27 14:35:34 |
version 1.3, 2020/11/10 19:08:06 |
|
|
.Os |
.Os |
.Sh NAME |
.Sh NAME |
.Nm pta-journal |
.Nm pta-journal |
.Nd main input file format for the plain text accounting program |
.Nd main input file format for plain text accounting |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The file |
The file |
.Pa journal.txt |
.Pa journal.txt |
Line 48 Fields are given in the following order: |
|
Line 48 Fields are given in the following order: |
|
The date in the eight-digit form YYYYMMDD; |
The date in the eight-digit form YYYYMMDD; |
entries have to appear in chronological order. |
entries have to appear in chronological order. |
.It |
.It |
A booking identifier, consisting of one or more capital latin letters |
A booking identifier, consisting of one or more non-blank characters. |
in the range |
For example, it might begin with a few letters to identify a bank |
.Bq A\(enZ , |
account, a credit card, or a cash office, the ordinal number of a |
optionally followed by a pair of numbers separated by a slash. |
bank statement or a cashbook sheet might follow, and it might end |
Typically, the letters are used to identify a bank account, a credit card, |
with an entry number within the bank statement or cashbook sheet. |
or a cash office, the digits before the slash represent the number of a |
Following a consistent format within each journal file is recommended |
bank statement or cashbook sheet, and the digits after the slash a sheet |
but not required. |
or entry number within the bank statement or cashbook sheet. |
|
Booking identifiers need not be unique. |
Booking identifiers need not be unique. |
.It |
.It |
A debit |
A debit |
Line 75 a decimal point, and again one or more digits. |
|
Line 74 a decimal point, and again one or more digits. |
|
A text string that can include space characters. |
A text string that can include space characters. |
.El |
.El |
.Pp |
.Pp |
If the text starts with as string enclosed in |
If the text contains a string enclosed in |
.Bq square brackets , |
.Bq square brackets , |
the enclosed string is used as the name of a |
the enclosed string is used as the name of a |
.Em cost center . |
.Em cost center . |
.Pp |
.Pp |
If the text starts with as string enclosed in |
If the text contains a string enclosed in |
.Pq parentheses , |
.Pq parentheses , |
the enclosed string is used as the name of a |
the enclosed string is used as the name of a |
.Em subaccount , |
.Em subaccount , |
Line 90 In the unusual case that both the debit and the credit |
|
Line 89 In the unusual case that both the debit and the credit |
|
revenue or expense account, using the split notation described below |
revenue or expense account, using the split notation described below |
is recommended to disambiguate which account the subaccount name |
is recommended to disambiguate which account the subaccount name |
applies to. |
applies to. |
.Pp |
|
If both a cost center and a subaccount are given on the same line, |
|
the cost center is expected to precede the subaccount. |
|
.Ss Split journal entries |
.Ss Split journal entries |
All transactions can be represented by using only elementary |
All transactions can be represented by using only elementary |
.Em journal entries |
.Em journal entries |