Appendix B 

PMEM Electronic File Format Version 1.3 Layouts

This appendix contains the file layout for the Header Record, Detail Record 1, and Detail Record 2 of the electronic files.

The format fields are variable length and comma-separated. Field formats are described in standard COBOL terms. “X” indicates a field that can contain alphanumeric characters. “9” indicates a field that can contain only numbers. The numbers in parentheses following the “X” or “9” indicate the maximum size of the field. A numeric field with a “V” in the format description indicates an implied decimal point. For example, the Weight Field in Detail Record 1, positions 046-054, is defined as “9(5)V9(4).” A weight of 7 pounds should be entered as “000070000.”

Important: You may choose to use only the fields that are required for PMEM as annotated in the Record Position column for “*PME*” (domestic Priority Mail Express) and “PMEOD” (Priority Mail Express Open and Distribute). The fields that are not applicable for PMEM are shaded in gray.

If you choose not to use the full layout, you must include the optional fields (those shaded in gray) providing fillers composed of spaces. The complete record lengths cannot vary — they must be the exact size shown in the record formats (i.e. Header Record is 130 bytes, Detail 1 is 200 bytes, and Detail 2 is 352 bytes). No warning or error messages will be used for fields shaded in gray.

For samples of transmission reports, common error messages, and a typical extract file, see Appendix G. Also included in Appendix G is a list of edit checks.

Chapter 3 shows the location of the Mailer ID in the Header Record (the Electronic File Number field, positions 004-025) and in Detail Record 1 (PIC field, positions 005-026, and Client Mailer ID field, positions 122-130).

Electronic File Format Version 1.3 - Header Record

 

HEADER RECORD (130 bytes)

ELECTRONIC File Record Formats Version 1.3

Record Positions

Field Name

Format (Size)

Description

Example

Content Rules and Limitations

001–002
*EM*

Electronic File Header Record ID

X(2)

A 2 character system constant that identifies an electronic file header record.

H1

‘H1’ is required.

003
*EM*

Electronic File Type

9(1)

‘3’ - Postage & Tracking File

3

“3” is required for Priority Mail Express.

004–025
*EM*

Electronic File Number

X(22)

Unique number assigned to identify the electronic file:

2 digits – Reserved for Application Identifier in GS1-128.

9 digits – Mailer ID must be that of the company transmitting the file.

8 digits - Fixed length of 8 digits. Right justified with leading zeros.

1 digit - MOD 10 or 11 check digit

For 3152-E where using symbology USS-128 or USS-39:

50901233312000000018

For 3152-E only: when using symbology GS1-128:

9150901233312000000018

NOTE: The Mailer ID must be that of the company transmitting the file.

Data must match the structure used for the barcode symbology of the 3152-E.

The Electronic File Number must be unique for 180 days from date of first use. Fixed length sequential number must be right justified with a total of 8 digits with leading zeroes

026–033
*EM*

Date of Mailing

9(8)

Date mail is tendered to USPS.

1998-01-27
Entered as:
19980127

YYYY-MM-DD

Date must be valid. Numeric values (0–9) only.

034–039
*EM*

Time of Mailing

9(6)

Time mail is tendered to USPS (estimated).

13:15:00
Entered as:
131500

HH:MM:SS

Military format and time must be valid. Numeric values (0-9) only.

040–044
*EM*

Entry Facility

9(5)

5-digit ZIP Code of postal facility where the mail is tendered.

22201

Numeric values only (0-9).

045–054
*EM*

Payment Account Number

9(10)

USPS account number. This mailing will be paid from one of the following account types:

USPS Corporate Account Number

Federal Agency Number

0000345678

(USPSCA)

0000000326

(Federal Agency)

0032612345 (Federal Agency with Control and Sub-Control numbers)

Leading zeroes required. Numeric values (0-9) only.

This field mandatory for USPSCA and Federal Agency. Federal Agency number should include Control and Sub-Control (where applicable).

055–056
*EM*

Method of Payment

