StarShip supports write-back to custom and other fields in Dynamics 365 BC. Some custom fields on the Sales Orders, Sales Invoices, and Order Lines can be updated both when the shipment is processed in StarShip (Ship) and/or when the user applies a rate with 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.
Header Fields
Some of these fields are mapped by default so that the shipment value writes back to Dynamics 365 BC. Other fields can be mapped to write back to Dynamics 365 BC as desired.
Package Tracking Number
By default, this field is mapped to the Master Tracking #. It writes the tracking number for each package back to the Shipping and Billing section in Dynamics 365 BC. If you would like to use this field for something else, you can change the mapping.
Shipment Date
This field writes back to the Shipment Date under Shipping and Billing section in Dynamics 365. This field can be mapped to the StarShip “Booked Date/Time” field to use it as the Shipment Date.
Shipping Method Agent
This field writes back to the Agent field under Shipping Method in the Shipping and Billing section in Dynamics 365. It is used to write back the carrier name used to ship. By default, this field is mapped to the StarShip “Ship Carrier Name” field. StarShip recognizes some default keywords for Carrier Names when importing source documents; however, in order to avoid errors when shipping, you can configure Value Translations to translate the “Shipping Method Agent”values you have set up in Dynamics 365 to StarShip “Ship Carrier Name” field values.
Shipping Method Agent Service
This field writes back to the Agent Service field under Shipping Method in the Shipping and Billing section in Dynamics 365. It is used to write back the carrier service from a shipment. By default, it is mapped to the StarShip “Ship Carrier Service” field.
In order to avoid errors during write-back while shipping, set up the Value Translations to translate the “Shipping Method Agent Service” values you have set up in Dynamics 365 to StarShip “Ship Carrier Service” values.
Dynamics 365 BC Custom Fields
Any custom fields you added to the Sales Order, Sales Invoice or Order Lines header will appear here and are available for write-back. These fields can be mapped to StarShip User Definable fields so that you can write-back custom shipment information to your custom fields in Dynamics 365.
Line Item Fields
Quantity Shipped
After processing a shipment, StarShip will update the Quantity Shipped field on the General > Lines grid for each item with the value from the StarShip Line Item Total Shipped Qty field.
Shipment Date
This field writes back to the Shipment Date on the General > Lines grid for each item. This field can be mapped to the StarShip “Booked Date/Time” field to use it as the Shipment Date.
Package Fields
Dynamics 365 BC Custom Fields
Any custom fields you added to the Sales Order, Sales Invoice or Order Lines at the package level will appear here and are available for write-back to the StarShip > Packages table in Dynamics 365. These fields can be mapped to StarShip User Definable fields so that you can write back custom shipment information to your custom fields in Dynamics 365.