Parcel Data Exchange

PDX Web Application

Customer Acceptance Test (CAT) Guide

Version: 06

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 1 of 28

 Table of Contents
Table of Contents .......................................................................................................................................... 2
1. Introduction .......................................................................................................................................... 4
1.1 Purpose of Document ................................................................................................................... 4
1.2 Intended Audience ........................................................................................................................ 4
1.3 Application Overview .................................................................................................................... 4
1.4 USPS® Help Desk Assistance .......................................................................................................... 4
1.5 Benefits of PDX CAT ...................................................................................................................... 4
2. Business Customer Gateway (BCG) CAT ............................................................................................... 5
2.1 Adding MIDs to the BCG CAT account .......................................................................................... 6
2.2 PDX Application Functions .......................................................................................................... 13
2.2.1 Upload Manifest Files ......................................................................................................... 14
2.2.2 Manifest File Types ............................................................................................................. 17
2.2.3 Search and Download Previously Uploaded Manifest Files ................................................ 18
2.2.4 View and Download Customer Outbound Files .................................................................. 20
2.2.5 Outbound File Types ........................................................................................................... 23
2.2.6 Limitations on Inbound and Outbound Files ...................................................................... 25
2.3 PDX Documentation .................................................................................................................... 26
2.4 User Information Display ............................................................................................................ 26
2.5 Refresh the MIDs ........................................................................................................................ 27
2.6 Logout ......................................................................................................................................... 27
2.7 Help ............................................................................................................................................. 27
2.8 Links ............................................................................................................................................ 28
2.9 Support Information ................................................................................................................... 28
2.10 Resetting Passwords ................................................................................................................... 28

© 2022 United States Postal Service®. All rights reserved.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 2 of 28

 REVISION HISTORY
Date Revision # Details
03/22/2021 01 Initial draft
05/20/2021 02 Added extract upload section; updated extract screenshots
05/21/2021 03 Updated figure counts
06/08/2021 04 Added Benefits of PDX CAT testing section
07/14/2021 05 Deleted erroneous information about Program Registration configuration
01/05/2022 06 Updated copyright

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 3 of 28

1. Introduction

1.1 Purpose of Document

The Parcel Data Exchange (PDX) application is a Web and Application Programming Interface
(API) based application that allows customers to send manifest files to and receive outbound
files from the United States Postal Service® (USPS®). This document provides the information
necessary to use the PDX Customer Acceptance Test (CAT) environment.

1.2 Intended Audience

This document is intended for users of the PDX CAT environment application. It is a guide for
configuring accounts, uploading manifest files, uploading outbound files, listing outbound files
and downloading outbound files through the API and/or Web Interface.

1.3 Application Overview

Connection to PDX is via the USPS® Business Customer Gateway (BCG) CAT environment using a
web browser. The browser should minimally support the following protocols: HTTP1.1 and
TLSv1.2. PDX supports the following browsers:

• Google Chrome®
• Microsoft Edge®
• Mozilla Firefox®
• Apple Safari®
• Internet Explorer® Not supported (may have limited functionality)

1.4 USPS® Help Desk Assistance

This guide describes how to submit manifest files and receive outbound files via PDX CAT.
Contact the USPS® PDX team at [email protected] for additional assistance.

1.5 Benefits of PDX CAT

• CAT testing performed has NO impact on production account data.
• API parameters (new or changed) can be tested to determine the best configuration to meet
customer business needs.
• Validate how customer solutions process various errors.
• Validate new customer solution releases and upgrades.
• Fully test API calls (e.g. manifest upload, list of extracts, extract download).
• Test ingestion of downloaded extract information (customer created extract data).
• Test conversion to new API calls (e.g. upgrade from the deprecated List of Extracts API call to
the new List of Extracts API call).
• Partner with USPS PDX to create test scenarios (e.g. deactivate account to determine
solution processing).

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 4 of 28