9(2)

Payment system used for mailing:

‘01’ - Permit System

‘02’ - USPS Corporate Account

‘03’ - Federal Agency

‘04’ - Other

02

For PMEM must be 02.

057–061

Post Office of Account ZIP Code

9(5)

5-digit ZIP Code of post office issuing permit number, meter license, or pre-canceled stamp.

22042

Numeric values (0-9) only. Default zeroes. Not applicable for Priority Mail Express.

062–073

DSAS Confirmation Number

X(12)

Confirmation number received when making a scheduled appointment for mail drop at a postal facility.

AB1234567856

Alphanumeric values (A-Z, 0-9) only. No embedded spaces.

For Drop Shipments.

Default is spaces.

074
*EM*

Pickup Requested Indicator

X(1)

Indicator if mail is picked up by the USPS:

‘Y’ = Pickup1

SPACE = No Pickup

Y

‘Y’ = Pickup

SPACE = No Pickup

075–077
*EM*

USPS Electronic File Version Number

9(3)
Defined as: 9(2)V9(1)

USPS Electronic File Version Number.

01.3
Entered as:
013

Provided by USPS.

078–080
*EM*

Developer ID Code

X(3)

A unique code that identifies the developer of the electronic file software.

123

Unique code provided by USPS.

081–088
*EM*

Product Version Number

X(8)

Developer’s software product version number.

5.02.3A

A unique number the developer designates. Identifies product version of the electronic file.

089–097
*EM*

File Record Count

9(9)

Total number of all records in this file. Count to include Header and all Detail records.

1,517
Entered as:
000001517

Leading zeros required. Numeric values (0–9) only.

098–1302
*EM*

Filler

X(33)

Filler for future use.

n/a

Must be spaces.


Electronic File Format Version 1.3 - Detail Record 1

 

DETAIL RECORD 1 (200 bytes)

ELECTRONIC File Record Formats Version 1.3

Record Positions

Field Name

Format (Size)

Description

Example

Content Rules and Limitations

001–002
*EM*

Electronic File Detail Record ID

X(2)

A 2-character system constant that identifies an electronic file detail record.

D1

‘D1’ is required.

003–004
*EM*

Class of Mail

X(2)

A 2-character code for Class of Mail. Refer to Class of Mail table, Appendix C, Table 1.

EX

USPS defined values.

Valid value is “EX”.

005–026
*EM*

Package Identification Code (PIC)

X(22)

Barcoded label number used to track the package.

2 alphas – as assigned

8 digits - sequential number

1 digit - check digit

2 alphas - US

EA123456782US

For PMEOD only:
DB123456781US

The alpha prefix shown on PS Form 3152-E must be used (EA – EZ) — the alpha prefix “DB” is used only for PMEOD.

The 8-digit sequential number must be from the range of label numbers provided on PS Form 3152-E. The number must remain unique for 180 days from date of first use.

Refer to Appendix J for barcode specifications.

For Priority Mail Express service, use 13-digit label numbers; left justify with trailing spaces.

027–031
*EM*

Destination ZIP Code

9(5)

Destination 5-digit ZIP Code for Domestic.

22201

Left justified. Numeric values (0–9) only.

032–035
*EM*

*PMEOD*

Destination ZIP+4

X(4)

Destination ZIP+4 add-on of domestic ZIP Code.

2804

Numeric values only.

Required for PMEOD.

Default spaces if not available.

036–037

Country Code

X(2)

Two character standardized
2-digit ISO International country code.

Mandatory for International pieces.

JP

Mandatory for International. Default is spaces for Domestic.

038–044
*EM*

Postage

9(7)
Defined as:
9(4)V9(3)

Postage (excluding Extra Service fees and surcharges) less any workshare discount.

For pieces subject to both a piece and pound price, only enter piece price.

$5.69
Entered as:
0005690

Leading zeroes required. Numeric values (0–9) only. In unit of dollars and rounded to the nearest cent.

045
*EM*

