Fishbowl ShipExpress
The Fishbowl ShipExpress module, located in the Integrations group, is an add-on module that can be installed from the
Plugin module. The plugin connects to Shippo to provide integration with UPS, FedEx, USPS, DHL, and more. After installing the plugin, new buttons are added to the top of the
Sales Order module and the
Shipping module. The buttons are used to get shipping quotes, verify addresses, purchase labels, process batch shipments, view labels, view tracking, and refund labels. Shippo settings are configured in the
Fishbowl ShipExpress module.
Install
The documentation on this page is for the most recent version of the Fishbowl ShipExpress plugin. To get the most recent version, Update Fishbowl.
- In any Fishbowl Client, open the
Plugin module, located in the Integrations group.
- Select the
Fishbowl ShipExpress plugin and click Install.
- Completely close all Fishbowl Clients.
- Exit the Fishbowl Server by right-clicking the Fishbowl Server tray icon and selecting Exit.
- After re-opening the Fishbowl Server, the admin user can access the
Fishbowl ShipExpress module from any Fishbowl Client by opening the Integrations group.
- To grant access to additional users, assign the ShipExpress-View access right to the appropriate groups in the
User Group module
List of carriers
Fishbowl ShipExpress automatically integrates with any carrier that is enabled in the Shippo carrier settings.
Listed below are several carriers supported by Shippo. For a complete list, click here.
- USPS
- UPS
- FedEx
- DHL
- APC Postal
- Asendia US
- Australia Post
- AxleHire
- Canada Post
- CouriersPlease
- Deutsche Post
- DHL Express
- DHL Express and DHL eCommerce
- DHL Germany
- Fastway Australia
- FedEx and FedEx SmartPost
- Globegistics
- GLS France
- GLS Germany
- Hermes UK
- LaserShip
- Mondial Relay France
- Newgistics
- OnTrac
- Purolator
- RR Donnelley
- Sendle
- UPS and UPS Mail Innovations
- USPS
Setup
- Open the
Fishbowl ShipExpress module and complete the form to sign up for a Shippo account.
- The $.05 label fee that Shippo charges will be waived if the Shippo account is created in Fishbowl, or by using this link.
- If the sign-in window doesn't load, click the
Save button.
- If you already have a Shippo account, click Log in and enter your Shippo account information.
- Expand each Settings section to configure the integration. Column headers can be clicked to sort the tables.
- In the Ship From Settings enter at least one ship from address.
- In the Miscellaneous Settings select a default shipping item.
- Quotes can't be added to a sales order until carriers are mapped.
- Click the
Save button at the top of the module.
Settings
Ship From Settings
- Click the
Add button to configure which addresses will be used when shipping from each location group.
- The Ship From Phone Number is used when validating addresses.
Product Settings
- Click the
Add button to assign a product's Country of Origin and Tariff # for international shipments. The Customs Item Value and Customs Item Description will be used on the Commercial Invoice when available. If this information has not been entered, the item price and description from the Fishbowl sales order will be used.
- This information can also be edited by clicking the
Product Info button in the
Product module.
- To batch import product settings, click the
CSV button, select Export, and add the data in a spreadsheet program.
The data can then be imported by clicking theCSV button and selecting Update Table.
- This information can also be edited by clicking the
Address Settings
- By default, addresses fields are already mapped between Fishbowl and Shippo, but these mappings can be adjusted if necessary.
Customer Settings
- Click the
Add button to configure a customer with their own carrier account numbers, billing preferences, and label reference settings.
This information can also be edited by clicking theCustomer Info button in the
Customer module.
Carrier Settings
International Settings
- Shippo can validate international addresses. For pricing, see the Global Address Validation line on Shippo's pricing page.
- When purchasing a new label for an international shipment, the fields above will be used as the default values in the customs declaration dialog.
- Customs fees - Shippo supports three options in the Incoterm field. For more information click here.
- DDU (Delivery Duties Unpaid) - DDU means that your customer, the recipient, will be responsible for paying the customs charges before receiving the package.
- DDP (Delivery Duties Paid) - Choose DDP if you would like to pay all customs fees on behalf of your customer. This is common when sending a gift internationally.
- FCA (Free Carrier) - Free Carrier (FCA) shipments are supported only FedEx and DHL Express. With FCA, you deliver the goods, cleared for export, at a named place and the shipment can be delivered to a carrier nominated by the buyer.
- EEL/PFC - Choose from the following options in the EEL/PFC field. For more information click here or here.
- 30.37(a) is for unlicensed merchandise under $2500.
- 30.37(f) is for technology/software exports not needing a license.
- 30.37(h) is for gifts/samples/humanitarian donations.
- 30.36 is for shipments to Canada.
- AES_ITN is for shipments with a value of over $2500, or the goods require a license to export, or is shipping to a restricted country (Iran, Syria, Sudan, Cuba, North Korea).
- A product's Country of Origin and Tariff # are set in the Product Settings table. The Customs Item Value and Customs Item Description will be used on the Commercial Invoice when available. If this information has not been entered, the item price and description from the Fishbowl sales order will be used.
- Commercial Invoice - If the carrier provides a commercial invoice for international shipments, it will be included in the same document as the shipping label. For more information, click here.
- USPS - For USPS international shipments, you do not need to include a Commerical Invoice.
- UPS - For UPS, the Commercial Invoice is built into the label itself.
- Other carriers - For other carriers, the Commercial Invoice is not included with the labels.
Miscellaneous Settings
Shipment Extras Settings
- This sections stores the defaults for the Shipment Extras inside the Quote window.
Sales Order buttons
Click the ShipExpress button at the top of the
Sales Order module to access the following features.
Quote
- Click the
Quote button in the
Sales Order module to view rates. Rates will be shown for each applicable carrier that is enabled in the Shippo carrier settings.
- If a USPS account is marked as Test in the Shippo carrier settings it may show rates in Fishbowl, but will not generate labels. Other carriers marked as Test will not be visible in Fishbowl.
- The Weight shown in the quote window is calculated using the details of the products on the sales order.
- Predefined carrier cartons can be selected, or custom carton sizes can be entered. After changing any options, click Get Rates to get updated rates.
- After clicking Add to Sales Order the rate, carrier, and service will be updated on the sales order.
- Adding a quote does not purchase a label, but allows the shipping estimate to be added and charged to the sales order customer.
- Click the Shipment Extras button to access additional shipment options.
Verify
- Click the
Verify button in the
Sales Order module to validate addresses for all orders with the selected status.
Return Label
- Click the
Return Label button in the
Sales Order module to generate a return label for credit return items on the sales order.
Shipping buttons
Click the ShipExpress button at the top of the
Shipping module to access the following features.
Purchase Label
- After changing any fields that affect the rate, the button at the bottom will change to Update Rates.
- If Third Party or Recipient billing is selected in the Customer Settings, the Billing Info field will populate with the associated information.
- Click the Shipment Extras button to access additional shipment options.
Batch Shipping
Quick Ship
- Click the
Quick Ship button to purchase a label with a single click using the the Quick Ship Options from the Miscellaneous Settings section.
Verify
View Labels
- Click the
View Labels button to display any labels that have been purchased for the current shipment.
Tracking
Refund labels
- Click the
Refund labels button to request a refund from Shippo for any labels purchased for the selected shipment.
Product and Customer buttons
Product Info
- Click the
Product Info button in the
Product module to edit the ShipExpress settings for the selected product.
Customer Info
- Click the
Customer Info button in the
Customer module to edit the ShipExpress settings for the selected customer.
Troubleshooting
- Not getting expected rates back?
- Check the address and validate it using the address validation tool in the Sales Order module. Certain carriers will not return rates when addresses aren't completely correct.
- Make sure you have a phone number listed on the sales order details tab. Certain shipments require a phone number to be provided.
- USPS shipments are limited to a single carton. Multiple carton shipments will not return rates for USPS.
- For international shipments, ensure the product table is filled out in the plugin settings for each corresponding product on the order. Country of Origin and Tariff Numbers are required for customs when shipping internationally.
- Check out Shippo's support page for more info on how to successfully ship internationally
- If a label doesn't show up, or something doesn't work correctly, check the Shippo shipment for errors.
- Some carriers may limit the number of characters that can be printed on each line of a label (for example 35 characters). Click here for more information.
- You cannot mix packaging types between your packaging and carrier flat rate type packaging.
- More details about recent errors can be viewed by opening the Data module and clicking the Server Log button.
- Check for multiple versions of the ShipExpress plugin in C:\Program Files\Fishbowl\plugins\ or \Applications\Fishbowl\plugins\ on a Mac. If there are two files named shipexpress or fishbowl-shipexpress, exit the Fishbowl Server and all clients, remove the older version of the plugin, and then restart the server.
Release Notes
Bug Fixes
- Fixed blank error with no state available in the ship to address with international shipments (11/12)
- Fixed blank error with creating a shipping label for a credit return PO (11/12)
- Fixed bug with total price not calculating correctly for customs declaration when line items were split into multiple cartons (11/19)
- Fixed Ship from LG Address dropdown showing wrong data (11/19)
- Fixed bug where Fishbowl customer alert notes interferes with viewing purchased labels (11/19)
- Fixed address validation when no city/state present on shipping address (11/24)
- Fixed issue where a manual refresh was required to see the return label information in a custom field after purchasing a return label (12/10)
- Fixed issue with address validation updating the SO address when required custom fields were present on a Sales Order (12/10)
- Fixed bug with batch shipping when applied filter would turn off after selecting shipments (12/10)
- Fixed issue to clarify that return labels are not supported for multi-carton shipments (12/10)
- Fixed issue with ph#'s longer than 10 digits not being allowed. International ph# standard supports up to 15 digits (12/11)
- Fixed bug when using the purchase return shipping dialog wouldn't update rates (01/11)
- Fixed customer billing table data migration issue when updating from version 2020.11.3 to a newer version of the plugin (01/11)
- Fixed bug with batch shipping filters being ignored (01/11)
Enhancements
- Address Validation button now available in the Shipping Module (11/19)
- QuickShip button now available in the Shipping Module (11/19)
- Added a warning when purchasing labels if a label was previously purchased in the Ship Module (11/19)
- Added ability to provide a backup ship from ph# when none present on the SO (11/24)
- Added option to add return label cost to the SO/Ship custom fields (11/24)
- Updated help link for international shipments (11/24)
- Multi-carton shipment labels are now displayed in a single popup window (12/10)
- Added Shipment Extras default options in settings panel (12/10)
- Added ability to choose between UPS, FedEx, Ontrac, or Shipsurance for insured packages (12/10)
- Added customer specific Ship Label reference field defaults in the customer settings panel (12/10)
- All records in tables are now able to be sorted by clicking on the column header for any given table (12/10)
Bug Fixes
- Fixed "Weight of items cannot be larger than parcel weight" error even when the carton and item weights matched (10/8)
- Fixed customs item value bug to multiple the quantity times the value for the total item value (10/8)
- Fixed duplicate carton bug when using the quote feature (10/9)
- Fixed bug with recipient ph# being required even when included in the purchase label window (10/13)
- Fixed bug with cost not being added to additional cartons - only the first carton was getting the cost added (10/29)
- Fixed bug with military addresses requiring customs declarations (10/29)
- Fixed bug in batch ship wizard where you could finish without specifying if you wanted to print or save when purchasing batches (10/29)
- Added validation on intl shipments to ensure each order item has a country of origin specified (10/29)
- Fixed bug with return shipment label tracking not adding to the custom field (10/29)
- Fixed bug in batch ship address validation process with edited zip codes in-line not updating correctly on the ship record in FB (10/29)
Enhancements
- Added ability to edit addresses and refresh address validation (10/8)
- Added customs value and customs description column to the product table in the plugin setup. When specified those values will be used for the customs declaration (10/8)
- All new batch ship wizard experience (10/8)
- Added ability to filter by customer and/or carrier service in the first step of the batch ship wizard (10/29)
- Added shipment extras step to the batch ship wizard (10/29)
Bug Fixes
- Fixed bug with US address ph# - we now validate that the ph# is 10 digits (9/21)
- Fixed null error on csv import for the customer and product settings tables (9/21)
- Shipping module now refreshes automatically with the tracking and other data after purchasing a label (9/21)
- Fixed COD Amount field grayed out in Shipment Extras dialog (9/23)
- Fixed Return Label tool tip in the SO module (9/23)
- Fixed bug with COD on shipment extras when trying to edit after choosing COD (10/1)
- Fixed refresh issue when adding a shipping line to a Sales Order (10/1)
- Fixed bug in certain scenarios where USPS labels couldn't be purchased without receiving an error (10/1)
Enhancements
- Batch shipping now has a wizard approach which allows you to validate address and either save/print at the end of the batch purchase (9/21)
- Customs items are now editable in the customs declaration dialog on the items tab (9/21)
- All shipment extras are now on the Shipment extras button in the quote/purchase dialogs with options for insurance, retail rates, alcohol, dry ice, signature confirmation, and more
- The quote module buttons are consolidated and now include a button to purchase a return shipping label for a credit return sales order (9/21)
- Return shipping labels carrier, service, and tracking are now saved in a custom field for reference later (9/21)
- Improved address verification with ability to edit addresses in line and refresh the validation (10/1)
- Improved batch shipping with new wizard (10/1)
Bug Fixes
- Fixed rate limiting issue with more than 4000 addresses when validating addresses (8/13)
- Fixed weight UOM error for intl orders (8/13)
- Fixed bug with case sensitivity on carrier mappings (8/13)
- Fixed bug with FedEx Intl Freight shipping (8/13)
- Fixed bug when using batch shipping and ph# was required (8/13)
- Fixed blank error message when country code missing on the ship to address (8/13)
- Fixed Shipment out of Date error when purchasing a label (8/13)
- Fixed bug when switching between billing types in the purchase dialog and the associated fields not resetting as expected (8/13)
- Fixed blank error when associated custom field and location groups were not specified correctly (8/13)
- Fixed bug when adding and removing cartons in the quoting feature and the weights not updating correctly when requoting (8/13)
- Fixed issues causing certain shipments to not return rates for all expected carriers (8/13)
- Various bug and UI fixes (8/13)
- Fixed bug adding FedEx International freight to Fishbowl Sales Order when selecting during quoting (8/24)
- Fixed 3rd Party billing error with UPS shipments (8/27)
- Fixed bug when adding shipping line item to a sales order using the quote feature and the so item total price wasn't saving to the database correctly (8/27)
- Fixed bug with fulfilling an order when 3 or more cartons are involved (9/11)
Enhancements
- Added Authenticate button on the toolbar to reopen the Shippo Oauth flow after initial setup of the plugin as needed (8/13)
- Delivery Signature options now available (8/13)
- Plugin now supports Purchase and Transfer Orders now available (8/13)
- Added account billing zip and country to the customer settings table for recipient and 3rd party billing types (8/13)
- Address validation in the SO module now sets the Residential flag on the FB address when applicable (8/13)
- Added ability to map carriers/services on the fly in the SO and Ship modules when selecting a carrier/service that isn't already in the mapping table
- Added label reference fields mapping options for purchase and transfer orders (8/13)
- Improved error handling with more useful error messages (8/24)
- Recipient and 3rd Party Billing Enhancements including (8/24):
- Added "Name" field to customer table in settings (8/24)
- Removed "Sender" type from customer table (8/24)
- Restricted 3rd Party and Recipient billing to UPS and FedEx only to coincide with Shippo's supported billing types (8/24)
- When a given customer default is 3rd Party or Recipient billing, when purchase dialog loads, only the applicable carrier services (8/24)
- With 3rd Party/Recipient billing selected no other carrier/services rates shown without first changing the billing type to "Sender" (8/24)
- Cost is not added back to Fishbowl cartons with 3rd Party or Recipient billing (8/24)
- UPS requires zip and country when present on billing. Will receive error from Shippo when applicable (8/24)
- Carrier mapping dialog now only loads when finalizing purchase of labels if carrier/service is not already mapped (8/24)
- Shipping Ph# now shown in purchase label dialog and can be changed/added rather than having to go back and add to the SO (8/24)
- Performance improved when purchasing labels - labels now load much faster (8/24)
- FedEx One-Rate rates now shown when applicable (8/24)
- Added international shipment settings panel (7/9)
- Added customs declaration dialog when international shipment is selected to purchase a label (7/9)
- Fixed option to leave order unfulfilled in Fishbowl after updating the carrier/service/tracking in Fishbowl (7/9)
- Fixed problem with not getting rates back for all carriers
- Commercial invoices from Shippo are included now for intl shipments
- Various error messaging and UI Fixes
- Added default Ship From phone number to plugin settings Ship From Settings panel
- Added default Ship From phone number to the settings panel (6/11)
- Fixed refunds for shipments with multiple labels (6/11)
- Fixed bug with recipient billing (6/11)
- Fixed flat rate shipments not displaying/charging the correct rates (6/11)
- Fixed issue with not sending through phone numbers when needed by carriers for certain shipments (6/11)
- Various other bug fixes (6/11)
- Fixed bug where the carrier and carrier service were not updated in Fishbowl after purchasing a label (6/16)
- Fixed issue with third party billing giving an error when trying to purchase the label (5/21)
- Fixed bug with the cost not coming back into Fishbowl after purchasing the label if the user manually refreshes the shipment in Fishbowl
- Fixed bug where batch shipping would load a blank error message
- Removed unnecessary Fishbowl generated custom fields from teh Ref # 1 and Ref # 2 dropdowns so they do not show up as mappable
- All new plugin with new features.
- *Note - current settings will not migrate with users required to configure the plugin after installing the update.
- Point release bug fixes enables carrier rates and UOM conversion bug in quoting (4/30)
- Point release bug fixes issue when the purchase label dialog loads blank and flat rate markup on quote not working correctly after refreshing (5/12)
- Point release enhancement to allow users to define default carton dimensions for the quote dialog (5/12)
- Fixed Fishbowl ShipExpress not creating label for international shipments null error
- Fishbowl compatibility release
- Fixed bug where the country selection couldn't be changed when creating a label
- Default wieght uom is now lbs but can be changed to kg
- On first load, when no api key has been entered, a popup directs the customer to create an account and generate the API key
- Fixed bug where non-inventory parts on an order would cause an error when trying to generate a quote
- Fixed bug where using the ship quote and no flat rate cartons are appearing in the carton drop-down
- Fixed bug where the Ship Accounts button in the customer module was not showing the carrier info in the mapping table
- Shipments with more than 10 cartons is now supported
- Fixed bug with adding ship quote to SO when letters/symbols in the SO number
- Fixed bug moving items to different cartons
- Fixed incorrect error for shipping weight
- Fixed bug with carton based shipping enabled in Fishbowl
- Fixed bug with the retail rates setting when using the create label option
- Fixed issue with flat rate cartons
- Improved error messaging using rate quote feature
- Fixed bug where FedEx ground was not showing as an available option
- Fixed the carton functionality in the ship quote
- Fixed multiple cartons not saving the carton details after setting and toggling between cartons
- Fixed UOM conversion issue
- Fixed "Add to SO" button in the quoting dialog
- Added an enhancement to include USPS flat-rate carton types to the cartons list in ship quote
- Added an enhancement to set cost to "0" when "Default Ship Account Type" in Fishbowl ShipExpress settings is "3rd party" or "recipient"
- General UI enhancements
- Added a "Clear" button for carton details (resets all details fields - i.e. no carton selected)
- Added enhancement when quoting, set the selected carrier/service on the SO after the user clicks add to SO button
- When purchasing a label we now filter line items in cartons to only inventory type items
- Fixed bug where we were adding the wrong phone number to the labels
- Fixed bug where not pulling negotiated rates
- Fixed the bug when shipping international, Fishbowl ShipExpress now lets the user create a label if an individual product weight is under 1lb
- Fixed bug displaying ship quote button error with international orders in sales order module
- Fixed bug displaying incorrect quote weight conversion
- Fixed bug where quote would not allow 9 or more cartons to be added to orders
- Fixed bug where quote button would not display the quote window on FB Canada
- Fixed truncation bug on labels with 3 address lines
- New version number system to match Fishbowl.
- International Shipping! Fill out a customs declaration form and print a commercial invoice without leaving Fishbowl.
- Added Recipient and 3rd Party billing with the ability to store ship accounts per customer.
- Now uses OAuth to connect and authenticate Shippo account (Reconnection is required in this version).
- Fishbowl ShipExpress is no longer associated with Fishbowl Commerce. Settings are now completely within the plugin itself. No functionality has been added or removed.
- If you update to this version you will be required to input your settings again.
- Fixed weight issue using the quote feature with weight UOM other than lbs used
- Fixed issue where add text on label was not linked to the create label button
- Fixed bug with JX browser viewing labels
- Fixed issue with the check rates feature in the shipping info window
- Fixed bug when using the create label button and the shipment has 6 or more cartons, only 5 labels were created
- Fixed issue when a shipment has already been fulfilled manually in FB and the scheduled task is also trying to fulfill the shipment from Fishbowl ShipExpress
- Added Recipient and 3rd Party Billing functionality
- Fixed bug when update carton cost option is checked and cost field not updating
- Fixed various bugs in the commerce shipping window
- Fixed an issue when the shipping information wasn't being pushed to Fishbowl ShipExpress after using the create label button.
- Fixed "method not found in 3rd party library" error
- Optimized address verification to ignore the first line of an address if it does not have number.
- Added a setting to set retail rates to be displayed when getting ship quote.
- Added a setting to use the declared value field on the ship carton to purchase insurance. Note: Insurance is purchased through http://www.shipsurance.com/
- Added a setting to disable the shipping cost from being set on the shipment carton after creating a label.
- Added a warning that shows when trying to run the ship quote without any carriers set to display rates.
- Added a warning that shows when there is no phone number set for the default main office address in Fishbowl.
- Updated the ship from "name" to pull from the name instead of the address name.
- Fixed an issue where the ship from phone number was not being set properly.
- Fixed an issue that was causing shipping services not be be imported when saving the Fishbowl ShipExpress settings.
- Fixed an issue that was causing the Shippo Key not to save for new accounts.