ShipHawk’s NetSuite bundle - which is a Hybrid SuiteApp - provides Web Services integration between NetSuite and ShipHawk. Our SuiteApp communicates with NetSuite to perform the following tasks:

...

This communication between NetSuite and ShipHawk allows your organization to access ShipHawk services. The installation procedures in this manual are specific to NetSuiteVersion 202002.2.

Syncing Item Fulfillments to ShipHawk

...

1. From the NetSuite dashboard, select Setup > Users/Roles > Access Tokens > New.
   You will be redirected to the Access Token screen.
   

   

2. Complete the screen by entering the following information:

   1. In the Application Name field, choose ShipHawk Integration.

   2. In the User field, choose the proxy user you set up in the previous procedure.

   3. In the Role field, select ShipHawk Shipping Web Services. 

   4. After  you complete each field, the Token Name field automatically populates with a new token name. Click Save, but DO NOT EXIT THE SCREEN. A confirmation screen will populate.

...

1. From the NetSuite dashboard, select ShipHawk > Setup > ShipHawk Settings.
   You will be redirected to the ShipHawk Settings List screen.
   

   

2. Click Edit to access ShipHawk settings.
   

   

3. Complete the ShipHawk Settings screen.

   1. In the ShipHawk Host Name field:

      1. Enter Shiphawk.com to set up your Production environment.
         

         

         

   2. In the API Key field, enter the ShipHawk API key found in the ShipHawk platform. To locate the ShipHawk API key, complete the following steps:
      

      1. Login to your ShipHawk account in a separate browser window or tab.  If you are not sure which account to use, contact your ShipHawk Implementation Representative.
         

      2. On the right side of ShipHawk’s top menu bar, click on the Settings icon and select the Settings link. The Settings screen appears.
         

      3. From the left-side menu, click on the Developer API link. The API Keys screen appears.
         

         

      4. Click the Create New API Key button located at the top of the screen. The Create API Key pop-up window appears.
         

         

      5. Enter a Name for your API Key. Then, click Create API Key.
         

         

         
         A success message will display at the top of the pop-up window to confirm your API Key has been generated.
         

      6. Click Copy to copy your API Key.
         

         

         
         Important: Your API Key will only be displayed one time. Ensure you have saved and copied your key correctly before exiting the Create API Key window.
         

      7. After you have successfully copied the API Key to your clipboard, click Done.

      8. Navigate back to NetSuite and the ShipHawk Settings screen.

      9. Paste the ShipHawk API key into the API Key field in NetSuite.
         

         

   3. Click on the Shipping Methods tab.
      

      

   4. In the Default Shipping Method dropdown field, select your organization’s usual shipping method. If unknown, just select one from the dropdown list. Your ShipHawk Implementation Representative will assist you with this later.

   5. Click Save when you are finished.

...

1. From your NetSuite dashboard, select Setup > Company > Locations.
   

   

   Click directly on the Locations link. Do not click on either New or Search.
   
   The Location screen is populated with a list of your existing stores and warehouses.
   

   

   
   ⚠️ If your organization has “child” locations under the main location record as in the graphic above, link only the “parent” locations to ShipHawk. Having a single ShipHawk warehouse point to multiple NetSuite locations creates errors.
   
   In the case that your organization absolutely must ship from a “child” location, create new warehouses in ShipHawk and link each one to the corresponding “child” location record in NetSuite.
   

2. Each Location in your NetSuite account must be linked to an equivalent Warehouse in ShipHawk using the warehouse ID number. Click the Edit link in the row corresponding to the first warehouse location you want to edit. The Location screen will populate with details related to that location.
   

   

3. To link your ShipHawk warehouse to this NetSuite location, you must enter the unique warehouse code for this warehouse in the ShipHawk Warehouse Code field. You can find the warehouse code in the ShipHawk platform.

4. Open ShipHawk  in a separate browser window or tab.

5. Click on the Settings icon > Warehouses.
   

   

   You will be redirected to the Warehouses screen.
   

   

6. Select the first warehouse you want to add to NetSuite and click on the name of the warehouse.
   

   

7. From the Warehouse Details screen, highlight the code in the Warehouse Code field and copy to the system clipboard.
   

   

8. Navigate back to your NetSuite account and the Location screen.

