The Item Fields Bundle automates the creation of the fields in NetSuite you will need to use our product sync features. If you are enabling full product sync you will need to install the item fields bundle in addition to the standard FarApp bundle you have already installed. The item fields bundle performs the following tasks:

1. Creates flag fields in NetSuite that are used to tell FarApp how to handle the product in relation to our product sync. For more information on the storefront flag fields see this article: https://support.farapp.com/hc/en-us/articles/217185977-Storefront-Flag-Fields
2. Creates custom fields in NetSuite for specific marketplace/cart data. For example, the ASIN and Product Type fields for Amazon are created.
3. Pre-populates the product mappings in FarApp to use common NetSuite fields as well as the custom fields the bundle created in NetSuite. WARNING: If you create product mappings before you install the Item Fields Bundle, the bundle will detect that you have existing mappings and completely abort the auto-mapping process so as not to interfere with what was already set. This may leave you with many required fields to manually map.

Installing The Bundle

NOTE: You will need to follow ALL the steps below in each section to complete installing the FarApp Marketplace/Cart Item Fields Bundle correctly. 

Creating Subtabs for the Item Creation Screen

When you create an item in NetSuite, you will need to populate a number of fields with information like the item's description, weight, color, etc. NetSuite organizes these fields within Subtabs. FarApp requires several unique fields in order to sync your items from NetSuite to your storefronts automatically. These steps will walk you through creating these special Subtabs for these fields.

1. Make sure you are logged into your NetSuite account.
2. Navigate to Customization > Forms > Subtabs.
3. Navigate to the Item tab.
4. Add a TITLE field for each of the storefronts that you will be adding a connector for.
   1. The list of storefronts includes: Amazon, BigCommerce, ChannelAdvisor, eBay, Jet, Magento, Magento2, Miva, Shopify, Spree, Walmart, WooCommerce.
   2. For the value of the TITLE field, populate the storefront name exactly as in the list above. Note that it is Magento2 NOT Magento 2.
5. Select Add. The example below shows what would be entered for the storefront BigCommerce:
   
   
   
6. Also add the following in its own TITLE field: Marketplace/Cart.
   1. Once entered, select Add.
   2. For the example of adding the storefront BigCommerce, the screen will now appear similar to what is shown below.
      
      
7. Select Save.
8. You will be redirected to the Setup Manager Menu.
   
   
   
   
9. From the navigation menu on the left-side of the screen, select Forms > Subtabs.
   
   
   
   
10. You will be returned to the Custom Subtabs menu. Now create additional fields, 3 of which will nest under the newly created storefront name field and 2 of which will nest under the Marketplace/Cart field. To do this, navigate to the Item tab again.
11. Add the 3 additional TITLE fields for each of the storefronts that you will be adding a connector for:
    1. Add Required to the TITLE field and select the storefront that you just created as the PARENT field from the available drop-down.
    2. Add Optional to the TITLE field and select the storefront that you just created as the PARENT field from the available drop-down.
    3. Add Not Common to the TITLE field and select the storefront that you just created as the PARENT field from the available drop-down.
12. Add the 2 additional TITLE fields for Marketplace/Cart:
    1. Add Required to the TITLE field and select Marketplace/Cart as the PARENT field from the available drop-down.
    2. Add Optional to the TITLE field and select Marketplace/Cart as the PARENT field from the available drop-down.
13. For the example of adding the storefront BigCommerce, your Custom Subtabs > Item tab will look similar to the screenshot below. Select Save.
    
    
    
14. Please note that if you named something above incorrectly, during the upcoming "Creating the Product Sync Fields Using Item Fields Bundle" Step #5, the Item Fields bundle will provide feedback if the above Custom Subtabs have an error and if so, which tab or Subtab you need to return to and recreate.

The above process is demonstrated below with Magento 2. (Click to enlarge the image) 

Installing the Item Fields Bundle on NetSuite

1. To begin installing the bundle, login to your NetSuite account.
2. Navigate to Customization > SuiteBundler > Search & Install Bundles.
3. Enter ‘FarApp Marketplace/Cart - Item Fields’ in the KEYWORDS field and Click Search (see screenshot below).
   
   
   
4. Under “Name”, select the clickable text FarApp Marketplace/Cart - Item Fields .
5. Click Install.
6. Click Install Bundle, then click Ok on the popup window.
7. This will redirect you to the list of your installed bundles. You will see the first in the list as “Loading”. After allowing some time, click Refresh and confirm you see “FarApp Marketplace/Cart - Item Fields"

 The above process is demonstrated below. (Click to enlarge the image) 

Creating the Product Sync Fields Using Item Fields Bundle

1. After the FarApp Marketplace/Cart - Item Fields bundle has been installed, navigate to Setup >FarApp > Marketplace/Cart Fields.
   
   
   
   
2. Select the Marketplace/Cart you will be integrating with. For this example, we have selected "Shopify". If you don't see the particular marketplace/cart you are using please open a support ticket so we can further assist you.
3. Then enter the number of accounts you plan to set up with FarApp for that Marketplace/Cart. For this example, we have entered "1".
   • You will need to do this multiple times if you have multiple Marketplaces/Carts that you want to integrate.
     
     
     
4. Select Submit.
5. One of the following messages will populate:
   • If this message says that the fields are being created and that an email will be sent when the field creation task is finished, then you have completed the steps for installing the FarApp Marketplace/Cart - Item Fields Bundle.
   • If there were errors in creating the Custom Subtabs, the error message will populate at this point with the "RESULT" and the reason for the error. If you receive a RESULT about a missing required Subtab, go back to the steps in the "Creating Subtabs for the Item Creation Screen" section and review the parent tab and Subtabs. Storefront names must match the Marketplace/Cart field exactly as indicated.

  The above process is demonstrated below for a single Magento 2 account. (Click to enlarge the image) 

How to Use the Flag Field

For information on the values in the flag field and how to use them please refer to this article https://farapp.zendesk.com/hc/en-us/articles/217185977

Updating the Bundle

When a new version of the FarApp Marketplace/Cart - Item Fields bundle is released you can update the bundle by following the below procedure.

1. Log in to NetSuite.
2. Navigate to Customization > SuiteBundler > Search & Install Bundles > List.
   
   
   
   
3. Locate the FarApp Marketplace/Cart - Item Fields bundle in the list of bundles then click the green arrow to the left and select Update.
   
   
   
4. Periodically, we release updates to the Item Fields Bundle. When previewing a bundle update, make sure that the "Preference" drop-down is set to Replace Data.
   
   
   
   
5. The update preview will appear. Change the Preference dropdown for the FarApp Marketplaces/Carts entry under Lists (usually the top entry) to Replace Data.
   
   
   
6. Finally click Update Bundle then click Ok on the popup window to initiate the update process.
   
   
   

7. You will be returned to your list of bundles. The bundle will show a green check in the Status column once the update is complete. Note that the update process can take some time to complete.

The above process is demonstrated below. (click to enlarge the image)