USPS Connector FAQs

These frequently asked questions cover the most common setup, shipping, and troubleshooting topics for the TeqStars USPS Connector. For help from our team, see USPS Connector Support Policy.

Getting Started

What does the USPS Connector do?

It connects your USPS account to Odoo. You get real-time rates and print labels from Odoo. When you validate a delivery order, Odoo sends the order details to USPS and gets back the shipping label, the tracking number, and the shipping cost.

Can I ship both domestic and international orders?

Yes. You can set up domestic and international delivery methods. On the delivery method, Mail Class holds the domestic services and Mail Class International holds the international services, such as First Class Package International Service, Priority Mail international, and Priority Mail Express International.

Can I connect more than one USPS account?

Yes. You can connect and set up multiple USPS accounts in the same Odoo database. Each account is its own shipping partner record with its own credentials.

Setup

Which USPS details do I need to connect my account?

Create a shipping partner record for your USPS account and fill in:

• Client ID and Client Secret.

• Customer Registration ID: the CRID, a USPS-generated number that identifies your business at a location.

• Mailer ID and Manifest Mailer ID: the MID that USPS assigns to a mail owner, mailing agent, or other service provider.

• Account Type: EPS, PERMIT, or METER.

• Account Number.

How do I get an access token?

Open your USPS shipping partner and click Generate New Token. The app fills in Access Token. The access token is a rotatable token that gives access to your USPS data, and the app uses it to rotate the token when it expires.

What is the Payment Token for?

The Payment Token authorizes payment in the label and international label requests. It also covers NSA contract rates and label MID ranges.

How do I switch between test and production?

Use the Environment field on the shipping partner. Turn it on only when your credentials are certified for production.

How do I set up a USPS delivery method?

1. Create a delivery method and set Provider to USPS.

2. Set Shipping Partner to configured USPS shipping partner

3. Open the Configuration tab.

4. Set Delivery Type to Domestic or International.

5. Set Mail Class or Mail Class International based on Delivery Type.

6. Set Processing Category, Rate Indicator, and Destination Entry Facility Type.

7. Set Price Type to Retail, Commercial, or Contract.

8. Set USPS Package Type Set appropriate package.

9. Set Custom Content Type Set appropriate content type.

What do Processing Category and Rate Indicator do?

They describe your mail piece to USPS. Processing Category holds options such as Letters, Flats, Machinable, and Non Standard. Rate Indicator is a rate ingredient that USPS uses to sort the piece into a pricing category when it calculates the price.

What do I fill in for international shipments?

Set Custom Content Type to what the package or envelope holds, for example Merchandise, Gift, Document, Commercial Sample, or Returned Goods. Use Content Comments to add a description of the content.

Daily Use

Can user pick USPS on sales orders and on the website?

Yes. You can use USPS delivery methods on sales orders and on your website. The Shipment Quote feature gives you accurate shipping cost estimates.

What happens when I validate a delivery order?

The app sends the shipment to USPS and creates the shipping label automatically. The delivery order gets the tracking number and the shipping cost. A message in the chatter confirms the shipment with its tracking number.

Can I ship one order in several packages?

Yes. You can use a single package or multiple packages for one order. For multiple packages, use the Put in Pack operation on the delivery order before you validate it. Odoo dynamically manage all packages.

How do I track or cancel a shipment?

Both work from the delivery order. Use the tracking feature to see the status and location of the shipment. You can cancel a shipment in USPS with a single click from Odoo.

Troubleshooting

I see "Sorry! USPS Tracking Number not found in delivery order!". What does it mean?

The delivery order has no USPS tracking number. Check that the shipment was created in USPS and that the tracking number appears on the delivery order.

I see "Missing tracking number or label data in the USPS response.". What should I do?

USPS answered, but the reply had no tracking number or no label. Check your delivery method settings and your account details, then try again.

I see "USPS error occurred". Where do I find the cause?

The message shows the error text that USPS returned. Read it to see which detail USPS rejected, fix it on the order, delivery method or the shipping partner, and try again.

I see an HTTP error, a request error, or "Failed to parse JSON response from USPS.". What should I check?

These messages mean the app could not get a valid reply from USPS. Check shipment details, your Client ID, Client Secret, and Environment. If the error stays, contact us as described in USPS Connector Support Policy.