2024.2 Location Import

General Information

This process can be triggered by using CRON (see: 2024.2 Server Configuration).  This solution is used because locations in NetSuite are not updated often and we don't need to check for updates each time we execute a regular import for other entities. During this step we fetch all locations that existed in NetSuite and validate that they are importable to Magento. If they are, the Connector adds them to the queue. For details see: \RocketWeb\NetSuiteInventoryMultiManagement\Plugin\NetSuiteCron::importToQueue() and \RocketWeb\NetSuiteInventoryMultiManagement\Model\Process\Import\Location::getNetsuiteRequest()

Source Creation/Updating

On next import processing, all previously added locations are extracted from the queue and processed. The processing starts from checking location custom field  custrecord_rw_cf_magento_code, and it should be not empty, as Magento Source is the Primary Key. Using this field and internal ID of the location, the Connector tries to find the previously mapped Sources in Magento. (see details: \RocketWeb\NetSuiteInventoryMultiManagement\Model\MagentoSourceRepository::getSourceByNetSuiteData()). If the Source is found, then it is used for further updating. If nothing is found, the Connector creates an empty Source object and proceeds to Fields Mapping (\RocketWeb\NetSuiteInventoryMultiManagement\Model\Process\Import\Location::process()).

Location Fields Mapping

During this step, the Connector adds information from the Location object to the Source object. Source Code field (custrecord_rw_cf_magento_code) is set only if a new object is created. Other fields that are set:

1. Name
2. Latitude
3. Longitude
4. Contact Name
5. Phone
6. City
7. Country
8. Region
9. Postcode
10. Street
11. Enabled
12. Description
13. netsuite_internal_id

If the NetSuite Location has location type _store, the  Magento Source is created as PickupLocation. Therefore, PickupLocation Frontend Name and Frontend Description are set. Because not all fields in NetSuite exists out of the box, the Connector uses some custom fields that should be created by the RocketWeb Bundle. They are:

1. custrecord_rw_cf_enable_in_magento - used for Enabled Magento field
2. custrecord_rw_cf_magento_code - used for Source Code (is required)
3. custrecord_rw_cf_magento_pickup_desc - used for PickupLocation Frontend Name
4. custrecord_rw_cf_magento_pickup_name - used for PickupLocation Frontend Description

For details refer to \RocketWeb\NetSuiteInventoryMultiManagement\Model\Mapper\ToMagento\Location::transformToMagento().

Saving Sources

After fields map, the Connector saves the source using \Magento\InventoryApi\Api\SourceRepositoryInterface.