2. Business Customer Gateway (BCG) CAT
It is recommended that all customers create an account in the PDX CAT environment. The PDX CAT
environment is separate from PDX Production and provides an isolated testing environment or
“sandbox” for customers to test PDX file uploads, lists and downloads without impacting any
Production data.

The PDX CAT application is accessed via the CAT Business Customer Gateway (BCG). To create a CAT
account, log into the CAT BCG using the URL: https://gateway-cat.usps.com/eAdmin/view/signin
and click the ‘Sign up for the BCG’ button. A new username and password for the CAT environment
are required to create the new CAT account (though it is probable that the same BCG production
account name can be used in CAT).

PDX CAT API calls mimic PDX Production API calls, except for changing the URL of the Production API
calls from “pdx.usps.com” to “pdx-cat.usps.com” and updating the username/password to the BCG
CAT account credentials. Users will need to configure new MIDs to use in the CAT environment.

Follow the steps below to get access to the PDX. The BCG CAT can be accessed using the following
hyperlink: https://gateway-cat.usps.com/
• To use PDX for Uploading Manifest Files:
o Create a BCG CAT account, if you have not already done so
o Login to BCG CAT and access PDX via the Shipping Services tab
o Use the REST API to upload using the URL: https://pdx-cat.usps.com/api/manifests

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 5 of 28

2.1 Adding MIDs to the BCG CAT account
The PDX CAT account will need MIDs associated with it. Customer outbound files (extracts) will be
loaded onto one or MIDs.

Follow the 19 steps below to create one or more MIDs for your BCG CAT account (this process takes
less than 5 minutes).

1. Navigate to “https://gateway-cat.usps.com/eAdmin/view/signin”.
2. Click on “Sign in to the BCG”.

3. Enter the username and password for your BCG CAT account. Click on “Sign In”.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 6 of 28

 4. Click on Shipping Services and navigate to Online Enrollment (click on “Go to Service” on the
Online Enrollment line):

5. First time users will be provided a drop-down menu to select programs from…

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 7 of 28

 6. Choose “Electronic Verification System (eVS)”

7. Click on “Continue”

8. Wait patiently. The enrollment acknowledgement page will be returned. All answers will be
prepopulated.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 8 of 28

 9. Scroll down and click on “Edit Questionnaire”

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 9 of 28

 10. Edit the questionnaire by clicking on “Receive File Format”

11. Enable the radio button for “Web Services”, then click on “Save & Continue”. Click on “Save &
Close” when complete.
12. You may have to click on “Save and Close” for the next page to be displayed.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 10 of 28

 13. The eVS overview page will be displayed

14. Click on “Incomplete” beside “Manage Shipping Locations”

15. Verify that the CRID/MID are correctly assigned

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 11 of 28

 16. If a new location was added (CRID) that does NOT have a MID, enable the checkbox on the row
with that CRID. Then click on “Request New MID”. The system will add a MID for that CRID.

17. Repeat step 16 (i.e., enable the checkbox next to a CRID and click “Request New MID” to
create as many MIDs as you want on your account).

18. Once satisfied with the MIDs/CRIDs assigned, click on the “GATEWAY” link at the top.

19. Navigate to “Shipping Services” → Parcel Data Exchange (PDX) as shown below in Figure 1. Click
on the ‘Go to Service’ button for PDX CAT to access the PDX landing page.

If you have not yet been approved to access PDX CAT by your BSA, you will see ‘Pending BSA’ or
‘Get Access’ rather than the ‘Go to Services’ button. If displayed, click on the ‘Get Access’
button. Contact your BSA to approve you for the service.

Figure 1: Access Shipping Services from the BCG Homepage

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 12 of 28

2.2 PDX Application Functions

The default landing page for the PDX application is the ‘Upload Manifest Files’ page (Manifest
Files tab) shown by Figure 2 below. The top portion of this page is used to upload manifests
(Section 2.2.1) while the bottom portion displays a table with uploaded manifest history (Section
2.2.3).

Figure 2: PDX Landing Page - Upload Manifest Files

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 13 of 28

 2.2.1 Upload Manifest Files
