Fishbowl Integration Setup

• Overview
• Access Fishbowl Setup
• Create the Fishbowl App
• Configure Sync Settings
• Order Status, Shipping, and Tracking
• Inventory Sync Options
• Related Content

This article explains how to set up the Fishbowl integration, including creating a Fishbowl app, configuring sync settings, mapping order and shipping data, and enabling inventory and tracking synchronization. Following these steps ensures successful communication between the storefront and Fishbowl. 

 

Access Fishbowl Setup

1. Log in to the store admin.
2. Navigate to Tools > Add-Ons > Fishbowl Advanced.
3. Or access the page directly using the following URL: 
   https://<yourstorename>.americommerce.com/store/admin/Tools/AddOns/FishbowlAdvanced.aspx

Create the Fishbowl App

1. Enter the following credentials provided by Fishbowl:
   • Username
   • App Secret
   • Server URL
2. Enter the App ID and App Name you want to use.
3. Click Save to store the settings.
4. Click Create App / Test Login.

If the app does not already exist, it will be created in Fishbowl and a confirmation message will display.

Note: You must log in to Fishbowl and approve the newly created app before synchronization can occur.

Configure Sync Settings

Use the Sync Settings section to control how orders, taxes, and custom fields are synchronized.

• Sync Order Status – The storefront will pull orders that are in this selected status and sync them to Fishbowl.
• Change Order Status After Sync – Select a different order status to apply after the order is synced. 
  Warning: Fishbowl does not allow overwriting existing order items, quantities, or details.
• Tax Rate Name – Enter AVATAX or the exact tax rate name configured in Fishbowl.
• Additional Mapping – Map any Fishbowl custom or additional fields that should sync with orders.
• Shipping Method Mapping – Each storefront shipping method must map to a Fishbowl-supported shipping method. 
  Warning: If the shipping method does not match, the order sync will fail.

Order Status, Shipping, and Tracking

Once orders are synced, the storefront can retrieve shipment details from Fishbowl.

• The storefront will pull the Tracking Number from Fishbowl for synced orders.
• You can configure which Order Status the storefront should change to when an order is:
  • Partially shipped
  • Fully shipped