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

 

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.

 

 


 

 

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 :

 

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