Unit of Measure Code

9(1)

Unit of measurement for mailpiece:

‘1’ - lbs.

‘2’ - oz.

‘3’ - kilos

1

Field must contain a USPS defined valid code.

046–054
*EM*

Weight

9(9)
Defined as:
9(5)V9(4)

Mailpiece weight. In unit of measure and significant to 4 decimal positions.

14.3250 lbs.
Entered as
000143250

Leading zeroes required. Numeric values (0–9) only.

055

*PMEOD*

Processing Category

X(1)

‘O’ – Open and Distribute

‘0’ - Cards

‘1’ - Letters

‘2’ - Flats

‘3’ - Machinable Parcels

‘4’ - Irregular Parcels

‘5’ - Outside/Nonmachinable

Space fill.

Default is spaces for non-applicable products.

056

*PMEOD*

Destination Rate Indicator

X(1)

‘D’ - Destination Delivery Unit

‘S’ - Destination SCF

‘B’ - Destination NDC

‘A’ – Destination ADC

‘F’ – Destination ASF

‘E’ - Inter-NDC Parcel Post

‘T’ - Intra-NDC Parcel Post

‘N’ - None

N

Default is ‘N’ for non-applicable products.

057–058
*EM*

*PMEOD*

Rate Indicator

X(2)

Refer to Rate Indicator Appendix C, Table 2 for valid values.

PA

“PA” required for PMEOD.

059–060

*EM*

Zone

X(2)

Individual mailpiece zone. Valid zones are:

‘LC’ - Local Zone

‘01’ through ‘08’

Zone 3
Entered as:
03

Local Zone
Entered as:
LC

Default entered as 00

Mandatory for products with prices based on zones. Alphanumeric values (LC,
1-8) required. Leading zeroes required if numeric.

Not required for Post Office to Addressee Flat Rate envelope– default is zeroes.

061
*EM*

PO Box Indicator

X(1)

‘Y’ = Priority Mail Express addressed to a PO Box.

Y

Mandatory for Priority Mail Express.

Default value is ‘N’.

062

*EM*

Waiver of Signature

X(1)

‘Y’ = Mailer requests Waiver of Signature on delivery for Priority Mail Express.

Y

Mandatory for Priority Mail Express.

Default value is ‘Y’.

Required: Print ‘WAIVER OF SIGNATURE’ on label when value set to ‘Y’.

Print ‘SIGNATURE REQUIRED’ on label when value set to ‘N’.

063
*EM*

*PMEOD*

No Weekend/
Holiday Delivery

X(1)

1 = Normal (default) = regular delivery for Priority Mail Express.

2 = NO WEEKEND delivery

3 = NO HOLIDAY delivery

4 = NO WEEKEND or HOLIDAY delivery

E = Scheduled for end of day

F = End of day, no SUNDAY/HOLIDAY delivery

G = End of day, no WEEKEND/HOLIDAY delivery

2

Mandatory for Priority Mail Express

Alphanumeric values (E, F, G, 1-4) only.

Default value is ‘1’.

‘E’ required for PMEOD

064–070

*EM*

Value of Article

9(7)
Defined as:
9(5)V9(2)

Wholesale cost of article.

Mandatory if insured.

$200.00
Entered as:
0020000

Mandatory if insurance is being included as an Extra Service.

Default is zeroes.

071–075

*EM*

COD Amount Due Sender

9(5)
Defined as:
9(3)V9(2)

Dollar amount due on delivery

$206.00
Entered as:
20600

Mandatory if package is COD.

Default is zeroes.

076–079

Handling Charge

9(4)
Defined as:
9(3)V9(2)

Handling charge for registered mail valued at more than $25,000.00.

$20.50
Entered as:
2050

Mandatory if First-Class Mail with registered service valued more than $25,000. Default is zeroes.

080–081
*EM*

Extra Service Code

1st Service

X(2)

Extra service code.

See Extra Service Codes, Appendix C, Table 3.

01

Field contains one Extra Service code.

