Shipping Partner Event File 4.0 Layout
The Shipping Partner Event File 4.0 record layout from Publication 199 Version 35, July 2, 2026: 2 records and 29 fields, in the order the file holds them.
Header Record
7 fields, pages 326–327
- Description
- A two-character system constant, which identifies a Shipping Partner Event File Header Record.
- Example
- EH
- Content rules
- ▪ ‘EH’ is required.
- EDI 240
- EH
- Page
- Publication 199, page 326
- Description
- Shipping Partner’s Mailer ID Field
- Example
- 912345678 or 212345
- Content rules
- ▪ Must be the Mailer ID of the consolidator. ▪ Can be a six or nine digit MID. ▪ If a six digit MID, left justified, trailing spaces. ▪ Must be a Valid Mailer ID.
- EDI 240
- IF N101 = “SH” Then N102
- Page
- Publication 199, page 326
- Description
- Event File Number If SIX digit MID then populate event number with either: 11 digit number and 4 spaces or 15 digit number If Nine digit MID then populate event number with either: 9 digit number and 6 spaces or 8 digit number and 7 spaces or 12 digit number and 3 spaces
- Content rules
- ▪ Left justified with trailing spaces if applicable.
- EDI 240
- BGN02
- Page
- Publication 199, page 327
- Description
- Total number of all records in this file. Count to include Header Record and all Detail Records.
- Example
- 000001517
- Content rules
- ▪ Leading zeroes required.
- EDI 240
- 00000000n
- Page
- Publication 199, page 327
- Description
- File Version Number
- Example
- 040
- Content rules
- ▪ Entered as: 040
- EDI 240
- 040
- Page
- Publication 199, page 327
- Description
- Valid Values: 1 = Inbound 2 – Outbound
- Example
- 1
- Content rules
- ▪ Required ▪ Left Justified, trailing spaces
- EDI 240
- BGN08
- Page
- Publication 199, page 327
- Description
- Filler for future use.
- Content rules
- ▪ Must be spaces.
- Page
- Publication 199, page 327
Detail Record
22 fields, pages 328–332, 6 unchecked
- Description
- Shipping Partner Event Detail Record
- Example
- ED
- Content rules
- ▪ ‘ED’ is required.
- EDI 240
- ED
- Page
- Publication 199, page 328
- Description
- Tracking number used on package. May include routing information and Package Identification Code (PIC). Legacy Barcode 2 digits – Application Identifier 2 digits - Service Type Code 9 digits- Mailer ID 8 digits - Fixed-length sequence number 1 digit - MOD 10 check digit Intelligent Mail package barcode 3 digits - ‘420’ 5 digits - Routing ZIP Code 4 digits - Routing +4 2 digits - AI (92 or 93) 3 digits - Service Type Code 6 or 9 digits - Mailer ID (MID) If six-digit MID, 10- or 14-digit serial #; If nine-digit MID, 7- or 11-digit serial # 1 digit - check digit
- Example
- 910194123331 2000012345 Or 92321234567 89123456780 Or 932311234561 2345671905
- Content rules
- ▪ The PIC must remain unique for 120 days from date of first use for domestic, 365 days for international. ▪ Left justified with trailing spaces if applicable
- EDI 240
- IF L1102 not = “ZZ” then L1101
- Page
- Publication 199, page 328
- Description
- Event Code
- Example
- 81
- Content rules
- ▪ Valid values for inbound are ‘GX’, ‘AL’,‘80’,‘81’, and ‘82’ and ‘83’ ▪ Valid values for outbound are ‘84’, ‘85’, ‘86’, and ‘87’ – Mailer ID must be a Certified PRS customer.
- EDI 240
- AT701
- Page
- Publication 199, page 328
- Description
- 5-digit ZIP Code of event location.
- Example
- 22201
- EDI 240
- IF N101 = “XG” then N403 (Positions 1 - 5)
- Page
- Publication 199, page 329
- Description
- ZIP + 4 add on of domestic ZIP Code
- Example
- 2804
- Content rules
- ▪ Default is spaces, if not available.
- EDI 240
- IF N101 = “XG” then N403 (Positions 6 - 9)
- Page
- Publication 199, page 329
- Description
- Date associated with movement of shipments by shipping partner
- Example
- 20030127
- Content rules
- ▪ Format is YYYYMMDD
- EDI 240
- AT705
- Page
- Publication 199, page 329
- Description
- Time associated with movement of shipments by shipping partner.
- Example
- 131500
- Content rules
- ▪ Format is HHMMSS (24-hour time format.)
- EDI 240
- AT706
- Page
- Publication 199, page 329
- Description
- Default = NA
- Content rules
- ▪ Always default to spaces
- EDI 240
- Spaces
- Page
- Publication 199, page 329
- Description
- Destination 5-digit ZIP Code.
- Example
- 22030
- Content rules
- ▪ Must be 5 digits. ▪ Numeric values (0-9)
- EDI 240
- If N101 = “ST” Then N403 (Position 1 - 5)
- Page
- Publication 199, page 329
- Description
- Destination ZIP + 4
- Example
- 1234
- Content rules
- ▪ the ZIP+4 Code for the Destination Delivery address when included with the 5-digit ZIP Code and 2-Digit Delivery Point Code represent the unique 11-digit ZIP Code for the Destination Delivery Address. ▪ Numeric value (0- 9) ▪ Default is spaces if not available.
- EDI 240
- If N101 = “ST” Then N403 (Position 6 - 9) Else spaces
- Page
- Publication 199, page 329
- Description
- Destination Delivery Point – completes the 11-digit Delivery Point ZIP Code.
- Example
- 02
- Content rules
- ▪ Numeric values (0-9) only. ▪ Default is spaces if not available.
- EDI 240
- If N101 = “ST” Then N403 Position 10 - 11) Else spaces
- Page
- Publication 199, page 329
- Description
- Delivery Address of the destination address.
- Example
- 123 Main Street
- Content rules
- ▪ Destination Delivery Address and/or the 11-digit Destination Delivery Point are required. ▪ The following Special Characters (hyphen, forward slash and period) are allowed. ▪ This field is not be used for the city or state ▪ Default is spaces
- EDI 240
- If N101 = “ST” Then N301
- Page
- Publication 199, page 330
- Description
- City Name of the destination address
- Example
- Fairfax
- Content rules
- ▪ Default is spaces
- EDI 240
- If N101= “ST” Then N401
- Page
- Publication 199, page 330
- Description
- Two character state of the destination address
- Example
- VA
- Content rules
- ▪ Default is spaces
- EDI 240
- If N101 = “ST” Then N402
- Page
- Publication 199, page 330
- Description
- Populated with the 11 Digit Delivery Point Validated ZIP CODE for the pick up or return address.
- Example
- 22030811246
- Content rules
- ▪ Numeric only (0- 9) ▪ Default is spaces
- EDI 240
- If N101 = “XG” And N103 = “ZZ” Then N104
- Page
- Publication 199, page 330
- Description
- List of valid action codes. ‘PP’ - PC Postage – Pick Up Address (Request Pickup) ‘SP’ – Service Provider – Pick Up Address (Request Pickup) ‘MP’ – Mail Owner – Pick Up Address (Request Pickup) ‘PR’ – PC Postage – Return Address ‘SR’ – Service Provider – Return Address ‘MR’ – Mail Owner – Return Address ‘PB’ – PC Postage – Pick up Address (Same as Return Address) ‘SB’ – Service Provider – Pick up Address (Same as Return Address) ‘MB’ – Mail Owner – Pick up Address (Same as Return Address) ‘P0’ – PC Postage ‘S0’ – Service Provider ‘M0’ – Mail Owner ‘V1” – Cancelled Label - Only applicable for GX Event “V2” - Package Delivered by Shipping Partner – Only applicable for GX Event
- Example
- PP
- Content rules
- ▪ Must be a valid code.
- EDI 240
- IF L1102 not = “ZZ” Then L1102
- Page
- Publication 199, page 331
- Description
- Date partner or customer expects to tender the package to USPS
- Example
- 20140508
- Content rules
- ▪ Format is CCYYMMDD ▪ Null value is valid.
- EDI 240
- IF L1102 not = “ZZ” Then L1104
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.
- Description
- Date when the package will be delivered to the customer.
- Example
- 20140508
- Content rules
- ▪ Format is CCYYMMDD
- EDI 240
- IF L1102 = “ZZ” Then L1104
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.
- Description
- Type of USPS facility where mail is tendered. ‘A’ – ADC ‘B’ – NDC/RPDC ‘S’ – SCF/LPC/RPDC ‘D’ – DDU/S&DC ‘F’ – ASF ‘I’ – ISC
- Example
- A
- Content rules
- ▪
- EDI 240
- IF L1102 = “ZZ” Then L1103
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.
- Description
- 5-digit ZIP Code of postal facility where the mail is tendered.
- Example
- 22201
- Content rules
- ▪ Numeric only (0- 9)
- EDI 240
- IF L1102 = “ZZ” Then L1101
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.
- Description
- For future use
- Content rules
- ▪ Default is spaces
- EDI 240
- CD301
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.
- Description
- For future use.
- Content rules
- ▪ Spaces are required
- Page
- Publication 199, page 332
Unchecked: a cell isn’t in the page’s text, or a second reading of the page doesn’t agree with the row.