pta/pta_import.1 - diff

Return to pta_import.1 CVS log

Up to [cvsweb.bsd.lv] / pta

Diff for /pta/pta_import.1 between version 1.7 and 1.12

version 1.7, 2020/11/25 15:04:25

version 1.12, 2020/12/03 14:17:39

Line 44 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

Line 56 is exactly one of

Line 60 is exactly one of

.El

.Pp

and corresponds to an existing

.Pa import_ Ns Ar accountname Ns Pa .txt

.Pa ./import/ Ns Ar accountname Ns Pa .txt

configuration file in the current directory.

configuration file.

.Ss Configuration file format

Each file of the form

Each configuration file contains rules

.Pa import_ Ns Ar accountname Ns Pa .txt

in the current directory is a configuration file that contains rules

used to import transactions from a financial institution.

Like all

.Xr pta 1

Line 79 The number in

Line 81 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.

.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 ,

.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.

Line 90 line verbatim, or cause parsing to fail if it does not

Line 121 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

Line 107 by delimiters defined in the

Line 143 by delimiters defined in the

rule.

.El

.Sh FILES

.Bl -tag -width Ds -compact

Example configuration files:

.It Pa ./import_bbva_usa.txt

.Bl -tag -offset indent -width Ds -compact

.It Pa ./import_capital_one_credit.txt

.It Pa ./import/bbva_usa.txt

.It Pa ./import_chase_credit.txt

.It Pa ./import/capital_one_360.txt

.It Pa ./import_sparkasse_camt.txt

.It Pa ./import/capital_one_credit.txt

.It Pa ./import_optum_hsa.txt

.It Pa ./import/chase_credit.txt

.It Pa ./import_wellsfargo.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

Example CSV files:

account number from

.Bl -tag -offset indent -width Ds -compact

.Pa ./accounts.txt

.It Pa ./csv/bbva_usa.csv

used by this account, as well as patterns used to map transactions to

.It Pa ./csv/capital_one_360.csv

the correct account and booking identifier.

.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

Line 153 Suppose

Line 197 Suppose

.Dl ,,,Automotive,,, 1111 AUTO

.Pp

is a sample entry in the

.Pa ./import_chase_credit.txt

.Pa ./import/chase_credit.txt

file which uses headers of the form

.Pp

.Dl Transaction Date,Post Date,Description,Category,Type,Amount

Line 178 file contains

Line 222 file contains

.Dl "10/26/2020,10/26/2020,example.com*asldfkj,Shopping,Sale,-17.07"

.Pp

and

.Pa ./import_chase_credit.txt

.Pa ./import/chase_credit.txt

contains

.Bd -literal -offset Ds

ACCOUNT 3234

Line 233 Transaction Date,Post Date,Description,Category,Type,A

Line 277 Transaction Date,Post Date,Description,Category,Type,A

.Ed

.Pp

and

.Pa ./import_chase_credit.txt

.Pa ./import/chase_credit.txt

is given by

.Bd -literal

# Chase credit card header is

Line 289 has the following limitations:

Line 333 has the following limitations:

.Bl -dash

.It

Pattern recognition in the

.Pa import_accountname.txt

.Pa import/accountname.txt

files is under continued development.

.It

Only CSV files for these account types are supported:

User-defined configuration files are not currently

.Bl -bullet -offset indent -compact

supported.

.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

CVSweb