--------------------------------------------------------------

--------------------------------------------------------------

Created : 16 October 2019
Last Modified : 23 October 2019

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

A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW IT WORKS
E. FILE NEED TO BE MODIFIED
F. CONFIGURATION SETTINGS
G. DATABASE TABLES MODIFIED
H. LANGUAGE SETTINGS CHANGED
I. CHANGE LOGS
J.
TROUBLESHOOTING
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS

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

A. SUMMARY
==========
This module is a 3rd party Accounting tool.

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

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

Files included in the zip are:
- $readme_xero900.html
- admin\shop_xero_sub.asp
- admin\shop_xeroajax.asp
- admin\shop_xeroconnect.asp
- admin\shop_xerosettings.asp
- admin\shop_xerosync.asp
- admin\shopa_formatorder.asp
- admin\xero_setup.asp
- admin\xero_setup_config.asp
- admin\xero_setup_process.asp
- admin\sqlscripts\xero\*
- admin\modules\xero\*

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

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

1. Backup and Rename your admin\shopa_formatorder.asp to something like admin\shopa_formatorder.asp.bak.

2. Upload below file(s) to VPCart admin folder.
    - shop_xero_sub.asp
    - shop_xeroajax.asp
    - shop_xeroconnect.asp
    - shop_xerosettings.asp
    - shop_xerosync.asp
    - shopa_formatorder.asp
    - xero_setup.asp
    - xero_setup_config.asp
    - xero_setup_process.asp
    - sqlscripts\xero\*
    - modules\xero\*

2a. Upload below file(s) to your ADMIN folder. If you have renamed your ADMIN folder, then this must be placed in the       renamed folder.
    - admin\shop_xero_sub.asp
    - admin\shop_xeroajax.asp
    - admin\shop_xeroconnect.asp
    - admin\shop_xerosettings.asp
    - admin\shop_xerosync.asp
    - admin\shopa_formatorder.asp
    - admin\xero_setup.asp
    - admin\xero_setup_config.asp
    - admin\xero_setup_process.asp
    - admin\sqlscripts\xero\*
    - admin\modules\xero\*
3. Log into super admin and execute setup file xero_setup.asp, eg: http://www.yourdomain.com/youradminfolder/xero_setup.asp

Note: Replace url section with your v9 site url values:
{ www.yourdomain.com } : your site domain
{ youradminfolder } : your admin folder

4. After installing the module, It would be redirected to Xero Module configuration page for configure the module. ( admin/shopa_modules_configuredetails.asp?modulesname=xero )

NOTE:
you will need to access your module cartmonkey account (http://modules.cartmonkey.com/) to get api keys ( http://modules.cartmonkey.com/shopmodules.asp )

BETA KEYS:

k8969o2jqfn4sr81vs06ud

gb2t4edzfznrkxwbt1ui5

4.1 Copy and paste the Token and Secret key from modules.cartmonkey.com to xero module configuration page ( http://www.yourdomain.com/youradminfolder/admin/shopa_modules_configuredetails.asp?modulesname=xero )

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

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

Register an Account

1. Register here https://www.xero.com/signup/?xtid=x30vpcart
Note: Make sure you created your account after you first logged in your xero account.

ACCESSING XERO MODULE

1. Go to Module Manager ( admin/shopa_editdisplay.asp?page=1&table=addoninfo ) and look for xero module. Click the first edit (pencil) Icon.

2. It will redirect you to Xero Connect landing page.

LOGGING IN YOUR ACCOUNT

1. in Xero Connect Landing page ( youradminfolder/shop_xeroconnect.asp ), Press the "Click Here" Button to login your account.

2. Xero popup Login page will show. Input your username and password.


2. allow access permission for your vpcart admin store to have access to your xero account.


NOTE: the access permission will last to 30mins. Once It exceed to 30mins, It will redirect you to page where you can re-allow access to your vpcart admin.


3. after allowing the access permission to the following pages:

3.1 It will redirect you to shop_xerosettings.asp (if this will be your first time to login your account for your vpcart store or if you haven't finish setting up xero account mapping for syncing process )

3.2 will proceed to point no.4, if you have finish setting up account mapping

4. It redirect you to shop_xerosync.asp for you to be able to sync customer,products and orders to your Xero Account

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

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

New configs :
xxero_enable
xxero_appsecret
xxero_apptoken

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

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

NONE

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

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

langreadysynced
langaccountsrequired
langordersreadysync
langnopendingpayment
langpaymentreadysync
langnopendingrefund
langrefundreadysync
langunproccessedrefund
langinvoicedsynced
langpaymentsynced
langcredinotesynced
langxero_disabled_alert
langxero_app_details_missing

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

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

NONE

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

I. TROUBLESHOOTING
============================

1. Why did the module not working fail?

2. Xero Module still does not work !
Please submit a ticket to our helpdesk at https://helpdesk.vpasp.com and our support team will assist you.

***********************************************************************************
J. COPYRIGHT NOTICE
============================

Copyright (c) 1999-2019 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.