Header Record Specifications for FTP files in TrackMyMail

Header record specifications for TrackMyMail jobs created via FTP
Products affected: TrackMyMail™

The file header enables TrackMyMail users to create jobs, encode Intelligent Mail barcodes (IMbs), and upload their jobs to TrackMyMail in a more efficient, automated, and integrated manner.

File Header Record (Job / Mailing Information)

ColumnTypeMax SizeRequired/Optional
Record TypeChar1Required
Value must be "H" (Header)
VersionNbrChar5Required
Value must be "4.0"
MasterUserIDChar50Optional
MasterPasswordChar50Optional
ResellerVendorUserIDChar50Optional
ResellerVendorPasswordChar50Optional
ClientUserIDChar50Required
ClientPasswordChar50Password
JobIDChar50Required - Dept. Name
JobTitleChar50Required - Mailing Name
VersionIDChar50Optional
MailDateChar10Required (YYYY/MM/DD)
MailerIDChar6Optional
Registration of MID via the IV Data Delegation Request form required with both TMM and USPS if using client's own MID
ServiceTypeIDChar3Required
UploadTypeChar1Required
N = New, Initial Upload
A = Append to Existing Job
R = Replace/Reload Data on Previous Job
FileNeedsEncodingChar1Required
Value should be "N" unless instructed otherwise
TotalPiecesMailedNumeric8Optional
TrackedPiecesMailedNumeric8Optional
TargetInHomeDateStartDate10Optional
(YYYY/MM/DD)
TargetInHomeDateToDate10Optional
(YYYY/MM/DD)
ReturnedPostnetChar11Optional
ReceiveDailyNotificationsChar1Optional
'Y' or 'N'
Default: 'N'
ReceiveCriticalScansChar1Optional
'Y' or 'N'
Default: 'N'
ReceiveLateMailChar1Optional
'Y' or 'N'
Default: 'N'
LateMailThresholdNumeric3Optional
NotificationEmailChar255Optional
UpdateProRequestedChar1Optional
UpdateProAuthorizationChar50Required IF UpdatePro Requested
UpdateProFileFormatChar3Optional
CSV or XLS
UpdateProEmailChar255Optional (e-mail address)
ConfirmationEmailChar255Optional (e-mail address)
TMMJobIDInteger9Optional for previously-created jobs
TMMSequenceNumberInteger4Optional for previously-created jobs
Type of TrackingChar1Required
O - Outbound Only
I - Inbound Only
R - Round Trip
TrackItBack RequestedChar1Optional
'Y' or 'N'
Type of Reply Mail (Service Type ID)Char3Required if TrackItBack Requested
050 or 030 - Courtesy Reply
052 or 032 - Business Reply
TrackItBack Start DateDate10Required if TIB Requested
TrackItBack End DateDate10Required if TIB Requested
Receive Daily Suppression FileChar1Required if TIB Requested
'Y' or 'N'
Daily Suppression File FormatChar3Required if TIB Requested
CSV or XLS
Daily Suppression to be SentChar1Required if 'Receive Daily Suppression File' is 'Y'
D - Daily
W - Weekly
M - Monthly
O - Only Once
Blank - None
Daily Suppression E-mailChar255Required if 'Receive Daily Suppression File' is 'Y'
If more than one e-mail address is present, separate the addresses by commas
PTD Job IDInteger9Value should be '0' unless instructed otherwise
UpdatePro to be SentChar1Optional
D - Daily
W - Weekly
M - Monthly
O - Once
Blank - None

Sample Header

H,4.0,,,,,clientuser,clientpassword,jobid,jobtitle,,2020/07/30,,271,N,N,,,,,,Y,Y,N,,emailaddr@forreports,N,,,,emailaddr@forconfirmation,,,O,N,,,,,,,,0,

UPDATED: November 22, 2022