9. Paste the copied warehouse code into the ShipHawk Warehouse Code field and click Save. The Locations screen reappears.
   

   

10. Repeat this procedure for each warehouse in your account.

Confirm Connection

This section provides instructions for testing and verifying  the connection between NetSuite and ShipHawk after installation and integration.

Testing the connection

Before using ShipHawk with NetSuite, you must confirm that NetSuite and ShipHawk can securely communicate with one another. An easy way to test the connection is by synchronizing the product field mappings.

To synchronize product field mappings

1. From your ShipHawk account, select the Settings icon > Integrations > the NetSuite tile. From the Manage Your Account screen, click the Product Field Mappings tab.

2. From the Manage Your Account screen, click the Product Field Mappings tab.
   

   Image Added

3. Click the Update button to synchronize ShipHawk’s information to NetSuite.

4. If the connection was successful, a green confirmation message appears.
   

   Image Added

5. If the connection was unsuccessful, no message appears.

Troubleshooting the connection

This section describes the most common mistakes that could cause a failed connection to NetSuite and can be verified immediately. This troubleshooting section is not intended to be comprehensive; if none of these solutions resolve your connection issues, contact your ShipHawk Implementation Representative.

Did you enter the correct account ID?

The Account ID field on the Manage Your Accounts screen is syntax-sensitive. This means that capitalization matters. Verify that your account ID is correct.

Did you paste the correct Token ID and Token Secret?

The Token ID and Token Secret were saved in the Message Center of your ShipHawk Basecamp account. If you have misplaced this information, you must create new access tokens. The procedures for this step are in the Creating Access Tokens section of this SuiteApp Installation Guide.

If all your IDs and tokens are correct, then there is one more easy task that you can perform before contacting your ShipHawk Implementation Representative. You can access an audit trail in NetSuite to verify if ShipHawk was able to make a successful connection to NetSuite at all.

To access the NetSuite audit trail

1. From your NetSuite dashboard top menu, select Setup > Users > View Login Audit Trail.
   

   Image Added

   You will be redirected to the Login Audit Trail Search screen.
   

   Image Added

2. Personalize the search by filtering the following options:

   1. Select ShipHawk Shipping Web Services or the name of your proxy user in the Role field.

   2. Click the Personalize Search button. The Personalize Login Audit Trail Search Form screen is displayed.
      

      Image Added

   3. Click on the Results tab to generate a list of fields included in the search:
      

      Image Added

   4. Review the included fields and verify that the Detail option is included. If Detail is not displayed on the list, click on the dropdown field at the bottom of the Field grid and select Detail.
      

      Image Added

   5. Click the Add button.

   6. Click Save. You will be redirected to the Login Audit Trail Search screen.
      

      Image Added

3. Click Submit to run the search.
   

   Image Added

4. Review the results and locate the entry with a timestamp that corresponds with your attempt to synchronize the product field mappings.

   1. If one exists and the Status is Success, ShipHawk did successfully communicate with NetSuite.

   2. If one exists and the Status is Failure, then the request did reach NetSuite, but NetSuite blocked it from connecting. The likeliest problem is an incorrect account ID.

   3. If one does not exist at all, ShipHawk was unable to make contact with NetSuite.

If this step is  successful, congratulations, you have completed the setup and installation of ShipHawk’s SuiteApp! 

If this step is unsuccessful, do not worry.  Please contact your ShipHawk Implementation Representative for help troubleshooting the connection.

Upgrade Your SuiteApp

ShipHawk regularly releases new versions of our SuiteApp bundle. When this occurs, you must update the ShipHawk SuiteApp to the latest version. This section provides instructions for performing the update and integration.

Updating an existing bundle on NetSuite Production

The following section provides detailed procedures for updating an existing NetSuite bundle in the NetSuite Production environment.

To update an existing bundle

1. From the NetSuite dashboard, select Customization > SuiteBundler > Search & Install Bundles > List.
   

   Image Added

   To go directly to the Installed Bundles screen, type “Page: Installed Bundles” into the Search bar at the top of the dashboard.
   

   Image Added

   The Installed Bundles screen is displayed.
   

   Image Added

2. Locate the ShipHawk SuiteApp in the grid below.
   

   Image Added

   
   Verify that the account is named ShipHawk Integration (TSTDRV2246640).
   

3. From the Action icon on the left hand column, click the Update link in the drop-down field.