The logic described below was implemented in two separate modules - NetSuiteShipment and NetSuiteSipmentMultiSource.

NetSuiteSipmentMultiSource requires and extends NetSuiteShipment. NetSuiteSipmentMultiSource is not compatible with NetSuiteSipmentSingleSource!

Shipment is the post-process of the Order Export Process. Once the Order is exported and an Item Fulfillment is created, the Shipment process is triggered. The process \RocketWeb\NetSuiteFulfillment\Model\Process\Import\Fulfillment::process() transforms the Item Fulfillment into Magento format.

Splitting and Grouping

To support Magento MSI, the NetSuite Connector check all items in the Item Fulfillment. It checks that items' locations are imported to Magento as Sources. For those items that have a mapped location, the Connector creates a new Item Fulfillment object based on the initial one. Also during this process, it groups all items with different locations to separate Item Fulfillments. For details, see: \RocketWeb\NetSuiteShipmentMultiSource\Model\Mapper\ShipmentMultiSource\LocationGrouper::group().

As result, we have a list of Item Fulfilments that are further processed. The same is true for the SingleSource scenario.

Transform Item Fulfillment into Magento Format

Each record/item created before Item Fulfillments is mapped to Magento Format. The \RocketWeb\NetSuiteShipmentSingleSource\Model\Mapper\ShipmentSingleSource::getMagentoFormat() checks a few basic conditions:

Item Fulfillment was created from a Sales Order
Item Fulfillment has a Customer linked to it
A Magento Order exists for the Sales Order linked from the Item Fulfillment

and if all pass, the $magentoShipping gets set:

store ID
Customer ID
Billing Address ID
Shipping Address

The $magentoShipping then runs through CopyService sales_covert_order => to_shipment to copy the data and modifies the Shipment Items list in \RocketWeb\NetSuiteShipmentSingleSource\Model\Mapper\ShipmentSingleSource::addShipmentItems() which filters the Items and their quantities to match the Item Fulfillment Item List.

Clean Existing Magento Shipment

Once we have the $magentoShipment set, we check for existing shipments and run the cleanup logic in \RocketWeb\NetSuiteFulfillment\Model\Process\Import\Fulfillment\CleanUpManager::prepare() where we clean up existing shipments & tracking information. We also leave a comment in the Magento Order for the first Item Fulfillment received.

Save Shipment

With the cleanup is done, we save the $magentoShipping and check if we should send Tracking Information. The decision to send Tracking Information (see \RocketWeb\NetSuiteFulfillment\Model\Process\Import\Fulfillment\TrackingInfoSender::isSentTrackingInformation()) has a few conditions:

The configuration is set
Shipment doesn't exist yet
The tracking number in Item Fulfillment exists and it hasn't been used yet

And based on them, the Tracking Number is then sent in \RocketWeb\NetSuiteFulfillment\Model\Process\Import\Fulfillment\TrackingInfoSender::sendTrackingInformation()

Browser not supported