...
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 | ||||
|---|---|---|---|---|
|
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
...
How ShipHawk Writes Package Details to NetSuite
...
| 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.
When updating Item Fulfillment records, by default, ShipHawk writes package-level information back to custom ShipHawk fields in NetSuite. When you enable the SPS Commerce connector however, ShipHawk will write the shipment package-level information to SPS Commerce’s custom records in NetSuite instead.
Specifically, ShipHawk writes package details to the custom SPS Commerce Package ContentsEDI Packages tab under the item fulfillment record. SPS Commerce then uses the package details ShipHawk writes back to the Package Contents tab fields in the item fulfillment record to generate ASNs.
...
...
ShipHawk’s interaction with SPS Commerce ends when the package details are written to the SPS Commerce’s records and the ASN file is generated (depending on the Autogenerate ASN setting, described below). Further downstream processes related to EDI and ASN are handled by SPS Commerce.
The package details ShipHawk sends to this custom tab for SPS Commerce to retrieve areinclude:
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 NetSuiteSPS Commerce
SPS Commerce Supplier Automation
SPS 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:
Create New Package Record for Custom Entry Form
Create a new Package record for a custom entry form as follows.
Select Customization > Lists, Records, & Fields > Record Types:
Click on the Package record (ID: customrecord_sps_package):
Under the Forms tab, for the SPS Package Form, click Customize:
Select the FORM IS PREFERRED checkbox (make sure it is checked on), then under Subtabs, find Contents.
Using the Move To Bottom button, move the Contents row to the bottom, and select the SHOW checkbox(make sure it is checked on):
In the LABEL field, enter the text “Contents (Scripted - not for UI use)”:
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:
Select Customization > Scripting > Script Deployments:
In the SCRIPT field, select the SPS SL SVC Create ASN script ( ID: customscript_sps_sl_svc_create_asn).
Next, in the row for the script, click the Edit link:
Select AVAILABLE WITHOUT LOGIN (make sure it is checked on):
Finally, click Save.
Enabling the SPS Commerce Connector
After you have confirmed their SPS Commerce account is connected to their NetSuite instance, 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:
On the ShipHawk user interface, navigate to Settings > Integrations > NetSuite.
You will be redirected to the NetSuite Manage Your Accounts screen.On the NetSuite Manage your Accounts screen, click on the Advanced tab.
Under the SPS Commerce Connector for ASN heading, select Enable SPS Commerce Connector for ASN.
Click Save.
Once this is enabled, ShipHawk writes necessary shipment and package information to SPS Commerce’s records in NetSuite, which are available in the Item Fulfillment record.
...
When you have selected Enable SPS Commerce Connector for ASN, you can optionally select the Autogenerate ASN option. This option automatically generates ASNs in NetSuite after the shipment is made and the package information is written to SPS Commerce’s records.
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 | ||||
|---|---|---|---|---|
| ||||
|
...