EasyPost

Created : 12 May 2021
Last Modified : 17 October 2022

***********************************************************************************
Contents:

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW IT WORKS
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
==========
This interface is for providing shipping options by EasyPost.

***********************************************************************************

B. FILE STRUCTURE
===================

Files included in the zip are:
- $READ_ME_FIRST_easypost900.HTML
- easypost.asp
- easypost_base64.asp
- easypost_xmlhttp.asp
- shopajaxshippingeasypost_subs.asp
- admin/easypost_setup.asp
- admin/easypost_setup_config.asp
- admin/easypost_setup_process.asp
- admin/shopa_easypost_base64.asp
- admin/shopa_easypost_config.asp
- admin/shopa_easypost_subs.asp
- admin/shopa_easypost_xmlhttp.asp
- admin/help/shoph_easypost.asp
- admin/js/easypost/easypost.css
- admin/js/easypost/easypost.js
- admin/images/easypost/*
- admin/sqlscripts/easypost/*

***********************************************************************************

C. INSTALLATION INSTRUCTION
============================

1. Modify below file:
1a. Open shopshipping_subs.asp

1b. Locate this code:
<!-- #include file="shopajaxshippingfedexsubs.asp" -->

After this code, please insert:
<!-- #include file="shopajaxshippingeasypost_subs.asp" -->

1c. Lote these codes:
if check_fedex_shipping_exist then
dyninclude "fedexinterface.asp"
GetShippingPricesFedex
end if

After these codes, please insert:
'easypost
if easypost_enable then
dim totalweight_easypost
GetShippingPrices_easypost totalweight_easypost
end if

2. Upload the below files to your ADMIN folder. If you have renamed your ADMIN folder, then this must be placed in the renamed folder.
- easypost.asp
- easypost_base64.asp
- easypost_xmlhttp.asp
- shopajaxshippingeasypost_subs.asp
- admin/easypost_setup.asp
- admin/easypost_setup_config.asp
- admin/easypost_setup_process.asp
- admin/shopa_easypost_base64.asp
- admin/shopa_easypost_config.asp
- admin/shopa_easypost_subs.asp
- admin/shopa_easypost_xmlhttp.asp
- admin/help/shoph_easypost.asp
- admin/js/easypost/easypost.css
- admin/js/easypost/easypost.js
- admin/images/easypost/*
- admin/sqlscripts/easypost/*

3. Log into super admin and execute page below:
http://www.yourdomain.com/<your admin folder>/easypost_setup.asp

Note: Replace the below with your VPCart site
{ www.yourdomain.com } : your site domain
{ your admin folder } : your admin folder

Click Install Now button.

4. After installation completed, click Next button:

5. You will be redirected to EasyPost configuration page.


EasyPost settings:

- How to register with EasyPost?
Before setting up with EasyPost, you are required to register with EasyPost.

Please follow below guide to register with EasyPost.

1. Browse EasyPost website.

2. Click "SIGN UP FREE" button.

3. Fill in information with VALID email address. Click on "SIGN UP FREE" button.

4. You should receive an email after sign up. You are required to click the link for verification.

- Do you want to enable EasyPost module?
Set to Yes to enable EasyPost module.


- Do you want to run in trace mode?
Set to Yes to enable trace mode for developer purpose.


- Do you want to run in test mode?

Set to Yes to enable test mode.


- How to get API Keys?

Please follow below guide to retrieve EasyPost API keys:

1. Log in to EasyPost with your email address and password.

2. After loggen into the account, click on your email address that under EasyPost logo and click on API Keys.

3. Click "copy" from "Production API Keys" section, and paste to "Production API keys" field.

4. Click "copy" from "Test API Keys" section, and paste to "Test API keys" field.



- How to create/update carrier accounts with EasyPost?
You can create/update the carrier accounts with EasyPost.

Please follow below guide to create/update carrier accounts with EasyPost.

1. Log in to EasyPost with your email address and password.

2. After loggen into the account, click on your email address that under EasyPost logo and click on Carrier Accounts.

3. Each EasyPost account is automatically provided a USPS account managed by EasyPost.

4. How to create/link with UPS account: You can create UPS account by click "CREATE ACCOUNT" or link with your existing UPS account by click "I ALREADY HAVE AN ACCOUNT" from UPS section.

5. How to create/link with other carrier accounts: You can create or link carrier accounts by selecting the carrier providers from the list.

6. After creating/linking carrier accounts with EasyPost, you can select the carrier providers from the EasyPost configuraitons page. Simply check the providers to activate the shipping options provided by the selected carriers.


- Setup source profile
1. Please fill in your company and address information where your shipping source from.

2. You may set to Yes to field "Do you want to use supplier address as source address?", if you would like to send your items from your suppliers.


- Setup dimension profile - global
1. Please fill in your parcel width, lenght and height under this section.


- Setup dimension profile - individual product
1. You may setup the dynamic parcel width, length and height according to each product, by select the products fields that carry the information of width, length and height.


- Miscellaneous

- Do you want to allow all products to be shipped separately?
Set to Yes to ship all products sparately.

- Do you want to allow certain product to be shipped separately?
Set to Yes to ship certain product sparately.

- What is the field specified in products table to identify to ship product separately?
A field in products table to identify the product to be shipped separately.

- Do you want to split packages automatically if over certain weight?
Set to Yes to split packages automatically.

- What is your weight (lbs) to split packages automatically?
The weight to split packages automatically.


***********************************************************************************

D. HOW IT WORKS
===============

Provide shipping options from different shipping providers.

***********************************************************************************

E. CONFIGURATION SETTINGS
=================

Refer to EasyPost configuraiton page

F. DATABASE TABLES MODIFIED
===========================

NONE


G. LANGUAGE SETTINGS CHANGED
============================

New languages for EasyPost

H. CHANGE LOGS
============================

2021.11.05 - EasyPost: To include drop off options
2021.11.05 - EasyPost: To set simpe custom infos for shipment
2021.11.05 - EasyPost: Better handling on showing carriers rates
2021.11.05 - EasyPost: Better total weight calculation for group calculation
2021-11.09 - EasyPost: should always convert lbs to ounces
2022.05.23 - EasyPost: Better handling if both API keys are empty and wrong error on carrier accounts
2022.10.17 - EasyPost: Bug Fix: conflict with other shipping providers

***********************************************************************************

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.