Permalink
2e3ec99 Feb 14, 2018
1 contributor

Users who have contributed to this file

414 lines (351 sloc) 12.3 KB
QIF file format
---------------
The QIF is an old and rather broken file format defined by Intuit
for exporting Quicken data. It is 'broken' because the format
is ambiguous in many places, non-standard between different releases
and applications, and even varies subtly from country to country (in
particular, the way dates and amounts are represented), and fails
to define important data (such as the currency denomination, or the
exchange rates when transferring between accounts marked in different
currencies). Importing a QIF file can require significant manual
intervention by the user in order to get the data straight.
Extensions
----------
TEF -- Time and Expense Format (see below)
QFX -- also known as 'Web Connect' -- very similar, and is the
'new' standard for on-line bank statement downloads.
(??? or is it just 'ofx in a file' ???)
Type of account identifiers
----------------------------
!Type:Bank Bank account
!Type:Bill ??? (bill presentment ???)
!Type:Cash Cash account
!Type:CCard Credit Card account
!Type:Invoice ??? (invoice presentment ???)
!Type:Invst Investment account
!Type:Oth A Asset account
!Type:Oth S Asset account (German)
!Type:Oth L Liability account
!Type:Tax ???
!Account Account list or which account applies to following
transactions
!Type:Cat Category list
!Type:Class Class list
!Type:Memorized Memorized transaction list
Note that !Account is used both to be a header for account information,
and to be a header for a list of transactions.
Also note that international versions of Quicken and MS Money often
translate the Type: tags into the local language. But not always.
Account Information Format
--------------------------
The below typically follow an !Account identifier, and provide account
data.
Letter Definition
N Name
T Type of account
D Description
L Credit limit (only for credit card accounts)
/ Statement balance date
$ Statement balance amount
^ End of entry
Category Information Format
---------------------------
N Category name:subcategory name
D Description
T Tax related if included, not tax related if omitted
I Income category
E Expense category (if category type is unspecified,
assumes expense type)
B Budget amount (optional, only appears in a Budget QIF file)
R Tax schedule information
^ End of entry
Class Information Format
------------------------
N Class name
D Description
^ End of entry
Memorized Transaction Format
----------------------------
KC Check transaction
KD Deposit transaction
KP Payment transaction
KI Investment transaction
KE Electronic payee transaction
T Amount
C Cleared status
P Payee
M Memo
A Address
L Category or Transfer/Class
S Category/class in split
E Memo in split
$ Dollar amount of split
1 Amortization: First payment date
2 Amortization: Total years for loan
3 Amortization: Number of payments already made
4 Amortization: Number of periods per year
5 Amortization: Interest rate
6 Amortization: Current loan balance
7 Amortization: Original loan amount
^ End of entry
Note that the K* entries must be the *last* entries in the transaction.
All fields are optional. If this is an amortization record, then all
seven amortization fields much be present.
Investment transaction format
-----------------------------
Letter Definition
D Date (optional)
N Action
Y Security
I Price
Q Quantity (# of shares or split ratio)
C Cleared status
P first line text for transfers/reminders
M Memo
O Commission
L Account for transfer
(category/class or transfer/class)
(For MiscIncX or MiscExpX actions, this will be
category/class|transfer/class or |transfer/class)
T Amount of transaction
U Amount of transaction (higher possible value than T)
$ Amount transferred
^ End of entry
Note that numbers for investment transactions are positive in most
cases. The importation process automatically takes care of negating
the values for Actions that move funds out of an account (for example:
sales, expenses and transfers).
Be aware that GnuCash's file format stores the share quantity and the
total value of the transaction. Prices are not stored.
Non-investment transaction format
---------------------------------
Letter Definition
D Date
T Amount
U Transaction amount (higher possible value than T)
C Cleared status
N Number (check or reference number)
P Payee/description
M Memo
A Address (up to 5 lines; 6th line is an optional message)
L Category (category/class or transfer/class)
S Category in split (category/class or transfer/class)
E Memo in split
$ Dollar amount of split
% Percentage of split if percentages are used
F Reimbursable business expense flag
X Small Business extensions
^ End of entry
Note that S,E and $ lines are repeated as needed for splits.
Time and Expense Format
-----------------------
The following QIF extension added by Iambic Software
to handle time and expense tracking. This is used in particular
by handhelds (Palm and WinCE). TEF is claimed to be a superset
of the QIF format.
TEF Files begin with the header:
#TEF VERSION X.YYY
Documented below is version 1.01
# Any line beginning with # is a comment and not parsed
B City
F Reported
H Report #
J Attendees
K Reimbursable
R Receipt
U Begin Odometer
V End Odometer
W Private
X Exchange Rate
Z User
1 Client
2 Project
3 Activity
4 Expense Type
5 Account
6 Vehicle
7 Currency
8 Task
9 (not used)
0 (not used)
@ Billing Code
! Tax Amount
% Uses Splits
( SalesTaxRate1
) SalesTaxRate2
= Flat Fee Amount
\ Status1
/ Status2
& Status3
< Status4
> Status5
? Keyword: TIME, EXPENSE, CLIENT, PROJECT, ACTIVITY, TYPE,
TASK, VEHICLE, PAYEE, CURRENCY. If absent, entry is
assumed EXPENSE type as compatible with QIF
* Duration hh:mm:ss
+ Timer On
[ Start time
] End Time
{ TimerLastStoppedAt
} (not used)
| Notes
When importing type CLIENT, PROJECT, ACTIVITY, TYPE, TASK, VEHICLE,
PAYEE, CURRENCY the following are used:
N Name
C Code
R Rate
L Link
W Private
=====================================================================
General Notes
=====================================================================
Dates
-----
Dates in US QIF files are usually in the format MM/DD/YY, although
four-digit years are not uncommon. Dates sometimes occur without the
slash separator, or using other separators in place of the slash,
commonly '-' and '.'. US Quicken seems to be using the ' to indicate
post-2000 two-digit years (such as 01/01'00 for Jan 1 2000). Some
banks appear to be using a completely undifferentiated numeric string
formateed YYYYMMDD in downloaded QIF files.
European QIF files may have dates in the DD/MM/YY format.
Monetary Amounts
----------------
These typically occur in either US or European format:
10,000.00 Ten Thousand Dollars (US format)
10.000,00 Ten Thousand Francs (European format)
An apostrophe is also used in some cases:
10'000.00 Ten Thousand Dollars (Quicken 4)
10'000,00 Ten Thousand Francs (unconfirmed)
Within a given QIF file, the usage of a particular numeric format
appears to be consistent within a particular field but may be
different from one field to another. For example, the Share Amount
field can be in European format but the Split Amount in US. No
radix-point is required and no limit on decimal places is evident, so
it's possible to see the number "1,000" meaning "1 franc per share"
"1,000" meaning "one thousand shares" in the same transaction (!).
Investment Actions
------------------
The N line of investment transactions specifies the "action" of the
transaction. Although not a complete list, possible values include
the following:
QIF N Line Notes
============ =====
Aktab Same as ShrsOut.
AktSplit Same as StkSplit.
Aktzu Same as ShrsIn.
Buy Buy shares.
BuyX Buy shares. Used with an L line.
Cash Miscellaneous cash transaction. Used with an L line.
CGMid Mid-term capital gains.
CGMidX Mid-term capital gains. For use with an L line.
CGLong Long-term capital gains.
CGLongX Long-term capital gains. For use with an L line.
CGShort Short-term capital gains.
CGShortX Short-term capital gains. For use with an L line.
ContribX Same as XIn. Used for tax-advantaged accounts.
CvrShrt Buy shares to cover a short sale.
CvrShrtX Buy shares to cover a short sale. Used with an L line.
Div Dividend received.
DivX Dividend received. For use with an L line.
Errinerg Same as Reminder.
Exercise Exercise an option.
ExercisX Exercise an option. For use with an L line.
Expire Mark an option as expired. (Uses D, N, Y & M lines)
Grant Receive a grant of stock options.
Int Same as IntInc.
IntX Same as IntIncX.
IntInc Interest received.
IntIncX Interest received. For use with an L line.
K.gewsp Same as CGShort. (German)
K.gewspX Same as CGShortX. (German)
Kapgew Same as CGLong. Kapitalgewinnsteuer.(German)
KapgewX Same as CGLongX. Kapitalgewinnsteuer. (German)
Kauf Same as Buy. (German)
KaufX Same as BuyX. (German)
MargInt Margin interest paid.
MargIntX Margin interest paid. For use with an L line.
MiscExp Miscellaneous expense.
MiscExpX Miscellaneous expense. For use with an L line.
MiscInc Miscellaneous income.
MiscIncX Miscellaneous income. For use with an L line.
ReinvDiv Reinvested dividend.
ReinvInt Reinvested interest.
ReinvLG Reinvested long-term capital gains.
Reinvkur Same as ReinvLG.
Reinvksp Same as ReinvSh.
ReinvMd Reinvested mid-term capital gains.
ReinvSG Same as ReinvSh.
ReinvSh Reinvested short-term capital gains.
Reinvzin Same as ReinvDiv.
Reminder Reminder. (Uses D, N, C & M lines)
RtrnCap Return of capital.
RtrnCapX Return of capital. For use with an L line.
Sell Sell shares.
SellX Sell shares. For use with an L line.
ShtSell Short sale.
ShrsIn Deposit shares.
ShrsOut Withdraw shares.
StkSplit Stock split.
Verkauf Same as Sell. (German)
VerkaufX Same as SellX. (German)
Vest Mark options as vested. (Uses N, Y, Q, C & M lines)
WithDrwX Same as XOut. Used for tax-advantaged accounts.
XIn Transfer cash from another account.
XOut Transfer cash to another account.
Category/Transfer/Class line
----------------------------
The "L" line of most transactions specifies the category, transfer
account, and class (if any) of the transaction. Square brackets
surrounding the contents mean the transaction is a transfer to the
named account. A forward slash separates the category/account from
the class. So overall, the format is one of the following:
LCategory of transaction
L[Transfer account]
LCategory of transaction/Class of transaction
L[Transfer account]/Class of transaction
In stock transactions, if the 'N' field (action) is MiscIncX or
MiscExpX, there can be *two* account/class pairs on the L line, with
the second guaranteed to be a transfer. I believe they are
separated by a '|', like so:
D01/01/2000
NMiscExpX
T1000.00
Lexpense category/expense class|[Transfer account]/transfer class
Cleared Status line
-------------------
The "C" line of specifies the cleared status. The second character
in the line, if present, may be any of:
* Cleared
c Cleared
X Reconciled
R Reconciled
? Budgeted
! Budgeted
=====================================================================
Sample Files
=====================================================================
Investment Transactions
-----------------------
!Account
NAssets:Investments:Mutual Fund
TInvst
^
!Type:Invst
D10/30/2006
Q0.9
T500
PPurchase
NBuyX
L[Assets:Investments:Mutual Fund:Cash]
YFOO
^
!Type:Invst
D11/28/2006
Q0.897
T100
PSale
NSellX
L[Assets:Investments:Mutual Fund:Cash]
YFOO
^