Mandatory if any Extra Services (insurance, COD, or Return Receipt) are purchased.

Not applicable for PMEOD

Default is spaces.

082–086
*EM*

Fee for Extra Service

1st Fee

9(5)
Defined as:
9(3)V9(2)

Fee for 1st Extra Service Code.

$0.25
Entered as:
00025

Mandatory when Extra Services are purchased.

Not applicable for PMEOD

Default is zeroes.

087–088

2nd Extra Service Code

X(2)

Extra service code.

03

Default is spaces

089–093

2nd Fee for Extra Service

9(5)
Defined as:
9(3)V9(2)

Fee for 2nd Extra Service Code.

$1.40
Entered as:
00140

Default is zeroes.

094–095

3rd Extra Service Code

X(2)

Extra service code.

04

Default is spaces

096–100

3rd Fee for Extra Service

9(5)

Fee for 3rd Extra Service Code.

$0.85
00085

Default is zeroes.

101–102

4th Extra Service Code

X(2)

Extra service code.

06

Field contains one Extra Service code. Default is spaces.

103–107

4th Fee for Extra Service

9(5)
Defined as:
9(3)V9(2)

Fee for 4th Extra Service Code.

$1.25
Entered as:
00125

Default is zeroes.

108–109

5th Extra Service Code

X(2)

Extra service code.

08

Field contains one Extra Service code. Default is spaces.

110–114

5th Fee for Extra Service

9(5)
Defined as:
9(3)V9(2)

Fee for 5th Extra Service Code.

$2.75
Entered as:
00275

Default is zeroes.

115–116

6th Extra Service Code

X(2)

Extra service code.

11

Field contains one Extra Service code. Default is spaces.

117–121

6th Fee for Extra Service

9(5)
Defined as:
9(3)V9(2)

Fee for 6th Extra Service Code.

$5.40
Entered as:
00540

Default is zeroes.

122–130
*EM*

Mailer ID

9(9)

This field is used for consolidators that mail for other customers. Must fill in a valid Mailer ID number for the company for which you are mailing.

940121
Entered as:
000940121

Numeric values only. No spaces.

Default is zeroes.

131–160
*EM*

Customer Reference Number

X(30)

Used for customer internal identification purposes. (Priority Mail Express charge back number can be used.)

123456

Alphanumeric values (A-Z,
0-9) only. Spaces if not applicable.

161–162

Surcharge Type

X(2)

Surcharge type code.

01

Not applicable for PMEM

Leading zeroes required.

Default is spaces.

163–169

Surcharge Amount

9(7)
Defined as:
9(5)V9(2)

In unit of dollars and rounded to the nearest cent.

$1.65
Entered as:
0000165

Leading zeroes required.

Default is zeroes for non-applicable products. Numeric values (0–9) only.

170–171

Non-Incidental Enclosure Rate Indicator

X(2)

See Non-Incidental Enclosure Rate Indicator table for valid codes for this field.

SP

Required if applicable.

Default is spaces if not applicable.

172–173

Non-Incidental Enclosure Class

X(2)

Refer to Class of Mail codes, Appendix C, Table 1, shown above in Class of Mail field, positions 003–004.

FC

Required if applicable.

Default is spaces if not applicable.

174–180

Non-Incidental Enclosure Postage

9(7)
Defined as:
9(4)V9(3)

Postage amount for the non-incidental enclosure. In unit of dollars and rounded to the nearest cent.

$0.33
Entered as:
0000330

Required if applicable.

Default is zeroes.

181–189

Non-Incidental Enclosure Weight

9(9)
Defined as:
9(5)V9(4)

Individual weight of the non-incidental enclosure. In unit of lbs. and significant to 4 decimal positions.

0.2500
Entered as:
000002500

Required if applicable.

Default is zeroes.

190–198
*PME*

Filler

n/a

Filler area for future expansion.

n/a

n/a

199–200^
*PME*

Filler

X(2)

Filler area for future expansion.

