This document is designed to guide you through the process of integrating your XPS Ship account with OSCommerce.
Moving the downloaded files within the OSCommerce catalog directory folder is beyond the XPS scope of support. We recommend you contact your store developer or OSCommerce Support if you need assistance with the installation process, as the process can differ based on the unique configuration of other OSCommerce directories.
To begin, download the OSCommerce add-on. Click the link below or copy and paste it into your browser:
http://addons.oscommerce.com/info/9406
Unzip the downloaded file and move the internal files as indicated:
Move the ordersapiend.php to the catalog directory of your OSCommerce installation.
Move the ordersapi.php to the catalog/includes/modules/order_total/ directory.
Move the lang_ordersapi.php to the catalog/includes/languages/english/modules/order_total/ directory and rename lang_ordersapi.php to ordersapi.php
Login to the admin side of your OSCommerce installation.
Select the Modules menu from the left side of the screen and select "Order Total".
Select "+ Install-Module" from the top right of the page.
Select “+ Install-Module" again within the info box. This will generate your API Key.
Select "Edit" in the info box.
The system will have generated a random API key for you. Copy the API Key, as you will need it to paste into your OSCommerce Integration settings for XPS in a later step. If you want to use another key, paste it into the API key box and select save. Otherwise, copy the key and select cancel.
Add an OSCommerce Integration
Open a new browser window and log in to your XPS Ship Account.
Select the Settings tab.
Under “eCommerce” select “eCommerce Integrations”.
Select "Add eCommerce Integration".
Select OSCommerce.
General Settings
Add an Integration Name, “OSCommerce” will be the default, but it can be changed to anything you’d like.
Check the box if you want to have a confirmation email sent when orders are fulfilled.
By default, the Active box will be checked.
Check the box if you want to Skip address Pre-Verification on orders.
Check the box “Include Packing slips in confirmation email” if you’d like the packing slips included with the confirmation email once labels have been generated.
OSCommerce Settings
Enter your Store URL.
Enter the Key you generated earlier.
Additional settings are available related to the Sender and Return To address. Edit if necessary to your integration.
When finished, select "Save New Integration".
When the integration has been saved, you will see that the connection has been established at the top of the page. Orders will start syncing and will appear in the shipping area, this may take a few minutes.
Available Features
XPS Ship’s integration to OS Commerce supports the following as defined in the Integration Features Glossary