=================================================================== RCS file: /cvs/pta/pta_import.1,v retrieving revision 1.8 retrieving revision 1.12 diff -u -p -r1.8 -r1.12 --- pta/pta_import.1 2020/11/26 19:39:43 1.8 +++ pta/pta_import.1 2020/12/03 14:17:39 1.12 @@ -1,4 +1,4 @@ -.\" $Id: pta_import.1,v 1.8 2020/11/26 19:39:43 freda Exp $ +.\" $Id: pta_import.1,v 1.12 2020/12/03 14:17:39 freda Exp $ .\" .\" Copyright (c) 2020 Freda Bundchen .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: November 26 2020 $ +.Dd $Mdocdate: December 3 2020 $ .Dt PTA_IMPORT 1 .Os .Sh NAME @@ -44,10 +44,14 @@ is exactly one of .It .Cm bbva_usa .It +.Cm capital_one_360 +.It .Cm capital_one_credit .It .Cm chase_credit .It +.Cm etrade_ira +.It .Cm optum_hsa .It .Cm sparkasse_camt @@ -77,6 +81,35 @@ The number in .Xr pta-accounts 5 of the bank or credit card account this CSV file contains entries for. This rule is required in every configuration file. +.It Ic AMOUNT Oo Ar debit_column Oc Ar credit_column +The column numbers in the CSV file containing amounts to be +booked on the debit or credits side of the contra account +.Ar account_number , +respectively. +If +.Ar debit_column +is omitted, amounts preceded by a minus sign or enclosed +in parentheses are booked to the debit side. +.It Ic COSTCENTER Ar costcenter_column +The column number in the CSV file containing the cost center. +Numbering starts from 1. +If this rule is not specified, no cost centers are assigned. +.It Ic DATE Ar date_column date_format +The column number in the CSV file containing the date. +Numbering starts from 1. +The +.Ar date_format +is one of +.Ic MM/DD/YY , +.Ic MM/DD/YYYY , +.Ic YYYY-MM-DD , +or +.Ic DD.MM.YY . +This rule is required in every configuration file. +.It Ic DESCRIPTION Ar descr_column ... +The column numbers in the CSV file to be concatenated to form the +text string for the journal entry. +Numbering starts from 1. .It Ic DELIM Ar delimiter The character used to separate fields. This rule is required in every configuration file. @@ -88,6 +121,11 @@ line verbatim, or cause parsing to fail if it does not .It Ic IGNORE Ar regular_expression Skip all lines in the CSV file matching the .Ar regular_expression . +.It Ic QUANTITY Ar quantity_column +The column number in the CSV file containing the number of stock shares. +Numbering starts from 1. +If this rule is not specified, no information about the number of traded +securities is appended to the text string. .It Ic QUOTE Ar quote Expects that every field starts and ends with the .Ar quote @@ -105,20 +143,28 @@ by delimiters defined in the rule. .El .Sh FILES -.Bl -tag -width Ds -compact +Example configuration files: +.Bl -tag -offset indent -width Ds -compact .It Pa ./import/bbva_usa.txt +.It Pa ./import/capital_one_360.txt .It Pa ./import/capital_one_credit.txt .It Pa ./import/chase_credit.txt -.It Pa ./import/sparkasse_camt.txt +.It Pa ./import/etrade_ira.txt .It Pa ./import/optum_hsa.txt +.It Pa ./import/sparkasse_camt.txt .It Pa ./import/wellsfargo.txt .El .Pp -These files contain the header that the financial institution uses, the -account number from -.Pa ./accounts.txt -used by this account, as well as patterns used to map transactions to -the correct account and booking identifier. +Example CSV files: +.Bl -tag -offset indent -width Ds -compact +.It Pa ./csv/bbva_usa.csv +.It Pa ./csv/capital_one_360.csv +.It Pa ./csv/capital_one_credit.csv +.It Pa ./csv/chase_credit.csv +.It Pa ./csv/etrade_ira.csv +.It Pa ./csv/optum_hsa.csv +.It Pa ./csv/wellsfargo.csv +.El .Sh EXIT STATUS .Ex -std .Sh EXAMPLES @@ -290,19 +336,6 @@ Pattern recognition in the .Pa import/accountname.txt files is under continued development. .It -Only CSV files for these account types are supported: -.Bl -bullet -offset indent -compact -.It -.Cm BBVA USA bank accounts -.It -.Cm Capital One credit cards -.It -.Cm Chase credit cards -.It -.Cm Optum HSA bank accounts -.It -.Cm Sparkasse bank accounts -.It -.Cm Wells Fargo bank accounts -.El +User-defined configuration files are not currently +supported. .El