1. Home
  2. ERP
  3. ADE
  4. ADE Field Mapping

ADE Field Mapping

StarShip allows you to customize the way data is translated between ADE interface documents and the StarShip shipment. Using the field mapping feature, you can control how the data in the source document is translated to StarShip, allowing you to define what information populates the shipment fields, and how the data is interpreted into accepted shipment values, when necessary.

My Interface

StarShip comes with one predefined interface called “My Interface” that installs default field maps for your ADE interface documents, which you can customize. You can also create multiple interfaces to use with different companies if you plan to map to user-defined fields that vary between companies.

How to Access Field Mapping

  1. To access field mapping, go to Setup > Source Interfaces > ADE, and click the Interfaces heading.
  2. Select the Customize Interface button for the document.
    Click Customize Interface
  3. Then, click the Select Mappings heading.


Fields from the ADE interface may be mapped by default as part of the basic interface you were given. If you want more control over how data is translated from ADE interface into StarShip shipment fields, you can add fields or customize field mapping to suit your company’s needs. For any information that you want imported with the source document, you can map those fields to StarShip shipment fields and when applicable, set up value translations.

If you want to import a field that doesn’t have a corresponding field in StarShip, you can use StarShip User Definable fields and map your ADE interface field to one of them. Mapping User Definable fields to ADE interface fields allows you to bring in values that may not normally be imported with the Shipment.

You can map any field in StarShip, but let’s look at a few common examples.

Ship Via

Ship Via is an example of a field that can be mapped by default, but which requires you to set up value translations for the most accurate results. Although the field is mapped, you now need to define what the ADE interface Ship Via methods mean in StarShip terms. For example, the ADE interface Ship Via field value “AM” can be set up to translate to “FedEx 2Day® A.M.” when the Shipment is imported into StarShip. When the source document Ship Via is “AM”, the Carrier/Service fields on the Ship screen will automatically populate with “FedEx 2Day® A.M.”.


If no value translations are provided, StarShip will attempt to translate the Ship Via based on default keywords.

Expand Shipment > Carrier Information > Carrier – Service.

Select the Ship Via field

For each of the ADE Field Ship Via values In the Value Translations list, select the corresponding StarShip Carrier – Service value from the drop-down list. Depending on how your interface is set up, you might have to add the values here. The list of fields and values is maintained in the Field List file provided with your interface.

Select or add Value Translations

Map a Field to a Fixed Value

You can set a fixed value for any mapped shipment field. You can either type in a value or choose one of the possible shipment values from a drop-down list. If the shipment field says (Select) next to it, then the fixed value will be either selected (True) or not (False).

Map a Field to Any ADE interface Field

Select a field from the ADE interface document as the mapped source for the corresponding StarShip field.

In the “Maps from” field, select ADE Field and then choose the ADE interface field to map to.

Map a Field to a ADE interface field with Value Translations

This example illustrates an StarShip field that requires a set of possible values. Here is the StarShip “FOB” field that we map to the ADE field “FOB”. You’ll see that an area for Value Translations becomes available.

Click Add Value Translation if there are no values present and enter the values from ADE interface; or if values are present, just select the StarShip value that they should translate to.

Provide value translations

Map to a User Definable field

StarShip provides User Definable fields at the Item, Order, Packaging, Pallet and Shipment levels. Although it is possible to map StarShip User Definable fields to different level source fields, we recommend that you only map User Definable fields to the same level fields from the ADE interface.

More Information

More information about setting up and using User Definable Fields in StarShip.

  1. Create the StarShip User Definable field(s).
  2. In Select Field Mappings, locate the User Definable field. User Definable fields are noted by a (UDF) after the field name you created.
    Locate the UDF field
  3. Select Maps from “ADE Field” and then select the field to map to.
    Map the UDF field
Save All Maps

Whenever you change field mapping, be sure to click the Save All Maps button to save your work!