• PostalOne! ® Mail.dat Technical Guide Version 19.0.0 March 2009 PREFACE
  • TABLE OF CONTENTS PostalOne!® Mail.dat Technical Guide 1 Version 19.0.0 1 1Program Overview 9 1Program Overview 9
  • 3Sending Properly Configured Mailing Files 9
  • 4Batch Processing 41 4Batch Processing 41
  • 5Customer Support 53 5Customer Support 53 Appendix A. Mail.dat File Definitions 54 Appendix A. Mail.dat File Definitions 54
  • Appendix C. Status Receipt File Layout 83 Appendix C. Status Receipt File Layout 83
  • Appendix E. Error Messages 90
  • PostalOne!® Mail dat Technical Guide Version 19 0 March 2009 preface




    Download 6.32 Mb.
    bet1/18
    Sana02.10.2020
    Hajmi6.32 Mb.
    #11929
      1   2   3   4   5   6   7   8   9   ...   18



    PostalOne!® Mail.dat Technical Guide

    Version 19.0.0



    March 2009

    PREFACE

    This document is a comprehensive technical guide that outlines steps for exchanging electronic data with the PostalOne!® system using the Mail.dat® file format. The intended audience is business mailers who create/use mailing data in the preparation and/or production of business mail and who also want to send that electronic mailing data to the PostalOne! system for the purpose of conducting business electronically in lieu of the hardcopy forms and processes that were traditionally used in business mail acceptance. Although this guide provides an overview of the PostalOne! system, the intended recipient of this document is the person or team that will make necessary technical infrastructure preparations/alterations and conduct testing to ensure Mail.dat electronic data is consistently and reliably sent to the PostalOne! system. This document only discusses this form of electronic data exchange.

    This guide is organized as follows: Chapters 1 and 2 provide an overview of the PostalOne! program benefits, the basic requirements for participation in the program, and how to apply for participation. Chapters 3 through 4 provide detailed technical information about the PostalOne! application. Chapter 5 provides information on who to contact for help. Appendices A, B, C, and D contain technical information about the electronic data used by or returned by the system. Appendix E contains error messages that you may need to reference.

    On behalf of the PostalOne! team, we would like to welcome you into the program. You will be joining many other business mailers who are successfully using the PostalOne! system to improve the collaboration with the U.S. Postal Service®. We welcome your feedback and look forward to working with you.

    PostalOne!, USPS, U.S. Postal Service, United States Postal Service, First-Class Mail, Standard Mail, and Priority Mail are registered trademarks, and Postal Service is a trademark of the United States Postal Service. IDEAlliance and Mail.dat are registered trademarks of the International Digital Enterprise Alliance, Inc. (IDEAlliance). Sun, Sun Microsystems, and Java are trademarks or registered trademarks of Sun Microsystems, Inc. Microsoft, Microsoft Windows, and Microsoft Internet Explorer are registered trademarks of Microsoft Corporation. All other trademarks used are the property of their respective owners.



    TABLE OF CONTENTS

    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


    LIST OF FIGURES


    LIST OF TABLES


    The PostalOne!® system is an electronic suite of services being developed for business mailers by the United States Postal Service® to dramatically improve the mailing process. The system takes advantage of the advances in technology and leverages them to significantly improve and simplify the mailing experience.

    One of the ways the system enables customers to electronically send detailed information is using the mailing industry's standardized Mail.dat® format. Customers using the system no longer have to complete manual postage statements because they can be automatically generated by the PostalOne! system. In fact, much of the acceptance and verification process has been automated, enabling a faster and more accurate method of accepting, assessing, and finalizing postage statements. The electronic documentation provided through the system means you no longer have to physically bring hardcopy presort documentation to the acceptance unit or retain it for storage.

    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.

    As an added benefit, the Transportation Management function of the PostalOne! system provides select users with the ability to make surface and air transportation assignments and route mail in the mailer's own plant. This capability is a great benefit to many of the larger First-Class Mail® customers because they can track mailings more accurately by knowing the detailed routing. This capability includes, but is not limited to, information found in Mail.dat files.



    1. Download 6.32 Mb.
      1   2   3   4   5   6   7   8   9   ...   18




    Download 6.32 Mb.

    Bosh sahifa
    Aloqalar

        Bosh sahifa



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

    Download 6.32 Mb.