To upload a manifest file for processing, first choose the upload environment, as shown in
Figure 3. The two environment options are: Test Environment for Mailers (TEM) or
Production (PROD). For more information on TEM, reference Publication 199: Intelligent
Mail Package Barcode or Publication 205: Electronic Verification System (eVS®) Business and
Technical Guide: https://postalpro.usps.com/pub199_draft

Figure 3: Choose an Upload Environment Option

To choose a file to upload to the selected environment, click on the ‘+ Select Manifest
File(s)’ button, as shown in Figure 4.

Figure 4: Select Manifest File(s)

After clicking the ‘+ Select Manifest File(s)’ button, a file selection dialog box will open.
Select the files to upload, then click ‘Open’ as shown in Figure 5. Up to 25 files with a
maximum total size of 250 MB may be selected. Manifest filenames are limited to less than
180 characters; manifests with filenames of 180 or more characters will fail to upload. Keep
manifest filenames unique (example: add a date/timestamp). Manifest filenames should be
alphanumeric characters without encoding. Manifest file contents must be alphanumeric
text without encoding; special characters or encoding will cause manifest processing to fail.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 14 of 28

 Reserved characters found in manifest filenames will be converted by PDX to underscore (_)
characters. The following reserved characters will be converted: Pipe (|), Percent sign (%),
Dollar sign ($), Greater than (>), Less than (<), Ampersand (&) and Single quote (‘).

For example, a manifest file named Sprockets&01%2019.manifest will be renamed

Sprockets_01_2019.manifest once uploaded to PDX.

Figure 5: Choose files to upload

After clicking on ‘Open’, two new buttons, ‘Start Upload’ and ‘Cancel Upload’ will be displayed
to the right of the ‘+ Select Manifest File(s)’ button (see Figure 6). If satisfied with the list of
selected files, proceed by clicking the ‘Start Upload’ button. To cancel the upload, click the
‘Cancel Upload’ button.

Figure 6: Start Upload or Cancel Upload

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 15 of 28

 While uploading, the page will display a progress bar for each file. After the upload has
completed, the status bar will show that the file was either uploaded successfully or
encountered an error (see Figure 7). Successfully uploaded files will be displayed in the
Upload Manifest Files table. Section 2.2.3 of this document describes the layout of the table
and how to search for previously uploaded manifest files.

Figure 7: Upload Complete

Example Manifest Upload API call via PDX CAT:

curl -u 'user:pass' -X POST -F 'environment=TEM' -F 'filename=001.qzNVudUPZsHe.podsub' -F
'[email protected]' 'https://pdx-cat.usps.com/api/manifests'

