PostalOne!® Mail dat Technical Guide Version 19 0 March 2009 preface

PostalOne!® Mail.dat Technical Guide 1
Version 19.0.0 1
1Program Overview 9
1Program Overview 9
2Applying for Participation 9
2Applying for Participation 9
3Sending Properly Configured Mailing Files 9
3Sending Properly Configured Mailing Files 9
3.1Key Technical Requirements 10
3.1.1Internet Connection 10
3.1.2Formatted Mailing Files 10
3.1.4Methods of Transferring Files (Manual and Batch) 11
3.2Technical/Operational Prerequisites 11
3.2.1Hardware 12
3.2.2Software 12
3.2.3Network 13
3.2.4Infrastructure 13
3.2.5Information/Manuals 13
3.2.6User License Code 13
3.2.7Security Certificates 13
3.2.8Collaboration 13
3.3Configuring Mailing Files for Processing 14
3.3.1Required Files and Fields 14
3.3.2Postage Statement Generation, Rejection, and Conflict Resolution 14
3.3.2.1Key Fields 14
3.3.2.2Segment Rejection 16
3.3.2.3Issue Date Validation 17
3.3.2.4Periodicals Rate Calculations 17
3.3.2.5Bound Printed Matter Validation Issues 17
3.3.2.6Unsupported Mailing Cases 18
3.3.3Postage Payment 18
3.3.3.1Permit Roles 18
3.3.3.2Additional Postage 19
3.3.4Typical File Formatting Problems 20
3.3.5Sending Job Updates 21
3.3.5.1File/Record Level Status 23
3.3.5.2Rules for Sending Updates 23
3.3.5.3Commands 24
3.3.6File Processing Overview 25
3.4Transferring Files 26
3.4.1Validating Files 26
3.4.1.1Validation Constraints 27
3.4.1.2MLOCR Validation Constraints 33
3.4.1.3Relationship Constraints Description 34
3.4.1.4Validation Log Errors 38
3.4.2Performing the File Transfer 38
3.4.3Adjusting Memory Limits for Manual Transfers 40
3.4.3.1Verifying Java Installation 40
3.4.3.2Verifying Memory 40
3.4.3.3Increasing Memory Limits for Java 1.4.2_x 40
3.4.3.4Increasing JAVA Memory Limits for Java 1.5.x or 1.6 41
4Batch Processing 41
4Batch Processing 41
4.1Prerequisites for Batch Processing 42
4.1.1Hardware 42
4.1.2Software 42
4.1.3Network 43
4.1.4Downloading and Configuring the Windows Batch Processor 43
4.1.5Downloading and Configuring the UNIX Batch Processor 46
4.1.6Digital Certificates/Security 48
4.1.6.1Creating a Keystore 49
4.1.6.2Creating Certificate Signing Requests 50
4.1.6.3Submitting Your Certificate Signing Request 50
4.1.6.4Adding a Signed Certificate to a Keystore 50
4.1.6.5Enabling Encryption on the Batch Processor Client 51
4.1.6.6Testing Your Signed Certificate 51
4.1.6.7Testing Batch Processor Setup 52
4.1.7Scheduling Batch Jobs (Running the Batch Processor) 52
4.1.8Adjusting Memory Limits for Batch Transfers 52
4.2File Transfer Error Codes and Messages 52
5Customer Support 53
5Customer Support 53
Appendix A. Mail.dat File Definitions 54
Appendix A. Mail.dat File Definitions 54
Appendix B. Mail.dat Field Validation 57
Appendix B. Mail.dat Field Validation 57
Header Record 57
Segment Record 59
Mail Piece Unit 61
Mail Piece Unit – Class Values 62
Flats Machinability Values for Periodicals Mailings 62
MPU/C Relationship Record 63
Mailer Postage Account Record 63
Component Record 64
Issue Date Values 65
Container Summary Record 66
Container Type Values 69
Container Level Values 70
Entry Point for Entry Discount – Container Entry Values 70
International Container Label Record 71
Container Quantity Record 72
Package Quantity Record 73
Package Level Values 74
Walk Sequence Record 74
Seed Name Record 75
Package Label Record 75
IJ/C Relationship Record 75
Piece Detail Record 76
Special Fees/Charges Record 76
Manifest Individual Record 77
Manifest Summary Record 78
Postage Adjustment Record 79
Actual Tray File Record 80
Actual Pallet File Record 80
Information Access Key File Record 80
Piece Detail Record (XML version) 81
Appendix C. Status Receipt File Layout 83
Appendix C. Status Receipt File Layout 83
C-1 Status Receipt File Content 83
C-2 Record Types and Record Format 83
Appendix D. Postage Statement Receipt File Layout 89
Appendix D. Postage Statement Receipt File Layout 89
Appendix E. Error Messages 90
Appendix E. Error Messages 90
Issue Resolution 90
Processing Order 90
Mail.dat Client 91
Upload Server 98
Mail.dat Package 106
Wizard Web Service 112
Customers can download the estimated postage, view individual postage statements within a mailing, see a running total of postage statement activity, and view the reconciliation of the information at the end of a mailing information exchange process (mailing job). By automating and incorporating payment processing into the PostalOne! system, payments for mailing jobs can be electronically processed.