Versions Compared

Key

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

...

About this document

This article This guide explains how the SPS Commerce ASN Connector integration works in NetSuite, which sends shipping and package data to SPS Commerce from ShipHawk TMS for ASN generation. 

...

This guide covers the following topics:

Table of Contents
minLevel1
maxLevel7

About SPS Commerce

SPS Commerce is an electronic data interchange (EDI) provider that generates ASNs using package detail information derived from NetSuite. Advanced shipment notices (ASNs) are a type of document that provide recipients with information about a pending shipment. ASNs are commonly used when delivering large quantities of packages to retailers, so that the retailer can prepare for the placement and storage of these packages before they are delivered. 

Each retailer has their own requirements for how ASNs should be formatted. As such, SPS Commerce works with their customers to customize ASNs for each retailer. The role of ShipHawk in this process is to provide SPS Commerce with basic package information so SPS Commerce can then curate custom ASNs for their customers.

How ShipHawk TMS Works with SPS Commerce

Info

IMPORTANT:ShipHawk TMS does not generate ASNs or support EDI on its own. This integration simply allows for ShipHawk to send basic package information to SPS Commerce so that SPS Commerce can then provide ASNs directly to the receiver.

ShipHawk TMS consumes item fulfillments (or sales orders) originating from NetSuite. When these are booked, ShipHawk TMS communicates with NetSuite via web services to make updates to the Item Fulfillment record.

For simplicity, the rest of this document refers to ShipHawk TMS as “ShipHawk.

For details on how ShipHawk works with NetSuite,  see SuiteApp Administration and Configuration Guide for NetSuite.

...

  • Width

  • Height

  • Length

  • Weight

  • Tracking Number

  • Package Quantity

  • Item Fulfillment ID (itemFulfillmentId)

  • Carton Index (cartonIndex)

  • UCC Label ID (labelid)

  • Bill of Lading Number

  • Carrier PRO Number

  • Carrier Alpha Code

  • Items object, which includes the following for each item in the package:

    • itemId

    • itemFulfillmentLine

    • itemQuantity

Configuration Prerequisites

The SPS Commerce integration is intended for any customer using SPS Commerce as their EDI provider. For a ShipHawk customer to use this integration, they must already have the following SPS Commerce bundles configured on their instance of NetSuite:

  • SPS Commerce Fulfillment for NetSuite

  • SPS Commerce SPS Commerce Supplier AutomationSPS Integration Status

To support the SPS Commerce ASN Connector integration in NetSuite, ShipHawk’s NetSuite bundle must be version 2022.7.0 or above.

SPS Commerce Configuration Tasks

SPS Commerce configuration includes the following:

  1. Create New Package Record for Custom Entry Form

  2. Enable ShipHawk to Automatically Generate ASNs

Create New Package Record for Custom Entry Form

Create a new Package record for a custom entry form as follows.

  1. Select  Customization > Lists, Records, & Fields > Record Types:


  2. Click on the Package record (ID: customrecord_sps_package):



  3. Under the  Forms tab, for the SPS Package Form, click Customize:



  4. Select  the FORM IS PREFERRED  checkbox (make sure it is checked on), then under Subtabs, find Contents.



  5. Using the Move To Bottom button, move the Contents row to the bottom, and select the SHOW checkbox(make sure it is checked on):



  6. In the LABEL field, enter the text  “Contents (Scripted - not for UI use)”:



  7. Finally, near the upper left corner of the screen, click Save.

Enable ShipHawk to Automatically Generate ASNs

To enable ShipHawk to automatically generate ASNs, complete the following steps:

  1. Select Customization > Scripting > Script Deployments:



  2. In the SCRIPT field, select the SPS SL SVC Create ASN script ( ID: customscript_sps_sl_svc_create_asn).

  3. Next, in the row for the script, click the Edit link:



  4. Select AVAILABLE WITHOUT LOGIN (make sure it is checked on):



  5. Finally, click Save.

Enabling the SPS Commerce Connector

Before you can access SPS Commerce settings in the ShipHawk user interface, your ShipHawk Account Manager must enable this feature for your account. 

Be sure you have completed the Configuration Prerequisites and Configuration Tasks .

Now you can enable the SPS Commerce connector as follows:

...

Additionally, once you have enabled the above options, you will also be able to see ASN generation status added to the Source System Sync Status modal, which is available in the ShipHawk Shipment details page:

...

Testing SPS Commerce Integration

For more information, see Testing SPS Commerce Integration .

Expand
titleGoogle Doc Version

Lref gdrive file
urlhttps://docs.google.com/document/d/1S6fmYe3HHvVoGao6yVeSpoSvaArp9HxXwXup7pc_6kU/edit?usp=sharing

...