Preferences
You need to set up an Endicia account to be able to create USPS labels, or if you already have an Endicia account through our app then all you need is your Username and Pass Phrase.
Add Existing Account
Make sure you switch the toggle as you see highlighted below, you can then add your existing account details.
Please be aware that this only works if you are already using Endicia or have already set up an account via the two below methods.
Create a new Endicia Account via link
Utilize this link to create a new account with Endicia, which automatically ensures that the Endicia account that you set up will work via our app.
Once you have filled in all the details on the Endicia website, you will be sent a username. Please contact Endicia support for them to activate this account.
Once you have followed these two above steps you can safely add your new account using the Existing Account toggle.
Create a new Endicia Account via the app
Fill in the Endicia Account requirements as you can see here:
When filling in the Credit Card details make sure that your Billing Address matches what your bank has on file.
USPS-Endicia Test Credentials
If you don not have an Endicia account yet but would like to test the functionalities you can request test credentials from us.
Service Types
| Service Types | Value | Description |
|---|---|---|
| First | First | This service is an affordable and easy way to send envelopes and lightweight packages, with delivery in 1-3 business days. |
| Priority | Priority | This service includes tracking and delivery in 1-3 business days. |
| Priority Express | PriorityExpress | This overnight service has competitive prices and fast delivery every day, all year, with limited exceptions, to most U.S. addresses and PO Boxes. |
| Library Mail | LibraryMail | An economical shipping solution for qualified items to be mailed between academic institutions, public libraries, museums and other qualified organizations. |
| Media Mail | MediaMail | A ground shipping solution for media items like books, sound recordings, recorded video tapes, printed music, and recorded computer-readable media (such as CDs and DVDs) |
| Standard Post | StandardPost | USPS® standard and express mail services allow you to choose delivery options that fit your needs. |
| Parcel Select | ParcelSelect | An economical ground delivery service designed for large and medium sized shippers. |
| Critical Mail | CriticalMail | Critical Mail is tailored for customers requiring cost-effective mailing solutions for important documents in many types of businesses. |
| First Class Package International Service | FirstClassPackageInternationalService | An economical way to send lightweight packages to more than 190 countries. Packages can weigh up to 4 lbs but must not be more than $400 in value. |
| First Class Mail International | FirstClassMailInternational | This service is the most affordable way to send letters and lightweight packages to more than 190 countries. |
| Priority Mail International | PriorityMailInternational | This service is a reliable and affordable way to ship to more than 190 countries. Use free Flat Rate Boxes and Envelopes to pay one price, regardless of box weight, up to 70 lbs. |
| Express Mail International | ExpressMailInternational | This service is a reliable, high-speed mail service available to more than 190 countries and an average delivery of 3 to 5 business days. |
| Priority Mail Express International | PriorityMailExpressInternational | This service is a reliable, high-speed mail service available to more than 190 countries and an average delivery of 3 to 5 business days. |
| Global Express Guaranteed | GXG | With this service shipments are delivered in 1–3 business days to more than 190 countries, with overnight delivery to many places in Canada. |
Packaging Types
| Packaging Types | Value | |
|---|---|---|
| Card | Card | |
| Letter | Letter | |
| Flat | Flat | |
| Parcel | Parcel | |
| Large Parcel | LargeParcel | |
| Irregular Parcel | IrregularParcel | |
| Flat Rate Envelope | FlatRateEnvelope | |
| Flat Rate Legal Envelope | FlatRateLegalEnvelope | |
| Flat Rate Padded Envelope | FlatRatePaddedEnvelope | |
| Flat Rate Gift Card Envelope | FlatRateGiftCardEnvelope | |
| Flat Rate Window Envelope | FlatRateWindowEnvelope | |
| Flat Rate Cardboard Envelope | FlatRateCardboardEnvelope | |
| Small Flat Rate Envelope | SmallFlatRateEnvelope | |
| Small Flat Rate Box | SmallFlatRateBox | |
| Medium Flat Rate Box | MediumFlatRateBox | |
| Large Flat Rate Box | LargeFlatRateBox | |
| DVD Flat Rate Box | DVDFlatRateBox | |
| Large Video Flat Rate Box | LargeVideoFlatRateBox | |
| Regional Rate Box A | RegionalRateBoxA | |
| Regional Rate Box B | RegionalRateBoxB | |
| Regional Rate Box C | RegionalRateBoxC | |
| Large Flat Rate Board Game Box | LargeFlatRateBoardGameBox |
Returns
It is possible to create returns shipments with Endicia.
Endicia Pay-on-Use Returns™
Pay-on-Use Returns™ allows you to create return shipments and only get charged for them if the return label is used. To use this service you will need to enable it on your Endicia account.
If the service is enabled, you will be able to select it in the Shipping Wizard under the Preference section.
You can also default this from the Custom Address Source by adding "EndiciaPayOnUse" to the Shipment Type.
Special Services
These are special services offered by the carrier which can be selected either during the Shipment creation, or can be defaulted in the Custom Address Source. In this section you can find the most commonly used services.
Certified Mail
This service provides the sender with a mailing receipt and electronic verification that an article was delivered or that a delivery attempt was made. This service is available with the following package and service types:
- Letter - First
- Parcel - First
- Parcel - Priority
- Flat - First
- Flat - Priority
Certified Mail is a checkbox field, which requires TRUE value.
Signature Confirmation
When selecting this service you'll be provided the signature and name of the recipient, the date, time and location of the delivery.
Adult Signature Required/Restricted Delivery
The Adult Signature Required service ensures that the recipient of the mail items is at least 21 years of
age or above. The
recipient or a resident of the recipient’s address is required to show a form of photo identification to
the delivery employee for age confirmation.
The Adult Signature Restricted Delivery service requires the signature of the addressee only, who must
be 21 years of age or older.
Electronic Return Receipt
The Electronic Return Receipt provides the mailer with evidence of delivery (to whom the mail was delivered and date of delivery), along with information about the recipient's actual delivery address.
Registered Mail
This service provides additional protection and security in dispatch and conveyance within the United States. This service is available with First-Class Mail International and First-Class Package International services.
International Shipping
In this section you'll find the required or recommended fields and settings for international shipments.
Mandatory fields for Customs items
- Description
- Quantity
- Weight
- Unit price
- Country
- Harmonised Code
If you plan to automate the shipment creation, then for international shipments the Contents
Type and Non
Delivery options need to be defaulted in the Custom Address Source.
The values for Non Delivery are Abandon or Return.
Commercial Invoice
With Endicia the commercial invoice for international shipments will be included in the label.
Example of an international label for Priority Mail International:
The Customs Form information can be populated in the Shipping Wizard under the International Details or from the Custom Address Source under the Carrier Specific Settings.
Contents Type
You can select from the following options: Merchandise, Returned Goods, Documents, Gift, Sample, Other. (API values are the same.)
Restriction Type
You can select from the following options: None, Other, Quarantine, Sanitary Phytosanitary Inspection.
Non Delivery
You can select from the following options: Return, Abandon.
Sender's and Importer's Customs Reference
You can input the sender's and/or recipient's customs information here.
Label Formats
The available label formats can be usually grouped into two types: thermal and non-thermal labels.
| Description | Values |
|---|---|
|
|
| PNG |
|
| GIF |
|
| JPEG |
|
| EPL2 |
|
| ZPLII |
|
Error Messages
In this section you can find the most common error messages, what they mean and how to solve them.
ZIP4 Data Value too large
This error usually occurs on older versions of the Multi-carrier application. See this guide.
'IO Exception: Read time out' or 'The remote computer refused the network connection. Error encountered (Log ID: xxxxx)
These error messages usually appear when there is an Endicia server outage.
Solution: please try again later.
"Failed to receive a valid Account ID" or "Account ID XYZ is invalid. Error encountered"
Please make sure you are using the latest version of the application and Demo mode is turned off.
"List index out of bounds: 0"
This error usually occurs when the Endicia account does not have USPS web tools enabled. To solve the issue you need to register and then enable USPS web tools.
- Create a USPS Online Tools ID by clicking "Register Now".
- Once you have the User ID log back into Salesforce.
- Go to Setup > Custom Settings > Zenkraft General Settings, then click Manage, then Edit.
- Check the "USPS Tracking" checkbox and enter the web tools Used ID to the "USPS Web API UsedID" field.
- Save your changes. All USPS shipments will now be tracked using USPS Web Tools via the Track Shipment button and Scheduled Tracking.
"Missing or invalid element: WeightOz. Error encountered"
A common cause for this error message is if the weight has two decimal or more decimal places. USPS-Endicia only allows for one decimal place in the weight. You either need to round the weight manually to the closest one decimal place or use a ROUND formula to do that. From v108 onwards this is done automatically.
"Invalid PIC received: xxxxxxxxxxxxxxxxx"
This error usually occurs when the shipment was generated using First Class service, as it is not possible to track first class shipments.
Common Questions
In this section you can find our most commonly asked questions regarding this carrier. If you have a question not listed here please contact us.
Can I track a shipment created outside of Salesforce using a different account?
It is possible to track shipments created outside of Salesforce using a different account if you
have the USPS Web API enabled.
Adding the web tools ID also helps if you are not getting or only
getting partial tracking response.
- Create a USPS Online Tools ID by clicking "Register Now".
- Once you have the User ID add it to the app.
-
- v1.113 and below: Go to Setup > Custom Settings > Zenkraft General Settings, then click Manage, then Edit. Check the "USPS Tracking" checkbox and enter the web tools Used ID to the "USPS Web API UsedID" field.
- v1.114 and above: Go to Zenkraft Settings (v1.114 and below or v1.129 and above) or
Bringg Settings (v1.118-v1.128) > Other settings and enable USPS-Tracking and enter the web tools ID.
- Save your changes. All USPS shipments will now be tracked using USPS Web Tools via the Track Shipment button and Scheduled Tracking.
If you are still unable to track these shipments please follow the below steps to obtain Package Tracking API (API=TrackV2) access.
- Navigate to https://usps.force.com/emailus/s/web-tools-inquiry
- Provide user name (Web Tools User ID)
- Select “Tracking APIs”
- Select “Track API”
- Submit the request with the following information below in the “Additional Information” text
box:
- Web Tools UserID:
- Mailer ID (MID):
- Company Name:
- Requester First and Last Name:
- Requester Email:
- Requester Phone number:
- Mailing Address:
- Mailing City:
- Mailing State:
- Mailing Zip Code:
- PROD Registration Date:
- API access requested:
- Package Tracking (API=TrackV2)
- Anticipated volume:
- Any additional information from the customer:
How can I change the credit card linked to my Endicia account?
To change your credit card linked to your account follow this guide.
Where can I check my Endicia account status and add money to my account?
To check your account status or add credit to it follow this guide.
How can I change the contact information for my Endicia account?
To change your contact information linked to your account follow this guide.
How can I change my Endicia Passphrase?
To change your Endicia Passphrase follow this guide.
Can I hide the sender address when creating a Shipment?
You can very easily remove/hide the sender address when you are creating a USPS shipment.
If you are on the wizard page, under the Sender section you can check the checkbox.
You can also automate this when by adding USPS - Endicia: Hide Sender Address under Specific Carrier Fields in the Custom Address Source.
Can I request shipping quote via the lightning quote button for USPS?
It is possible to request rates for shipping, however make sure to have USPS - Endicia: Weight Units set in the custom address source used for quoting.
