USPS Integration via USPS Business Customer Gateway

Article last modified: 2019-03-14

The following information should be considered preliminary and in beta. Shipping programs and the shipping library must be released after 11/6/2024. 

The following steps are needed to integrate the shipping with USPS through their Business Customer Gateway. 

The USPS Business Customer Gateway can be found at https://gateway-cat.usps.com/eAdmin/view/signin

1. Sign up for an account

To open an USPS BCG account follow the link to "Signup for the BCG" on the main page or follow this link :

https://catpx-custreg.usps.com/entreg/RegistrationGatewayAction_input

2. Log in and Create an APP

Log in to the USPS Developer Portal using the CAT USPS Business Account you created in Step 1.

After logging into the Developer Portal, click the Apps button from the Menu Bar and complete the following steps to create an App:

  1. Click "Add App"
  2. Enter your App Name (required)  - Enter CadacusSolutions
  3. Enter your Callback URL (optional) - This can be left blank
  4. Check the box to accept Terms and Conditions and Privacy Policy
  5. Enter Description (optional)
  6. Select API Product (required): "Shipping Version 3"
  7. Click "Add App"

3. Retrieve your Consumer Key and Secret

Select your App and retrieve your Consumer Key and Consumer Secret from the Credentials section. These credentials are required for the next step.

4. Request App Authorization

The Payments API, Domestic Labels API, and International Labels API require your app to be linked to the default USPS test credentials. Before testing these APIs, you will need to send your Consumer Key (client_id) to This email address is being protected from spambots. You need JavaScript enabled to view it. with the subject of ‘Authorize CAT App’ to request this authorization.

Note : Consumer Key and Secret are not interchangeable between Test and Production environments.

Note : When signed into the developer portal, "Access denied" may be displayed, but the "Apps" menu items still work.

Load Address Verification Table

In SYSPRO, select "Address Information Verification" from the Cross-Reference Menu on the EDI Menu.  Select "Import" and then "Import All Pre-Set Information".

Import Carrier Information

Select "Carrier Information" from the Cross-Reference Menu on the EDI Menu.  Select "Import" and then either "Import USPS Information" or "Import All Pre-Set Information".

Import Service Information

Select "Carrier Service Information" from the Cross-Reference Menu on the EDI Menu.  Select "Import" and then either "Import USPS Information" or "Import All Pre-Set Information".  Do not change or add services to the list.  If a service is missing, contact technical support for an update.

Add USPS Account

  1. Select "Carrier Account Information" from the Cross-Reference Menu on the EDI Menu.
  2. Click the ADD button.
  3. Enter "USPS" for the SCAC code.
  4. For the account code, enter something to describe the account ("GENERAL", "WAREHSE1", etc.).
  5. Enter a description for the account
  6. Enable the use of webservices for US and international shipments
  7. Enter a phone number that will be used in case there is no phone number on the A/R account. 
  8. Go to the "USPS via Direct API" tab
  9. Enable the interface with the checkbox
  10. Enter all the information from USPS into the appropriate locations>
  11. Click Save and Close

Add Printers

Select "Label Printers" from the Cross-Reference Menu on the EDI Menu. For each label printer, click add and enter a Printer Code to define the printer.  Complete the rest of the form with the required information.

Download the Cadacus Support System installation program to the workstations and run the installation.  This interface is required to access the scales and printers

Note:  The Shipping system bypasses the Windows printer drivers.  Therefore the printer can be setup using the Windows "Generic Text-Only" printer drivers. 

Setup the account/printer cross-reference

Select "Account/Printer Selection" from the Cross-Reference Menu on the EDI Menu. At a minimum enter USPS for the SCAC code. Then select the proper account code and printer code to use.

Connect the SYSPRO Ship-Via's to the USPS service

It is recommended that coded Ship-Via's be used within SYSPRO.

Select "Ship-Via to SCAC and Carrier Information" from the Cross-Reference Menu on the EDI Menu. Leave the "Trading Partner" field blank and enter a ship-via.  Select "USPS" from the carrier list below and the Name and SCAC will be filled in automatically. Go to the "Service Information" tab and select the service to match the ship-via. Set any of the other parameters as necessary.  Do not enter an account code.

Solutions

Tutorials