Versions Compared

Key

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

...

An administrator must be able to set up and easily change mappings to the following:for several different fields. There MUST be a UI for an admin to change these without custom development.

  1. Order reference number mappings. Reference numbers in ShipHawk are used to bring custom data into ShipHawk for use on shipping documentation or on the ShipHawk Rules Engine. An administrator must be able to map at least 30 fields in the syncing entity (the ERP) to reference numbers in ShipHawk.

Expand
titleExamples

Customers have used these mappings for the following use cases:

  • To put store number information on carton labels to meet EDI requirements, customers have mapped store numbers and additional customer information

  • To tell ShipHawk to rate shop rates that will arrive within _ number of days, customers have mapped a custom service days field

  • To create customer specific rules, customers have mapped fields denoting the customer processing the shipment

Additionally, the administrator should be able to map information from the customer record, order record, shipment record, and any other important sources of data that pertains to the order object.

Here are the Order Reference number mapping settings as in the Netsuite connector:

Here is the order reference number mapping page in Acumatica:

...

Expand
titleExamples

Here are some use cases that customers have used order field mappings for:

  • Some companies book shipments for their customers using their carrier account. In order to do this, the third party billing information needs to be mapped from the ERP to ShipHawk

  • Some customers want to be able to map alternate return addresses, which are possible via order field mappings.

  • In some situations, the default field for some data is not the field that the customer is using. It is good to have integration flexibility out of the box

Additionally, the administrator should be able to map information from the customer record, order record, shipment record, and any other important sources of data that pertains to the order object.

Here is what the order field mapping look like in Netsuite:

Here is what order field mappings look like in Acumatica:

...

Expand
titleExamples

Example use case:

When generating international documentation, ShipHawk needs the value of items in the shipment. In our Netsuite environment we have product sync enabled and can sync the sku’s value to ShipHawk.

In some cases, however, the value may change depending on other circumstances.

For many of our Netsuite customers, line item field mappings are used to map the value of the items being shipped in that Sales Order instead of the value stored at the product/ sku level.

Additionally, the administrator should be able to map information from the item record, inventory details record and any other important sources of data that pertains to the order object.

Here is what line item field mappings look like in Netsuite:

Here is where line item fields are mapped in Acumatica:

...

Expand
titleExamples

Line item reference numbers are frequently used to bring custom information at the line level onto documentation. For example- one customer has 5 T shirts of the same size and design, but just with a different color. The customer wants to be able to map the color of the shirt onto their packing slips to show their customer. Using line item reference number mappings, the user is able to bring this custom information onto their documentation.

Additionally, the administrator should be able to map information from the item record, inventory details record and any other important sources of data that pertains to the order object.

Here is what line item reference number mappings look like in Netsuite:

Here is where line item reference number are mapped in Acumatica:

...

Expand
titleExamples

Example: If the ERP has a service called FedEx Ground, that service needs to be mapped to ShipHawk’s FedEx Ground service.

Here is where shipment method mappings are configured in Netsuite:

Here is where shipping method mappings are configured in Acumatica:

  1. Warehouse mappings

In order to properly sync and rate fulfillments in ShipHawk, a warehouse code must be populated in the API request. These warehouse code exists in the ShipHawk warehouse object as seen here:

...

There must be a page where an administrator can map the warehouse entered in the ERP to warehouse codes that the user enters.

3. Webhook Configuration

An If possible, an administrator must be able to configure webhooks to receive information from ShipHawk to update shipments (see Receiving Information from ShipHawk Requirements ).

Expand
titleExamples

Our Acumatica integration uses webhooks to sync data from ShipHawk to Acumatica. Here is what the native webhook configuration page looks like in Acumatica:

Image Added

In ShipHawk, here is where webhooks are configured:

Image Added

4. Logs for Testing and Debugging

...