n/a

Must be spaces.

^ Record is fixed length.

Electronic File Format Version 1.3 Detail Record 2

 

DETAIL RECORD 2 (352 bytes)

ELECTRONIC File Record Formats Version 1.3

Record Positions

Field Name

Format (Size)

Description

Example

Content Rules and Limitations

001–002

Electronic File Detail Record ID

X(2)

A 2 character system constant that identifies an electronic file detail record.

D2

‘D2’ is required.

003–024

Package Identification Code (PIC)

X(22)

Barcoded label number used to track the package. This must be the same PIC used in the corresponding Detail Record 1.

EA123456782US

Alphanumeric values (A-Z, 0–9) only. No spaces except as defined in Detail Record 1 for position 005–026.

Must be the same number put in position 005–026 in the Detail Record 1.

025–072

Name of Addressee

X(48)

Ship to name of addressee.

JOHN DOE

Mandatory for Accountable mail.

Default is spaces.

073–120

Miscellaneous Address Information

X(48)

Miscellaneous Address Information in the destination address.v

BUILDING A

Required if part of address.

Default is spaces.

121–168

Secondary Unit Designator

X(48)

Secondary Unit Designator in the destination address. (This element may appear as part of the Delivery Address.) This field is not to be used for the city or state.

SUITE 400

Required if part of address.

Default is spaces.

169–216

Delivery Address

X(48)

Delivery Address in the destination address. (May contain secondary unit designator, such as APT or SUITE, for Accountable mail.) This field is not to be used for the city or state.

123 MAIN ST

Mandatory for Accountable Mail.

Default is spaces.

217–244

City Name

X(28)

City name of the destination address.

Reston

Required if part of address.

Default is spaces.

245–246

State

X(02)

Two character state code of the destination address.

VA

Required if part of address.

Default is spaces.

247–257

Postal Code

X(11)

Foreign country postal code or POSTNET representation.v

A0A9A0

Not applicable for PMEM.

Left justified; default is spaces.

258–285

International Province Name

X(28)

International Province Name of the destination address.

Ontario

Not applicable for PMEM.

Default is spaces.

286–295

Customs Category

Article 1

X(10)

Code of article in package using USITC Harmonized Tariff Schedule.

1702.20.22
Entered as:
17022022

Not applicable for PMEM.

Left justified; default is spaces.

296–297

Customs Count

Article 1

9(2)

Total number of articles in package of this customs category.

20

Not applicable for PMEM.

298–305

Customs Value

Article 1

9(8)
Defined as:
9(6)V9(2)

Total value of articles in package of this customs category. In units of dollars and rounded to nearest cent.

$100.00
Entered as:
00010000

Not applicable for PMEM.

306–315

Customs Category

Article 2

X(10)

Code of article in package using USITC Harmonized Tariff Schedule.

1702.20.22
Entered as:
17022022

Not applicable for PMEM.

Left justified; default is spaces.

316–317

Customs Count

Article 2

9(2)

Total number of articles in package of this customs category.

10

Not applicable for PMEM.

318–325

Customs Value

Article 2

9(8)
Defined as:
9(6)V9(2)v

Total value of articles in package of this customs category. In units of dollars and rounded to nearest cent.

$50.00
Entered as:
00005000

Not applicable for PMEM.

326–335

Customs Category

Article 3

X(10)

Code of article in package using USITC Harmonized Tariff Schedule.

1702.20.22
Entered as:
17022022

Not applicable for PMEM.

Left justified; default is spaces.

336–337

Customs Count

Article 3

9(2)

Total number of articles in package of this customs category.

15

Not applicable for PMEM.

338–345

Customs Value

Article 3

9(8)
Defined as:
9(6)V9(2)

Total value of articles in package of this customs category. In units of dollars and rounded to nearest cent.

$300.99
Entered as:
00030099

Not applicable for PMEM.

346–352^

Filler

X(7)

Filler for future use.

n/a

Must be spaces.

^ Record is fixed length.