Difference between revisions of "X-Cart:USPS"

From X-Cart 4 Classic
Jump to: navigation, search
Line 3: Line 3:
 
1. If you haven't yet done so, provide your own company address in the '<u>General settings->Company options</u>' section. Make sure you provide this address correctly - it will be submitted to the real-time shipping calculator as the origin address for all shipments from your store and thus will affect the shipping rates.
 
1. If you haven't yet done so, provide your own company address in the '<u>General settings->Company options</u>' section. Make sure you provide this address correctly - it will be submitted to the real-time shipping calculator as the origin address for all shipments from your store and thus will affect the shipping rates.
  
2. Obtain an account with USPS (sign up at [http://www.uspswebtools.com/registration/ http://www.uspswebtools.com/registration/]). You will receive an email with your username, password and the test server name. Reply to the email you received and tell them that you would like to be moved to the production server because you are using X-Cart and that it doesn't work with the test server. You may get a response asking which API you are using. Tell them you are using the Rates Calculator. You will receive another email with the production server name, which is also not completely correct, so don't enter that in X-Cart either.
+
2. Obtain an account with USPS (sign up at http://www.uspswebtools.com/registration/). You will receive an email with your username, password and the test server name. Reply to the email you received and tell them that you would like to be moved to the production server because you are using X-Cart and that it doesn't work with the test server. You may get a response asking which API you are using. Tell them you are using the Rates Calculator. You will receive another email with the production server name, which is also not completely correct, so don't enter that in X-Cart either.
  
 
3. Enable your store to use the real-time shipping calculator provided by USPS:
 
3. Enable your store to use the real-time shipping calculator provided by USPS:
Line 24: Line 24:
 
{{Note1|Note: Since USPS bases their rates on weight, make sure you have a weight assigned to all of your products. It defaults to lbs, so if you are using ounces be sure to change the conversion in General Settings.}}
 
{{Note1|Note: Since USPS bases their rates on weight, make sure you have a weight assigned to all of your products. It defaults to lbs, so if you are using ounces be sure to change the conversion in General Settings.}}
  
That is all. Now you can test whether your store can receive real-time shipping rates correctly. For details, see the chapter [http://www.x-cart.com/xcart_manual/online/testing_real_time_shipping.htm 'Testing your store's ability to receive real-time shipping rates]' further in this manual.
+
That is all. Now you can test whether your store can receive real-time shipping rates correctly. For details, see the chapter [[X-Cart:Testing your store's ability to receive real-time shipping rates]] further in this manual.
 +
 
 +
==Troubleshooting==
 +
 
 +
===API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol===
 +
 
 +
The following error message is received when trying to generate the  USPS shipping labels :
 +
 
 +
<pre>
 +
USPS server returned the following errors during the transaction:
 +
ExpressMail #1: API Authorization failure. ExpressMailLabel is not a valid API name for this protocol.
 +
ExpressMail #2: API Authorization failure. ExpressMailLabel is not a valid API name for this protocol.
 +
DeliveryConfirmation #1: API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol.
 +
DeliveryConfirmation #2: API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol.
 +
</pre>
 +
 
 +
This means that the USPS account sholud be in live mode and the  DeliveryConfirmationV3 API must be enabled. This can be done on the USPS side,so please contact the USPS support.
 +
 
 +
This error may also appear if the shipping labels are generated in test mode (there is such an option in X-Cart), you should try to get them for real orders.
  
 
[[Category:X-Cart user manual]]
 
[[Category:X-Cart user manual]]

Revision as of 15:00, 2 February 2010

To set up shipping cost calculation through USPS real-time shipping calculator, follow these steps:

1. If you haven't yet done so, provide your own company address in the 'General settings->Company options' section. Make sure you provide this address correctly - it will be submitted to the real-time shipping calculator as the origin address for all shipments from your store and thus will affect the shipping rates.

2. Obtain an account with USPS (sign up at http://www.uspswebtools.com/registration/). You will receive an email with your username, password and the test server name. Reply to the email you received and tell them that you would like to be moved to the production server because you are using X-Cart and that it doesn't work with the test server. You may get a response asking which API you are using. Tell them you are using the Rates Calculator. You will receive another email with the production server name, which is also not completely correct, so don't enter that in X-Cart either.

3. Enable your store to use the real-time shipping calculator provided by USPS:

a. In your store's Admin area, go to the 'General settings->Shipping options' section.
b. On the 'General settings->Shipping options' page, select the check box 'Enable real-time shipping calculation'. Unselect the check box 'Use Intershipper calculation service'.
c. Use the 'U.S.P.S account details' subsection of 'General settings->Shipping options' page to provide the required information.
  • USPS Server name: production.shippingapis.com
  • Web Tools User ID: the name you were sent in the email
d. Click Save.

4. Adjust USPS options:

a. Go to the 'Shipping methods' section of your store's Admin area (Settings menu->Shipping methods).
b. Find USPS in the list of real-time shipping methods and click the Options >> link opposite it. A dialog box with USPS options opens.
Usps opts.gif
c. Adjust the options according to your preferences.
d. Click the Apply button.
Note: Since USPS bases their rates on weight, make sure you have a weight assigned to all of your products. It defaults to lbs, so if you are using ounces be sure to change the conversion in General Settings.

That is all. Now you can test whether your store can receive real-time shipping rates correctly. For details, see the chapter X-Cart:Testing your store's ability to receive real-time shipping rates further in this manual.

Troubleshooting

API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol

The following error message is received when trying to generate the USPS shipping labels :

USPS server returned the following errors during the transaction:
ExpressMail #1: API Authorization failure. ExpressMailLabel is not a valid API name for this protocol.
ExpressMail #2: API Authorization failure. ExpressMailLabel is not a valid API name for this protocol.
DeliveryConfirmation #1: API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol.
DeliveryConfirmation #2: API Authorization failure. DeliveryConfirmationV3 is not a valid API name for this protocol.

This means that the USPS account sholud be in live mode and the DeliveryConfirmationV3 API must be enabled. This can be done on the USPS side,so please contact the USPS support.

This error may also appear if the shipping labels are generated in test mode (there is such an option in X-Cart), you should try to get them for real orders.