From Fishbowl

Jump to: navigation, search

Icon.X-Cart.png The X-Cart module, located in the Integrations group, is an add-on module that can be installed from the Small.Plugin.png Plugin module. After installing the plugin, a new module is added that integrates with one or more X-Cart shopping carts. The X-Cart Plugin works on X-Cart 5.



Jump to top of page

  1. In any Fishbowl Client, open the Small.Plugin.png Plugin module, located in the Integrations group.
  2. Select the X-Cart plugin and click Install Now.
  3. Completely close all Fishbowl Clients.
  4. Exit the Fishbowl Server by right-clicking the Fishbowl Server tray icon and selecting Exit.
  5. After re-opening the Fishbowl Server, the admin user can access the Small.X-Cart.png X-Cart module from any Fishbowl Client by opening the Integrations module group.
  6. To grant access to additional users, open the Small.User Group.png User Group module and assign the X-Cart-View right to the appropriate groups as explained here.

Jump to top of page

X-Cart API.png
In order to connect to X-Cart, follow the instructions below to set the read/write API key.
  1. Log in to the store administration page. This is typically the store URL followed by admin.php (for example, xcart.mystore.com/admin.php)
  2. Verify that the REST API module is installed and enabled and then click the Settings link below REST API.
  3. In the API key (read/write) field, enter a password that is as complex as possible and then click Submit.
  4. Enter the Store Url, and the API key (read/write) created in the previous step into the Small.X-Cart.png X-Cart module.
  5. Click the Test Connection button in the Small.X-Cart.png X-Cart module to verify that the connection is valid and then click Save.
Multiple X-Cart carts can be configured by clicking the New Button.png New button, which will add another X-Cart tab.

Jump to top of page

The table below shows how data transfers between X-Cart and Fishbowl.

X-Cart Fishbowl
Part & Product
Paid order with New shipping status
Sales order
Shipped order
Fulfilled sales order
Quantity in stock
Available for sale inventory (only inventory that has changed since the last export will be updated)
Product Name
Product & part number
Full description
Product & part description
Product SKU
X-Cart order number
Sales order custom field, Customer PO field, sales order number (optional)
Customer name & billing address
Bill To
Customer name & shipping address
Ship To
Creates a new customer or uses the generic customer specified on the Schedule Import Order tab.
All taxes are combined into the tax item specified on the Schedule Import Order tab.
All discounts are combined into the discount item specified on the Schedule Import Order tab.
Email Not imported
Phone Not imported


Jump to top of page

X-Cart Settings Tab.png

Schedule Import Order
Jump to top of page

X-Cart Schedule Import Order Tab.png

Orders will only be imported from X-Cart if they have a Paid payment status, and a New shipping status.

Schedule Export Order
Jump to top of page

X-Cart Schedule Export Order Tab.png

Fishbowl can update the order in the shopping cart after items are fulfilled in Fishbowl. The shipment tracking number will also be exported to the shopping cart.

Schedule Products
Jump to top of page

X-Cart Schedule Products Tab.png

When pulling products to Fishbowl, the product sync should usually be scheduled to run before the order import. This will avoid any errors caused by new products that need to be imported before the order can be created in Fishbowl.

Schedule Inventory
Jump to top of page

X-Cart Schedule Inventory Tab.png


Release Notes

Version 1.5

Features and Fixes

Version 1.4

Features and Fixes

Version 1.3

Released on 3/15/2017 - For Fishbowl version 2017.2 and higher

Personal tools
Other Pages