Custom EDI

StarShip supports integration with your custom EDI-solution and generation of the ASN (Advance Ship Notice). This topic shows you how to set up custom EDI options.

Custom EDI Settings

ASN Number Shipment Field

Recipient Tab

Reference Fields

Field Mapping

Define Conditions

Conditions Example

Shipping with Custom EDI Integration

Notes

Custom EDI Settings

Select Setup > EDI from the StarShip Ship screen and then click Custom EDI.

Enable Custom EDI

Check the "Enable Custom EDI integration" option.

For EDI shipments, activate Custom EDI integration

• Manually : This option allows the user to manually check (or uncheck) the "EDI Integration with: Custom EDI" check box on the Recipient tab.

• Conditionally : This option allows you to add conditions under which your custom EDI solution will be used for EDI shipments. When conditions are met, StarShip will automatically check the Custom EDI check box on the Recipient tab. Note that when this field is set to Conditionally, the user cannot manually check the Custom EDI check box on the Recipient tab. See Define Conditions for more information.

Generate ASN in StarShip

When checked, StarShip automatically generates the ASN number for any shipment where custom EDI is activated. If this option is not checked, StarShip will not generate the ASN number. It can be typed in manually on the Recipient tab > ASN Field or mapped to an ERP interface field.

Generate EDI file

When this option is checked, the EDI file is created on Ship/Process in the location set in the StarShip Server Manager. If the path is unavailable, StarShip will create an EDI\Custom EDI\ folder to contain the EDI file.  For more information about the default EDI folder, see the StarShip Server Manager Help.

ASN Type

This field appears if you checked Generate EDI file above. Select the type of ASN required by your Trading Partner.

• Pick and Pack : This is the default setting. StarShip generates the file read by the custom EDI to create the ASN in this format : Shipment > Order > Pallet > Pack > Item

• Standard : StarShip generates the file read by the custom EDI to create the ASN in this format : Shipment > Order > Pallet > Item > Pack

• Standard when : Allows you to define the conditions under which the Standard format is used. You can use the condition builder to define values for one or multiple shipment fields that will trigger EDI integration. See Define Conditions.
  
  Note : In order to generate the Standard ASN, a shipment cannot contain mixed items in any packages. Each line item must have its own package. If two or more line items are placed in the same package, StarShip can only generate the file used to create the Pick and Pack ASN.
  
  
  

ASN Number Shipment Field

Recipient Tab

The ASN Number field appears on the Recipient tab; it can be automatically generated by StarShip, or can be typed in manually or loaded from the ERP interface. See the Field Mapping section below for more information on how to import the ASN number from your ERP interface.

Reference Fields

The ASN Number field can be assigned as an additional reference field for carrier interfaces. Reference fields are set up per carrier in Setup > Carrier Interface > "carrier" > Reference Fields tab.

1. Select Shipment Fields as the Data Source and then select ASN Number from the Field list.
   
   
   
   
   
2. Select the Reference Number Type Identifier to assign to the ASN Number.
   
   
   

Field Mapping

If you do not check "Generate ASN Number in StarShip" in the options above, the ASN Number shipment field can be mapped to an ERP interface field so that the value is populated from the ERP interface automatically.
Field mapping is performed in Setup > Source Interface > "your interface" > Customize Interface.

1. Click Target Fields > Recipient, and select "ASN" in the center pane.
2. Set the Field Mapping Source to the "ERP Interface" field.
3. Select the document field (ex. Sales Order Field) from which you want to import the ASN number.
   
   
   

Define Conditions

Follow this procedure if you are defining conditions for custom EDI activation. Conditions are a number of field values or calculations (operands) connected by operators. They can be based on :

• Constant Values : These are fixed values that you define. You can add a Constant Value by selecting New Constant Value from the drop-down list. Values you already created are also saved to the drop-down list.
  
  
  
  

• StarShip Fields : These are fields from the Ship screen (shipment fields).

Conditions Example

In this example, we'll set up StarShip to conditionally use a Billing Type shipment field value to trigger the Custom EDI check box on the Recipient tab.

1. First, set the For EDI shipments, activate Custom EDI integration to "Conditionally."  Click the    button next to where it says "none". This allows you to access the Condition Builder.
   
   
   
   
   
   
   
2. Select the first Operand, i.e. StarShip shipment field, by clicking on the drop-down list. In this case, we'll select "Billing Type."
   
   
   
   
   
   
3. Next, choose an operator from the drop-down list. Here we are choosing "is equal to" since we want our custom EDI to be activated for a specific billing type.
4. Select the second Operand from the drop-down list. Here we'll select "Third Party." The second operand can also be a constant value, depending on the shipment field selected. In some cases, you can also select whether the condition applies to each order or package (Pack) in the shipment or at least one order or package in the shipment. Basically, what is available in the second operand list will depend upon the field you select as the first Operand.
   
   
   
   
   
   
5. Multiple conditions : To add another condition, click the button in the upper right corner of the dialog. To group conditions, first select the conditions you want to group...
   
   
   
   
   
   
6. ...and then select the AND or OR button on the top right of the dialog.
   
   
   
   
   
   
   Grouped conditions can be administered by clicking on the AND or OR button in front of the condition.
   
   
   
   
   
   
7. When you click OK, the condition (or grouped conditions) appears in the condition area. Now, when these conditions exist for a shipment, custom EDI integration will be automatically checked on the Recipient tab.
   
   
   

Shipping with Custom EDI Integration

While processing a shipment, users will either be able to manually check or uncheck the Custom EDI integration check box; or, if custom EDI integration is activated based on conditions ("Conditionally"), the check box will be greyed out and checked/unchecked by StarShip.

When custom EDI integration is enabled for a shipment, the Custom EDI option is checked in the Recipient panel.

Notes

• Custom EDI settings are saved per location.
• If multiple orders are included on one shipment in StarShip, your custom EDI will generate a consolidated ASN. A separate shipment must be processed for each order to have your custom EDI solution generate a separate ASN per order.
• EDI shipment information is stored in a shared directory specified in StarShip Server Manager options. See the StarShip Server Help for more information.