.iif file PayPunch generates, so you know exactly what lands in
QuickBooks.
File basics
- Format: plain-text, tab-delimited (IIF = Intuit Interchange Format).
- Extension:
.iif, imported into QuickBooks Desktop. - Records: time-tracking records only (
TIMEACT). - Filename:
timesheet_{company-slug}_{YYYYMMDD}_to_{YYYYMMDD}.iif— e.g.timesheet_builders-r-us-construction_20260609_to_20260615.iif.
Layout
The first line is a header that names the columns; every following line is one time record.TIMEACT layout
Columns are separated by tabs, not spaces. The spacing above is just for readability — in
the real file each gap is a single tab character.
Column reference
The overtime split
Regular and overtime hours are written as separateTIMEACT lines for the same employee and
date:
- The regular line uses the employee’s normal payroll item (
PITEM= the item orRegular Pay). - The overtime line uses an OT payroll item —
{payroll item} - OT, orOvertime Paywhen the employee has no QuickBooks item configured — and its note is suffixed with(OT).
What gets included
PayPunch is deliberate about which entries make it into the file. An entry is exported only if it is:1
Approved
The time entry is approved (
approved = true). Pending or rejected entries are skipped.2
Clocked out
The entry has a clock-out time — open/in-progress shifts are excluded.
3
In the selected date range
The clock-in falls between the export’s start and end dates (the date range can’t exceed
one year).
4
Not already exported (by default)
Entries already marked exported are skipped so hours aren’t double-counted. Re-exporting a
period that includes already-exported entries is an explicit opt-in.
Field cleaning
Because the format is tab-delimited, PayPunch sanitizes every text field before writing it: tabs become spaces, line breaks are removed, and surrounding whitespace is trimmed. This keeps a stray character in a company name or note from shifting columns in QuickBooks.Related
- IIF export (admin walkthrough) — how to generate and download the file.
- Approving payroll — getting entries to the approved state that the export requires.