StarShip supports write-back to several custom fields in Dynamics GP. Most custom fields on the Sales Transaction can be updated both when the shipment is processed in the StarShip Client (Ship) or when the user applies a rate from StarShip Rate Quote (Rate). Certain fields listed below can only be updated on Ship. Custom fields must be mapped to StarShip fields in order for write-back to occur. Write-back to line item fields on Rate is not supported. If a shipment is deleted, no updates are made to custom fields.
In order to write back to specific Sales Transaction Line items on Ship, two of the Line Item Key fields must be mapped to the StarShip shipment. You will receive errors upon write-back to Line Item fields if the Line Item Key fields are not mapped. Perform these steps for both fields.
Under Target fields, expand the Shipment field group.
Click on Line Item and then select Extra Key1 (or Extra Key2) field in the center panel. Set the Field Mapping Source to "Dynamics GP Field". The Sales Trx Field will populate with fields from the sales transaction.
Configure the Sales Trx Field for Extra Key1 : Line Item Sequence
and Extra Key2 : Component Sequence Number
The following line item fields can be updated when shipping the Sales Transaction :
GPS FO Integration ID
Integration ID
Date Shipped (Line)
Date Fulfilled (Line)
For the date fields, the selected StarShip field must be a date field; users will receive an error if any other type of value is selected.
Line Item fields
Address User-Defined 1 - 2 (Bill To)
Sales Transaction User-Defined 1--3
These fields support write-back for both "On : Rate" and "On : Ship". For more information about how write-back occurs for each of these methods (Rate, Ship, and Both), click the "More info" link next to the "On" setting.
Shipping Method
In order to update the Shipping Method on the Sales Transaction, you have to map it to the StarShip Ship Carrier Ship Via field and set up value translations.
If the Shipping Method is modified in the StarShip Client, it will be updated on the GP Sales Transaction.
If the Shipping Method is modified on the Rate Quote screen, the user will be prompted to update the ship method on write-back. The user will also receive a prompt if value translations are not set up or if there is a translated value that no longer exists in Dynamics GP.
See Ship Method for more information.
Ship To Address (1, 2, 3), City, State, ZIP Code fields
To update the Ship To Address information in Dynamics GP, map the Ship To GP fields to the StarShip Recipient Address fields. If the address fields are changed in the StarShip Client, the corresponding Address ID will be automatically updated in Dynamics GP. If changes are made to the address fields on the Rate Quote screen, the user will be prompted to apply the address change to the Address ID when applying the Rate Quote. See Ship To Address for more information.
