Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In January 2025, ShipHawk made available the ShipHawk TMS SuiteApp.

...

  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 the ShipHawk endpoint to set up your Production environment.
        For example, if the ShipHawk endpoint is:
        https://abcdef.tms.myshiphawk.com
        Enter:
        abcdef.tms.myshiphawk.com

        NOTE: If you are interested in a sandbox environment or user-acceptance testing environment, please contact your ShipHawk account manager for more information.

    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 (blue star) 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.

        Image RemovedImage Added

         

      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. Select ⚙️ > Settings > Integrations.

  2. Click the NetSuite tile for NetSuite Manage Your Accounts.

  3. Select Advanced tab and go to the Rate Limiting section:

    Image RemovedImage Added

     

  4. In Concurrency Rate Limit, enter a value that is less than or equal to the Account Concurrency Limit in NetSuite.

Adding ShipHawk Warehouses to NetSuite Locations

Both NetSuite and ShipHawk have the concept of Locations / Warehouses. Because of this, we need to create a relationship between Locations in NetSuite and Warehouses in ShipHawk.

To map ShipHawk Warehouses to NetSuite Locations

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

    Image Added

    (info) 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.

    Image Added

    ⚠️ 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.

    Image Added

     

  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 ⚙️ > Settings > Warehouses.

    Image Added

     

    You will be redirected to the Warehouses screen.

    Image Added

     

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

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

    Image Added
  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.

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

Confirm Connection

Upgrading the SuiteApp

...