# 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.

From Publication 199 Version 35, July 2, 2026, pages pages 326–332. A field marked unchecked has a cell that isn't in the page's text, or a second reading of the page doesn't agree with its row.

## Header Record

- 001–002 **Shipping Partner Event File Header Record ID** (A(2)): 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 326](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=325).
- 003–011 **Shipping Partner’s Mailer ID** (A(9)): 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 326](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=325).
- 012–026 **Shipping Partner Event File Number** (A(15)): 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 327](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=326).
- 027–035 **File Record Count** (N(9)): 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 327](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=326).
- 036-038 **Extract Version Number** (N(3)): File Version Number Example: 040. Content rules: ▪ Entered as: 040 EDI 240: 040. [Page 327](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=326).
- 039-039 **Direction Indicator** (A(1)): Valid Values: 1 = Inbound 2 – Outbound Example: 1. Content rules: ▪ Required ▪ Left Justified, trailing spaces EDI 240: BGN08. [Page 327](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=326).
- 040–080 **Filler** (A(41)): Filler for future use. Content rules: ▪ Must be spaces. [Page 327](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=326).

## Detail Record

- 001–002 **Shipping Partner Event File Detail Record ID** (A(2)): Shipping Partner Event Detail Record Example: ED. Content rules: ▪ ‘ED’ is required. EDI 240: ED. [Page 328](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=327).
- 003–036 **Package Identification Code (PIC) <Legacy and IMPB>** (A(34)): 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 328](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=327).
- 037–038 **Event Code** (A(2)): 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 328](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=327).
- 039–043 **Event ZIP Code** (N(5)): 5-digit ZIP Code of event location. Example: 22201. EDI 240: IF N101 = “XG” then N403 (Positions 1 - 5). [Page 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 044–047 **Event ZIP +4** (N(4)): 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 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 048–055 **Event Date** (A(8)): Date associated with movement of shipments by shipping partner Example: 20030127. Content rules: ▪ Format is YYYYMMDD EDI 240: AT705. [Page 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 056–061 **Event Time** (A(6)): Time associated with movement of shipments by shipping partner. Example: 131500. Content rules: ▪ Format is HHMMSS (24-hour time format.) EDI 240: AT706. [Page 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 062-070 **Client Mailer ID** (A(9)): Default = NA Content rules: ▪ Always default to spaces EDI 240: Spaces. [Page 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 071-075 **Destination ZIP** (N(5)): 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 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 076-079 **Destination ZIP + 4** (A(4)): 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 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 080-081 **Destination Delivery Point** (N(2)): 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 329](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=328).
- 082-129 **Destination Delivery Address** (A(48)): 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 330](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=329).
- 130-157 **City Name** (A(28)): City Name of the destination address Example: Fairfax. Content rules: ▪ Default is spaces EDI 240: If N101= “ST” Then N401. [Page 330](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=329).
- 158-159 **State** (A(2)): Two character state of the destination address Example: VA. Content rules: ▪ Default is spaces EDI 240: If N101 = “ST” Then N402. [Page 330](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=329).
- 160 – 170 **Pickup and or Return Address 11 Digit Delivery Point Validated ZIP CODE** (N(11)): 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 330](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=329).
- 171 – 172 **Action Code** (A(2)): 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 331](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=330).
- 173 – 180 **Mailing/Tendered date** (N(8)): 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 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.
- 181 – 189 **Merchant Projected Delivery Date** (N(8)): 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 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.
- 189 – 189 **Entry Facility Type** (A(1)): 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 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.
- 190 – 194 **Entry Facility ZIP Code** (N(5)): 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 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.
- 195-196 **Customer Delivery Preference** (A(2)): For future use Content rules: ▪ Default is spaces EDI 240: CD301. [Page 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.
- 197 – 200 **Filler** (A(4)): For future use. Content rules: ▪ Spaces are required [Page 332](https://postalpro.usps.com/mnt/glusterfs/2026-07/Pub%20199_v35_07022026.pdf#page=331). Unchecked.

Every record layout and message: https://postalref.com/specs.md

---

Unofficial. Not affiliated with or endorsed by the United States Postal Service. This is https://postalref.com/specs/shipping-partner-event-file-4-0 as Markdown.
