General Information

Important Note

This process requires RocketWeb Magneto 2 Quotes NetSuite Bundle to be installed in NetSuite. The bundle creates the required Custom Record (Magento Comments) and other customizations that are needed for the synchronization process to work.

This process starts after the Customer sends Magento Quote to Admin for review. Connector adds this quote to queue according to 2024.1 3. Export process flow.

If the processing Magento Quote was not exported to NetSuite before (netsuite_internal_id is not set), the Connector will create the Magento quote. Then the Connector will add a new Comment to NetSuite and set Quote Processed custom field to false.

Create NetSuite Quote

NetSuite Quote creation starts from pulling Magento Quote Object (see \RocketWeb\NetSuiteQuote\Model\NetSuiteQuoteRepository::add()). Afterwards Connector builds NetSuite Quote Object mapping Magento Quote fields to it (see \RocketWeb\NetSuiteQuote\Model\Mapper\ToNetSuite\Quote::getNetsuiteFormat()). Then data is mapped:

The Customer that created the Quote (RocketWeb/NetSuiteQuote/Model/Mapper/ToNetSuite/Quote/Customer.php)
Item List (RocketWeb/NetSuiteQuote/Model/Mapper/ToNetSuite/Quote/ItemList.php)
Quote Probability (used Store Admin Config 2024.1 Quote Settings)
Quote Shipping Method (used Store Admin Config 2024.1 Quote Settings)
Is Magento Quote Custom Field (set to true (part of our NetSuite Bundle))

After mapping is done, the Connector sends Add Request to Netsuite (\RocketWeb\NetSuiteQuote\Model\NetSuiteQuoteRepository::add()), gets internalId from the response, sets it to Magento Quote custom attribute netsuite_internal_id, and saves the Magento Quote.

The next step is sending Quote Comments to NetSuite.

Send Magento Quote Comments to NetSuite

NetSuite Quote does not have Comments out of the box. Comments are created as Custom Record and processed via SuiteScript code (both provided with RocketWeb Magneto 2 Quotes NetSuite Bundle as part of the installation services).

The Connector fetches all Comments for a current quote that don't have a netsuite_internal_id set (so it is not Export or Import during 2024.1 [b2b] Quote Updates Import from NetSuite) - \RocketWeb\NetSuiteQuote\Model\Process\Import\QuoteUpdate\CommentsImport::importComments().

When exporting, each comment is used for building the NetSuite Comment Object. The Comment Data is mapped:

quoteId
comment text (Customer Comment)

The object creation happens in \RocketWeb\NetSuiteQuote\Model\Mapper\ToNetSuite\QuoteComment::getNetsuiteFormat(). When an object is created, the Connector sends it to NetSuite as part of AddRequest (see: \RocketWeb\NetSuiteQuote\Model\NetSuiteQuoteRepository::addCommentToQuote()). As a final step, netsuite_internal_id is built from the response which is set to Magento Quote Comment and saved. This helps avoid multiple comments being added.

Note

To keep Core Magento business logic intact, the RocketWeb NetSuite Connector does not update Comments. Also, it is not possible to export any kind of Attachments. Therefore, the possibility to add Attachments for Customers was removed programmatically (see: RocketWeb/NetSuiteQuote/view/frontend/layout/negotiable_quote_quote_view.xml).

Update NetSuite Quote

Once we export the Quote and process all the comments successfully, we update the Quote Processed Custom Field in NetSuite. RocketWeb NetSuite Connector builds and sends the Updated Request by setting only one field to true (see: \RocketWeb\NetSuiteQuote\Model\NetSuiteQuoteRepository::updateQuoteProcessed()). The update also will be triggered if no Comments were added by the customer, but they send the Magento Quote to Merchant.

Browser not supported