Write-Back to Dynamics 365 Sales Orders

StarShip writes back freight and shipment detail for each Sales Order after you Ship/Process it. Write-Back depends upon how you configured Dynamics 365 BC Settings and Custom Write-Back Setup in Setup > Source Interfaces > Microsoft Dynamics 365 Business Central.

Settings

When a shipment is processed in StarShip

This option in Settings will determine where freight and shipment information will write back. Below are the three possible selections:

“Do not change the Sales Order Status”

StarShip will write back to the Sales Order and update the Sales Order line items and the StarShip section of the Sales Order. StarShip will not change the status of the Sales Order so you will need to “Ship” or “Ship and Invoice” the Sales Order (from Posting > Post) to post it. Once fully shipped, the Sales Order will be archived and the StarShip write-back information will no longer be available.

“Ship the Sales Order”

StarShip will post the Sales Order and create a Posted Sales Shipment. The freight and line items are updated on the Posted Sales Shipment, as well as the StarShip section containing Notes, Packages, and Custom Fields (if set up in Custom Write-Back).

“Ship and Invoice the Sales Order”

StarShip posts the Sales Order, creates a Posted Sales Shipment, and also creates a Posted Sales Invoice. The freight and line items are updated on the Posted Sales Shipment, as well as the StarShip section containing Notes, Packages, and Custom Fields (if set up in Custom Write-Back).

Write-Back Results

Freight

Freight is written to a line in the Lines grid, to the line type and line code you specified in Dynamics 365 BC Settings.

Shipment Detail (Notes)

Header Fields

Write-back settings for these fields are set up in Custom Write-Back Setup.

Shipment Date

StarShip writes the “Booked Date/Time” back to the Shipment Date under Shipping and Billing section.

Shipping Method Agent

StarShip will write the value from the StarShip “Ship Carrier Name” field back to the Agent field under Shipping Method in the Shipping and Billing section.

Shipping Method Agent Service

StarShip will write the value from the StarShip “Ship Carrier Service” field (or whatever field you mapped to) to the Agent Service field under Shipping Method in the Shipping and Billing section.

Package Tracking No.

By default, StarShip will write the Master Tracking # to the Package Tracking No. field.

Custom fields

If you set up custom fields for write-back at the “All” Header and/or Order Header level, values from those fields will populate the table in StarShip Custom Fields section. See Custom Write-Back Setup for more information.

Line Item Fields

Write-back settings for these fields are set up in Custom Write-Back Setup.

Shipment Date

StarShip will update the Shipment Date with the “Booked Date/Time” value on the General > Lines grid for each item.

Quantity Shipped

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.

 

Package Fields

Write-back settings for these fields are set up in Custom Write-Back Setup. StarShip will write back the values for any custom fields you added to the Sales Order at the package level to the StarShip Packages section. Click the arrow next to the StarShip Packages heading and select Go to Custom Fields.

The custom fields will display with the values from the StarShip fields you mapped to.

Voiding Shipments

When you void a shipment, StarShip will remove the corresponding rows from the StarShip Packages table.