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.6 and 1.9

version 1.6, 2020/11/23 18:46:05

version 1.9, 2020/11/28 15:10:36

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

used to import transactions from a financial institution.

in the current directory is a configuration file used to

import transactions from a financial institution.

Like all

.Xr pta 1

input files, it is an

Line 72 as the field delimiter and using the hash character

Line 74 as the field delimiter and using the hash character

.Pq Sq #

in the first column to mark lines as ignored.

.Pp

Each file contains one line beginning with

The rules are as follows:

.Qq ACCOUNT

.Bl -tag -width Ds

and is followed by whitespace and then an account number.

.It Ic ACCOUNT Ar csv_account_number

.Pp

The number in

Each file contains lines of the form

.Xr pta-accounts 5

.Pp

of the bank or credit card account this CSV file contains entries for.

.Ar selector account_number booking_identifier

This rule is required in every configuration file.

.Pp

.It Ic DELIM Ar delimiter

The

The character used to separate fields.

This rule is required in every configuration file.

Most financial institutions use commas but some use semicolons.

.It Ic HEADER Ar header

Skip the first line of the CSV file if it matches the

.Ar header

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 QUOTE Ar quote

Expects that every field starts and ends with the

.Ar quote

character.

.It Ar selector account_number booking_identifier

Lines in the CSV file that match the

.Ar selector

is a string consisting of regular expressions

are associated with the contra account

separated by commas.

Its fields correspond to header fields in the financial

institution's CSV file and is used to classify transactions

that match the search pattern.

The first selector that

matches a transaction wins.

.Pp

The

.Ar account_number

corresponds to an account number in

and are assigned the

.Pa ./accounts.txt .

.Ar booking_identifier .

The

The selector is a string consisting of regular expressions separated

.Ar booking_identifier

by delimiters defined in the

is defined by the user to classify

.Ic DELIM

the transaction.

rule.

.El

.Sh FILES

.Bl -tag -width Ds -compact

.It Pa ./import_bbva_usa.txt

.It Pa ./import/bbva_usa.txt

.It Pa ./import_capital_one_credit.txt

.It Pa ./import/capital_one_360.txt

.It Pa ./import_chase_credit.txt

.It Pa ./import/capital_one_credit.txt

.It Pa ./import_sparkasse_camt.txt

.It Pa ./import/chase_credit.txt

.It Pa ./import_optum_hsa.txt

.It Pa ./import/etrade_ira.txt

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

Line 145 Suppose

Line 157 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 170 file contains

Line 182 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 225 Transaction Date,Post Date,Description,Category,Type,A

Line 237 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 281 has the following limitations:

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