AmeriCommerce / SparkPay Integration Instructions

Introduction

Our AmeriCommerce / SparkPay integration works by connecting to your shopping cart at scheduled intervals to perform tasks related to orders and inventory. AmeriCommerce is in the process of switching names from AmeriCommerce to SparkPay. The integration is setup the same and AmeriCommerce can be used interchangeable for the purpose of this documentation. (unless otherwise noted below)

Fulfilling New Orders

Each time we connect to AmeriCommerce to retrieve new orders we are requesting only orders that match a certain status ID number. Orders matching your chosen status ID are retrieved by our integration module which attempts to inject each order into your Fulfillment Control Panel account for processing.

Retrieved Order Status (optional)

We can update your AmeriCommerce orders to reflect a new status when they are successfully received by your Fulfillment Control Panel account.

Warehouse Filter (optional)

If you have drop-shipped items and / or have more than one warehouse configured in AmeriCommerce you can set a specific warehouse ID which will cause the integration to skip any orders or items which do not match that ID.

Tracking Updates to AmeriCommerce (optional)

At the end of each day our integration module will send tracking numbers back to AmeriCommerce, for orders shipped that day, and update each order to the “shipped” status of your choice. If you set a status ID number for “partially shipped”  orders we can update to that status if all items in the order have not shipped.

Inventory Syncing & Product Status (optional)

Our integration module can update the stock counts of your AmeriCommerce products with the available warehouse quantity. Optionally, we can update the product status to reflect an “in stock” or “backorder” status of your choice.

Our standalone Inventory Sync Guide will walk you through setting up Inventory Syncing after you successfully add the Integration to your FCP Account.

Please Note: Product SKUs in AmeriCommerce must match the product SKUs available in your Fulfillment Control Panel account.

Connecting EFS & AmeriCommerce

To allow access to your order and product data you must sign up for AmeriCommerce’s paid API subscription and obtain the following:

 

  • API Access Security Token

  • API Username

  • API Password

  • Web Service URL (this will be something like https://store.americommerce.com/store/ws/AmeriCommerceDb.asmx)

 

Once you have obtained your API credentials you will need to enter them into your Fulfillment Control Panel account. Choose Add Integration from the Integration menu.

Select AmeriCommerce (if you have been upgraded to SparkPay select that option instead) from the list of available platforms and click the “Add new Integration” button. Your Store Domain, API Username, API Password, and Security Token should be copied and pasted into your settings (see below).


The next set of options determine the statuses used when interacting with AmeriCommerce. These are ID numbers you need to retrieve from your AmeriCommerce administration area.


For the Ready to Fulfill and Retrieved statuses choose “Order Statuses” from the “Orders” menu in AmeriCommerce. You should see a list of all your current statuses. The ID number for each status is displayed next to each status title.


For the Backorder and In Stock status ID numbers you will need to choose “Product Statuses” from the “Catalog” menu of AmeriCommerce. Product status ID numbers will be displayed just like order status ID numbers.


If we should only fulfill orders for a specific warehouse, you will need to assign a status ID for that warehouse. To view your warehouse ID numbers choose “Dropshippers/Warehouses” from the “Orders” menu of AmeriCommerce. ID numbers are not listed next to warehouse titles so you will need to click the Edit button under Actions when viewing your list of warehouses, then get the ID from the URL of your browser.


The next set of options determine the intervals at which we check for new orders and, optionally, send available inventory counts back to AmeriCommerce.

 

The most common scenario is to check for new orders every 30 minutes and sync inventory twice per day.

 

If you have more than one AmeriCommerce store you may assign a “nickname” to each store to better identify options and settings for each one.


Click the “Add new Integration” button to finalize the integration settings. You should see a success message at the top of your screen.

 

To verify that we can connect to your AmeriCommerce store choose View Integrations from the Integration menu. For each integration you have configured you will see a set of options displayed as colored icons. Click the “suitcase” icon to view the items in your AmeriCommerce account.


You should see a searchable list of products from your AmeriCommerce store. The list will indicate if the product SKU matches a SKU in our system.

 

If you do not see a list of products and, instead, see an error message it is likely that your API Password, API Token, API User Name, or Web Service URL have been incorrectly entered in our system.

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk