Created : 15 April 2015
Last Modified : 3 November 2021
***********************************************************************************
Contents:
A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. CHANGES
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I. TROUBLESHOOTING
J. FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS
***********************************************************************************
A. SUMMARY
==========
Allow to have UPS realtime shipping option to the site.
***********************************************************************************
B. FILE STRUCTURE
===================
Files included in the zip are:
- $READ_ME_FIRST_UPS900.html
- shopa_ups_track.asp
- shopa_ups_track_license.asp
- shopajaxshippingzipcodecountry.asp
- shopupsincludes.asp
- shopUPSshippingajax.asp
- shopxmlhttp_ups.asp
- upsxmlrealinterface.asp
- upsxmlrealtime.asp
- admin\shopa_ups_admin_subs.asp
- admin\shopa_ups_configure.asp
- admin\shopa_ups_license_1.asp
- admin\shopa_ups_license_2.asp
- admin\shopa_ups_license_3.asp
- admin\shopa_ups_license_4.asp
- admin\shopa_ups_license_5.asp
- admin\shopa_ups_license_print.asp
- admin\shopa_ups_off.asp
- admin\shopa_ups_subs.asp
- admin\shopa_ups_track.asp
- admin\shopa_ups_track_license.asp
- admin\shopupscountries.asp
- admin\shopupsorigincountries.asp
- admin\shopupsstates.asp
- admin\ups_setup.asp
- admin\ups_setup_config.asp
- admin\ups_setup_process.asp
- admin\images\ups_logo.gif
- admin\images\ups_logo_small.gif
- admin\sqlscripts\ups\*
- plugins\shipping\shopajaxshipping.js
***********************************************************************************
C. INSTALLATION INSTRUCTION
============================
1. Upload all the files into your shopping cart folder.
2. Download your site file
shopshipping_subs.asp
to your local.
3. Please open the file shopshipping_subs.asp using notepad or text editor and locate this code:
'2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
If you can see this code already, then you do not need to modify this file and can skip to step 4.
However, if you CANNOT locate the above code, then please follow these:
3.a Locate this code (around line 11):
dim Shiptozip,shiptocountry, shipfromzip, shipfromzipUSPS
3.b BELOW it, please insert:
'2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
dim shiptostreet
3.c Locate this code (around line 21):
redim shippingmethods_latest(100)
redim shippingvalue_latest(100)
3.d Replace it, as below:
'2020.07.24 - Enhancement: Shipping: Better handling on Shipping array variables
dim shippingcount_org
shippingcount_org = shippingcount
if trim(shippingcount_org) = "" then
shippingcount_org = 0
end if
if not isnumeric(shippingcount_org) then
shippingcount_org = 0
end if
if csng(shippingcount_org) > 100 then
redim shippingmethods_latest(csng(shippingcount_org) + 10)
redim shippingvalue_latest(csng(shippingcount_org) + 10)
redim Preserve shippingvalues2(csng(shippingcount_org) + 10)
else
redim shippingmethods_latest(100)
redim shippingvalue_latest(100)
redim Preserve shippingvalues2(100)
end if
3.e Locate this code (around line 125):
function CheckShippingSetupExist(sfile)
3.f BEFORE it, please insert:
'2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
sub assign_shipping_parameters_UPS (Shiptostreet)
if trim(getsess("shipaddress")) = "" then
Shiptostreet = getsess("address")
else
Shiptostreet = getsess("shipaddress")
end if
end sub
3.g Save the file and upload to your site.
4. Download your site file shopcustomerform.asp to your local.
5. Please open the file shopcustomerform.asp using notepad or text editor and locate this code:
'2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
If you can see this code already, then you do not need to modify this file and can skip to next step (step 6).
However, if you CANNOT locate the above code, then please follow these:
5.a Locate this code (around line 318):
assign_shipping_parameters Shiptozip,shiptocountry,shipfromzip
5.b BELOW it, please insert:
'2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
assign_shipping_parameters_UPS ShiptoStreet
5.c Save the file and upload to your site.
6. Please open the file shopcustomerform.asp using notepad or text editor and locate this code:
6.a Locate this code (around line 307):
dim shippingmethods_latest(100), shippingvalue_latest(100), shippingvalues2(100)
6.b REPLACE it, with:
dim shippingmethods_latest(), shippingvalue_latest(), shippingvalues2()
6.c Save the file and upload to your site.
7. Log into super admin and execute setup file, eg: http://www.yourdomain.com/yourshoppingcartfolder/youradminfolder/ups_setup.asp
8. After setup the module, would be redirected Module configuration page for configure the module
NOTE:
- For certain countries eg Canada that needs to charge tax for the UPS rates, VPCart has a new feature called "Tax On Rates" that you can find in your UPS administration page (shopa_ups_configure.asp).
Please set "Tax On Rates" to Yes if you want UPS returned rates to include taxes/VAT/HST, duties and other charges that may apply to the shipment. Please only make sure you enable this if your UPS account is already applicable for tax.
=========================
How to get negotiable rates from UPS
=========================
To activate with "Negotiable rates", please follow the below steps:
1. Log into UPS.com with your User ID and password.
2. Click on the name on the top right hand side of the screen.
3. Select Accounts and Payment.
4a. If the account number is on this screen with an edit button on the right side of it.
4ai. Click Edit and you should be prompted to authenticate the account by providing the most recent invoice information for the account.
4b. If you do not have your account number listed here, then you need to select Add existing account from Add a Payment Methods dropdown, and click Add button.
4bi. Fill in the following information:
Choose "Documents and Packages"
Account Number: Your UPS account number
Nickname: UPS VPCart
Fill in your Country:
Postal Code for Pickup Address:
4bii. Select a method to verify the account.
4biii. Add your payment method
5. Once your account is validated you will start seeing the negotiated rates.
================================
Why my UPS is showing high rates than UPS site
============================== ==
You will need to check these two UPS settings in your VPCart shipping administration:
1. "Allow certain products to be shipped separately?" needs to set to No.
2. "Pick-up type" needs to set to "Suggested Retail Rate (UPS Store)".
***********************************************************************************
D. CHANGES
===============
2021.08.20 - Update License and Register endpoints
***********************************************************************************
E. CONFIGURATION SETTINGS
=================
NONE
F. DATABASE TABLES MODIFIED
===========================
NONE
NONE
2015.05.08 - Bug Fix: UPS: Error if weight is more than 150 lbs
2016.02.01 - Enhancement: Must always commit transaction if execute sql execute
2016.02.03 - XML: To support TLS1.2
2016.02.24 - Better XML routines naming
2016.09.13 - UPS: Better code effieciency, Ajax and Non-Ajax has same flow on dimensions, individual package calculation
2016.12.13 - Renamed UPS Next Day Air Early AM to UPS Next Day Air Early
2017.12.07 - UPS - Should attempt 2nd time automatically if 1st time getting xmlerror
2018.09.01 - Compatible with v9
2019.08.08 - Supporting TaxInformationIndicator
2019.09.19 - Fix for Residential/Commercial address. Include passing destination street and city to UPS for auto address classification.
2020.06.29 - UPS - should ignore routine CheckDeliverySelf if xIndividualPackages or xcheckIndividualProduct set to Yes
'2020.07.24 - Enhancement: Shipping: Better handling on Shipping array variables
'2020.08.05 - UPS: Much more efficiency when xautoseparateweight is enabled
***********************************************************************************
I. TROUBLESHOOTING
============================
Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.
***********************************************************************************
J. FAQ
============================
NONE
***********************************************************************************
K. COPYRIGHT NOTICE
============================
Copyright (c) 1999-2023 Rocksalt International Pty. Ltd.
All rights reserved.
This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .
LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.
Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.
***********************************************************************************
L. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.
THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.
LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.
LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.
LIMITATION OF LIABILITY.
ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.
IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.