Response:
{"id":918265,"environment":"TEST ENVIRONMENT FOR MAILERS","createdTime":"Mar 22, 2021 15:00:57
PM","sentTime":null,"filename":"001.qzNVudUPZsHe.podsub"}

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 16 of 28

 2.2.2 Manifest File Types
The following table outlines the manifest file types accepted by PDX.

File File Naming Convention

“.manifest” (lowercase) in any node of the filename.

Preferred:
Shipping Services File v1.3, v1.4, Single: <logonid>.manifest
v1.6, v1.7, v2.0 Example: mmcw93.manifest
Multiple: <logonid><seq>.manifest
Example: mmcw93a.manifest (Begin with the letter a for the
sequence identifier and continue with b, c, etc. for
subsequent files.)

“.consolid” (lowercase) in any node of the filename.

Preferred:
Shipping Partner Event File v1.0, Single: <logonid>.consolid
v2.0, v3.0 Example: mmcw93.consolid
Multiple: <logonid><seq>.consolid
Example: mmcw93a.consolid (Begin with the letter a for the
sequence identifier and continue with b, c, etc. for
subsequent files.)

“.subscribe” (lowercase) in any node of the filename.

Subscription Trigger File v1.0 Preferred:
Single: <logonid>.subscribe
Example: mmcw93.subscribe

“.delivery” (lowercase) in any node of the filename.

Delivery Partner Event File v1.0 Preferred:
Single: <logonid>.delivery
Example: mmcw93.delivery

“.podsub” (lowercase) in any node of the filename.

Request BPOD/TPOD letters
Preferred:
Single: <logonid>.podsub
Example: mmcw93.podsub

For descriptions of these files, please refer to Publication 199: Intelligent Mail Package Barcode
at: https://postalpro.usps.com/pub199_draft

File limitations are listed below in section 2.2.6 Limitations on Inbound and Outbound Files.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 17 of 28

 2.2.3 Search and Download Previously Uploaded Manifest Files
The Manifest Upload History table shows all files uploaded by the user during the previous 45
days. Manifest files can be searched for, downloaded, or hidden within the table as shown by
Figure 8.

Figure 8: Manifest Files Page

Figure 9: Search and Download Manifest Files

1. Manifest File Download

To download a copy of the uploaded file, click on the blue button containing the filename as
shown by Figure 9, box 1.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 18 of 28

 2. Manifest File Search
To filter by filename, click inside the ‘Filename’ input field and type the full or partial name (case
insensitive) of the desired file as shown by Figure 9, box 2a. To sort by alphanumeric or reverse-
alphanumeric order, click on the up/down carets to the right of the header of the Manifest File
column as shown by Figure 9, box 2b.

3. Environment
To filter by environment, select ‘Test Environment for Mailers’ (TEM) or ‘Production’ (PROD)
from the dropdown within the Environment column as shown by Figure 9, box 3a. To sort the
table to display either TEM or PROD files first, click on the up/down carets to the right of the
header of the Environment column as shown by Figure 9, box 3b.

4. Upload Time
‘Upload Time’ refers to the time when the file was uploaded in Central Standard Time (CST).

To filter by Upload Time, select the respective ‘From’ and ‘To’ dates by clicking in the input
fields, as shown by Figure 9, box 4a, and clicking on the desired month and day inside of the
selection calendar. To clear the date filter, click the ‘Clear’ button at the bottom of each
calendar and the default date range will be restored (previous 45 days). To sort by chronological
or reverse-chronological order, select the up/down carets to the right of the column header of
the Upload Time as shown by Figure 9, box 4b.

5. Processing Status
‘Processing Status’ reflects the time (in CST) when the file was sent for processing to the
destination application. If this field is empty, the file has not yet been sent for processing.

To filter by Processing Status date, select the respective ‘From’ and ‘To’ dates by clicking in the
input fields, as shown by Figure 9, box 4a, and clicking on the desired month and day inside of
the selection calendar. To clear the date filter, click the ‘Clear’ button at the bottom of each
calendar and the default date range will be restored (previous 45 days).

Hovering the cursor over the check mark will display additional manifest processing information
similar to the following: Sent for processing on Wed 04/18/21 06:20 AM CDT.

6. Hide Manifests
To hide a manifest row in the table, click the ‘Hide’ button in the Hide Manifests column within
the same row as shown by Figure 9, box 5a. The manifest will still exist in the PDX file system,
but will no longer be displayed in the Manifest Upload History Table. To unhide all previously
hidden manifests, click the ‘Unhide All’ button as shown by Figure 9, box 5b.

7. Common Errors
• File upload is limited to {size} in total size per request
The file chosen exceeds the maximum size PDX will process. Split the file.
• File upload is limited to 25 files per request.
A maximum of 25 files can be uploaded at one time. Only the first 25 will be processed.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 19 of 28

2.2.4 View and Download Customer Outbound Files
To access Customer Outbound Files (also known as Extracts), click on the ‘Customer Outbound
Files’ tab in the top banner of the application, as shown by Figure 10.

Figure 10: Customer Outbound Files Page

All outbound files generated during the last 45 days for all MIDs associated with your account
will be displayed in the table. Populate the various filters (i.e. MID, Filename, Environment,
Created Time, Previously Downloaded, File Type) to determine which files to display. Outbound
files can be searched for or downloaded as shown by Figure 11.

Figure 11: View, Upload, Download Customer Outbound Files

1. Customer Outbound File Download

To download a copy of an outbound file, click on the blue button containing the filename as
shown by Figure 11, box 1.

2. Mailer Identifier (MID)

To filter by the Mailer Identifier (MID), click inside the ‘MID number’ input field and enter a full
or partial MID as shown by Figure 11, box 2a. To sort by ascending or descending numeric
order, click on the up/down carets to the right of the header of the MID column as shown by
Figure 11, box 2b.

3. Customer Outbound File

To filter by filename, click inside the ‘Filename’ input field and enter the full or partial file name
as shown by Figure 11, box 3a. To sort by alphabetical or reverse-alphabetical order, click on
the up/down carets to the right of the header of the Customer Outbound File Download column
as shown by Figure 11, box 3b.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 20 of 28

 4. Environment
To filter by environment, click on the ‘Select Environment’ dropdown menu and choose from:
‘TEM’, ‘PROD’ or ‘Select Environment’ (default for both TEM and PROD); as shown by Figure 11,
box 4.

5. Created Time
To filter by Created Time, select the respective ‘From’ and/or ‘To’ dates by clicking in the input
fields, as shown by Figure 11, box 5a, and clicking on the desired month and day inside of the
selection calendar. To clear the date filter, click the ‘Clear’ button at the bottom of each
calendar and the default date range will be restored (previous 45 days). To sort by chronological
or reverse-chronological order, select the up/down carets to the right of the column header of
the date field as shown by Figure 11, box 5b. All times are displayed in CST.

6. Previously Downloaded
To filter by whether or not files were previously downloaded, click on the ‘Select Download
Status’ dropdown menu and choose from: ‘Previously Downloaded’, ‘Not Downloaded’ or
‘Select Download Status’ (default for both previously and not downloaded); as shown by Figure
11, box 6.

7. File Type
To filter by file type, click on the ‘Select File Type’ dropdown in the File Type column and choose
one entry from the list of file types; as shown by Figure 11, box 7.

8. Bulk Download
To download multiple Customer Outbound Files at one time, click the ‘Download Selected Files’
button above the table as shown by Figure 11, box 8. Files fitting the filter criteria entered in
each column of the table will be downloaded in a zip file. If no filter criteria are entered before
clicking the bulk download button, all files from the past 45 days will be downloaded. If no files
fit the filter criteria, the ‘Download Select Files’ button while be ghosted/unavailable for
selection. If the results contain too many files, or too much data, the download will fail with an
appropriate message similar to the following:

• Total count of Selected Files exceeds the Max ZIP File Count Limit {max file count}
• Total byte size of Selected Files Exceeds the Max ZIP Bytes Size Limit {max size}

Creating Zip files is inherently slow since the processing and compression of many files is
required. Simultaneous Zip requests will be denied and an error message similar to the
following will be displayed:

A zip is still in progress. Please try later. Last started at: MM/DD/YYYY HH:MI:SS

If the Zip fails to complete (e.g. disk write failure) new Zip requests will continue to fail for up to
10 minutes (the restriction is automatically cleared after 10 minutes); Zip requests will then be
accepted again.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 21 of 28

 9. Outbound File Upload
Outbound files can be uploaded by the customer for their list/download testing. Refer to Figure
11 box 9. To upload an outbound file, select ‘Test Environment for Mailers’ (TEM) or
‘Production’ (PROD) by enabling the appropriate radio button. Select the MID (to which the
outbound file will be uploaded) using the ‘Select MID’ dropdown. Select an outbound file to
upload by clicking on the ‘+ Select Extract File’ button. This will open a browser file selection
popup.

Once the environment, MID and file have been chosen, two new buttons (‘Start Upload’ and
‘Cancel Upload’) will be displayed as shown by Figure 12 box 5 along with the filename and size
(as shown by box 4). Clicking on the ‘Start Upload’ button will load the outbound file to the
chosen environment and MID. Clicking on the ‘Cancel Upload’ button will cancel the outbound
file upload process.

Figure 12: Outbound file start/cancel upload

10. Common Errors

• Total count of Selected Files exceeds the Max ZIP File Count Limit {count}
The number of extracts matching the filter criteria is too many. Change or add filters to
decrease the number of files.
• Total byte size of Selected Files Exceeds the Max ZIP Byte Size Limit {size}
A maximum of 1GB worth of files can be downloaded at one time. Change or add filters to
decrease the total size of all the selected files below the maximum.
• A zip is still in progress. Please try later. Last started at: MM/DD/YYYY HH:MI:SS
Only one Zip can be executing, per customer, at a time. Wait for the initial zip to finish (or
10 minutes to timeout) then request another Zip.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 22 of 28

 2.2.5 Outbound File Types
Outbound files that may be expected from Product Tracking and Reporting (PTR) are shown
in the following table:

File File Naming Convention

Shipping Services CEW Data v1.3 ERRWRNO.RPT.MMDDhhmmss

Shipping Services CEW Data v1.5 ERRWRNO.V15.RPT.MMDDhhmmss

Shipping Services CEW Data v1.7 ERRWRNO.V17.RPT.MMDDhhmmss

Shipping Services CEW Report v1.3 ERRWRNO.RPT.MMDDhhmmss

Shipping Services CEW Report v1.5 ERRWRNO.V15.RPT.MMDDhhmmss

Shipping Services CEW Report v1.7 ERRWRNO.V17.RPT.MMDDhhmmss

Shipping Partner CEW Data v1.0 ERRWRNO1.RPT.MMDDhhmmss

Shipping Partner CEW Data v2.0 ERRWRNO1.V20.MMDDhhmmss

Shipping Partner CEW Report v1.0 ERRWRNO1.RPT.MMDDhhmmss

Shipping Partner CEW Report v2.0 ERRWRNO1.V20.MMDDhhmmss

Subscription Scan CEW v1.0 EWSUBSCRIBE.V10.RPT.MMDDhhmmss

EWDELIVERY.V10.RPT.MMDDhhmmss
Delivery Partner Event CEW v1.0
Example: EWDELIVERY.V10.RPT.0103153115

Customer Daily Extract (CDE) v1.3 DETEXTRO.RPT.MMDDhhmmss

Customer Daily Extract (CDE) v1.5 DETEXTRO.V15.RPT.MMDDhhmmss

Customer Daily Extract (CDE) v1.6 DETEXTRO.V16.RPT.MMDDhhmmss

Customer Daily Extract (CDE) v2.0 DETEXTRO.V20.RPT.MMDDhhmmss

WKEXTR01.RPT.MMDDhhmmss
Weekly Unmanifested Extract v1.3
(number "0", not letter "O")

WKEXTR01.V15.RPT.MMDDhhmmss
Weekly Unmanifested Extract v1.5
(number "0", not letter "O")

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 23 of 28

 File File Naming Convention

WKEXTR01.V16.RPT.MMDDhhmmss
Weekly Unmanifested Extract v1.6
(number "0", not letter "O")

WKEXTR01.V20.RPT.MMDDhhmmss
Weekly Unmanifested Extract v2.0
(number "0", not letter "O")

Subscription Scan Event Extract 1.0 SUBEXTRO.V10.RPT.MMDDhhmmss

eVSPaymentComplete-<6 or 9 Character Mailer MID>-

YYYYMMDDhhmmss.pse
eVS Postage Payment Extract or
eVSPaymentPartial-<6 or 9 Character Mailer MID>-
YYYYMMDDhhmmss.pse

eVSReconciliationExtract-<6 or 9 Character Mailer MID>-

eVS Reconciliation Extract
YYYYMMDDhhmmss.rxt

Firm Sheet Extract FRMEXTRO1.RPT.MMDDhhmmss

BPOD Confirmation Letter –

Combined pdf
(contains more than one PDF
podMMDDYYXXXX.pdf where XXXX is a sequence ID
BPOD letter)

Recipient is a Customer

BPOD Confirmation Letter –

Combined pdf
(contains more than one PDF d<6 or 9 Digit MID Number>.podMMDDYYXXXX.pdf
BPOD letter) where XXXX is a sequence ID

Recipient is a Third Party

BPOD Confirmation Letter –

Individual pdf
podMMDDYYXXXX.tar where XXXX is a sequence ID

Recipient is a Customer

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 24 of 28

 File File Naming Convention

BPOD Confirmation Letter –

Individual pdf d<6 or 9 Digit MID Number>.podMMDDYYXXXX.tar
where XXXX is a sequence ID
Recipient is a Third Party

BPOD Table Of Contents

tocMMDDYYXXXX.pdf where XXXX is a sequence ID
Recipient is a Customer

BPOD Table Of Contents

d<6 or 9-digit MID Number>.tocMMDDYYXXXX.pdf where
XXXX is a sequence ID
Recipient is a Third Party

For descriptions of these files, please refer to Publication 199: Intelligent Mail Package Barcode
at: https://postalpro.usps.com/pub199_draft

2.2.6 Limitations on Inbound and Outbound Files

File Type Business Rule

• Files cannot be larger than 250MB.
• No more than 25 files can be uploaded simultaneously.
Inbound • Manifest Upload History displays all files uploaded within the past 45 days.
(manifests) • Valid file type extensions for inbound files include: .manifest, .consolid,
.delivery, .podsub and .subscribe. All other file types will be rejected.
• Files are time stamped in CST.
• Customer Outbound Files History displays all files created within the past 45
Outbound days.
(extracts) • Files are time stamped in CST.
• Bulk downloads (ZIP files) are limited in size to 1GB.
• Count of files to be bulk downloaded (ZIP) are limited to 1,000 files.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 25 of 28

2.3 PDX Documentation

The Documentation tab displays PDX documentation available for download. To download a
document, click on the blue button containing the name of the document as shown by Figure
13, box 1 (e.g. PDX API User Guide.pdf).

Figure 13: View and Download PDX Documentation

2.4 User Information Display

A drop-down menu in the top right corner displays the logged in user’s name, email, and phone
number as shown by Figure 14. To change the user information that is displayed here, login to
the BCG and select ‘Manage Account’ from the left panel. Click on the “EDIT PROFILE” button
and change the appropriate data. The change will take affect the next time you log into the
BCG/PDX.

Figure 14: User information

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 26 of 28

2.5 Refresh the MIDs

If MID information has changed (e.g. MIDs were added to the PDX account), the user can refresh
the MID information in PDX by clicking on the dropdown located in the top right corner of the
page (by the customer name) and selecting ‘Refresh the MIDs’.

Figure 15: Refresh the MIDs

Information will be displayed that the MIDs are being updated on the PDX account.

Figure 16: Updating MIDs informational message

2.6 Logout

To log out of the system, click on the dropdown located in the top right corner of the page and
select ‘Logout’. The session will be logged out and redirected to the BCG homepage.

Figure 17: Logout link

2.7 Help

Help is available via email or phone. Click on the ‘Help’ link in the top banner for contact
information.

Figure 18: Help link

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 27 of 28

2.8 Links

Also available in the top header are links to USPS.com and the Gateway (BCG landing page).

Figure 19: Links to the BCG and USPS.com

2.9 Support Information

Questions or comments can be sent directly to the PDX team via [email protected].
Alternatively, the USPS help desk can be reached at: (800) 522-9085.

2.10 Resetting Passwords

If your BCG CAT password has expired (e.g., your PDX CAT API requests fail authentication), it
must be reset.

To reset your BCG password, please contact the USPS help desk at: (800) 522-9085.
During business hours, use option 3, then option 6.

Alternatively, access the Business Customer Gateway CAT via https://gateway-cat.usps.com,

enter the account name above and click on “Forgot your password?” (refer to the screenshot
below). Answer the security questions and follow the steps provided.

01/05/2022 Parcel Data Exchange (PDX) CAT Customer Guide Page 28 of 28