diff --git a/docs/articles/expensify-classic/connections/netsuite/Connect-To-NetSuite.md b/docs/articles/expensify-classic/connections/netsuite/Connect-To-NetSuite.md index 1f96d9b8a633..6cc69fccccc1 100644 --- a/docs/articles/expensify-classic/connections/netsuite/Connect-To-NetSuite.md +++ b/docs/articles/expensify-classic/connections/netsuite/Connect-To-NetSuite.md @@ -1,12 +1,11 @@ --- title: NetSuite -description: Set up the direct connection from Expensify to NetSuite. +description: Connect NetSuite to Expensify for streamlined expense reporting and accounting integration. order: 1 --- -# Overview -Expensify's integration with NetSuite allows you to automate report exports, tailor your coding preferences, and tap into NetSuite's array of advanced features. By correctly configuring your NetSuite settings in Expensify, you can leverage the connection's settings to automate most of the tasks, making your workflow more efficient. +Expensify's direct integration with NetSuite allows you to automate report exports, tailor your coding preferences, and tap into NetSuite's array of advanced features. -**Before connecting NetSuite to Expensify, a few things to note:** +## Before connecting NetSuite to Expensify, review the following details: - Token-based authentication works by ensuring that each request to NetSuite is accompanied by a signed token which is verified for authenticity - You must be able to login to NetSuite as an administrator to initiate the connection - You must have a Control Plan in Expensify to integrate with NetSuite @@ -15,9 +14,7 @@ Expensify's integration with NetSuite allows you to automate report exports, tai - Ensure that your workspace's report output currency setting matches the NetSuite Subsidiary default currency - Make sure your page size is set to 1000 for importing your customers and vendors. You can check this in NetSuite under **Setup > Integration > Web Services Preferences > 'Search Page Size'** -# Connect to NetSuite - -## Step 1: Install the Expensify Bundle in NetSuite +# Step 1: Install the Expensify Bundle in NetSuite 1. While logged into NetSuite as an administrator, go to Customization > SuiteBundler > Search & Install Bundles, then search for "Expensify" 2. Click on the Expensify Connect bundle (Bundle ID 283395) @@ -25,13 +22,13 @@ Expensify's integration with NetSuite allows you to automate report exports, tai 4. If you already have the Expensify Connect bundle installed, head to _Customization > SuiteBundler > Search & Install Bundles > List_ and update it to the latest version 5. Select **Show on Existing Custom Forms** for all available fields -## Step 2: Enable Token-Based Authentication +# Step 2: Enable Token-Based Authentication 1. Head to _Setup > Company > Enable Features > SuiteCloud > Manage Authentication_ 2. Make sure “Token Based Authentication” is enabled 3. Click **Save** -## Step 3: Add Expensify Integration Role to a User +# Step 3: Add Expensify Integration Role to a User The user you select must have access to at least the permissions included in the Expensify Integration Role, but they're not required to be an Admin. 1. In NetSuite, head to Lists > Employees, and find the user you want to add the Expensify Integration role to @@ -40,7 +37,7 @@ The user you select must have access to at least the permissions included in the Remember that Tokens are linked to a User and a Role, not solely to a User. It's important to note that you cannot establish a connection with tokens using one role and then switch to another role afterward. Once you've initiated a connection with tokens, you must continue using the same token/user/role combination for all subsequent sync or export actions. -## Step 4: Create Access Tokens +# Step 4: Create Access Tokens 1. Using Global Search in NetSuite, enter “page: tokens” 2. Click **New Access Token** @@ -49,21 +46,20 @@ Remember that Tokens are linked to a User and a Role, not solely to a User. It's 5. Press **Save** 6. Copy and Paste the token and token ID to a saved location on your computer (this is the only time you will see these details) -## Step 5: Confirm Expense Reports are Enabled in NetSuite. +# Step 5: Confirm Expense Reports are Enabled in NetSuite. Enabling Expense Reports is required as part of Expensify's integration with NetSuite: 1. Logged into NetSuite as an administrator, go to Setup > Company > Enable Features > Employees 2. Confirm the checkbox next to Expense Reports is checked 3. If not, click the checkbox and then Save to enable Expense Reports -## Step 6: Confirm Expense Categories are set up in NetSuite. +# Step 6: Confirm Expense Categories are set up in NetSuite. Once Expense Reports are enabled, Expense Categories can be set up in NetSuite. Expense Categories are an alias for General Ledger accounts used to code expenses. - 1. Logged into NetSuite as an administrator, go to Setup > Accounting > Expense Categories (a list of Expense Categories should show) 2. If no Expense Categories are visible, click **New** to create new ones -## Step 7: Confirm Journal Entry Transaction Forms are Configured Properly +# Step 7: Confirm Journal Entry Transaction Forms are Configured Properly 1. Logged into NetSuite as an administrator, go to _Customization > Forms > Transaction Forms_ 2. Click **Customize** or **Edit** next to the Standard Journal Entry form @@ -71,7 +67,7 @@ Once Expense Reports are enabled, Expense Categories can be set up in NetSuite. 4. Click the sub-header Lines and verify that the "Show" column for "Receipt URL" is checked 5. Go to _Customization > Forms > Transaction Forms_ and ensure all other transaction forms with the journal type have this same configuration -## Step 8: Confirm Expense Report Transaction Forms are Configured Properly +# Step 8: Confirm Expense Report Transaction Forms are Configured Properly 1. Logged into NetSuite as an administrator, go to _Customization > Forms > Transaction Forms_ 2. Click **Customize** or **Edit** next to the Standard Expense Report form, then click **Screen Fields > Main** @@ -79,7 +75,7 @@ Once Expense Reports are enabled, Expense Categories can be set up in NetSuite. 4. Click the second sub-header, Expenses, and verify that the 'Show' column for 'Receipt URL' is checked 5. Go to _Customization > Forms > Transaction Forms_ and ensure all other transaction forms with the expense report type have this same configuration -## Step 9: Confirm Vendor Bill Transactions Forms are Configured Properly +# Step 9: Confirm Vendor Bill Transactions Forms are Configured Properly 1. Logged into NetSuite as an administrator, go to _Customization > Forms > Transaction Forms_ 2. Click **Customize** or **Edit** next to your preferred Vendor Bill form @@ -87,20 +83,20 @@ Once Expense Reports are enabled, Expense Categories can be set up in NetSuite. 4. Under the Expenses sub-header (make sure to click the "Expenses" sub-header at the very bottom and not "Expenses & Items"), ensure "Show" is checked for Receipt URL, Department, Location, and Class 5. Go to _Customization > Forms > Transaction Forms_ and provide all other transaction forms with the vendor bill type have this same configuration -## Step 10: Confirm Vendor Credit Transactions Forms are Configured Properly +# Step 10: Confirm Vendor Credit Transactions Forms are Configured Properly 1. While logged in as an administrator, go to _Customization > Forms > Transaction Forms_ 2. Click **Customize** or **Edit** next to your preferred Vendor Credit form, then click _Screen Fields > Main_ and verify that the "Created From" label has "Show" checked and that Departments, Classes, and Locations have the "Show" label unchecked 3. Under the Expenses sub-header (make sure to click the "Expenses" sub-header at the very bottom and not "Expenses & Items"), ensure "Show" is checked for Receipt URL, Department, Location, and Class 4. Go to _Customization > Forms > Transaction Forms_ and ensure all other transaction forms with the vendor credit type have this same configuration -## Step 11: Set up Tax Groups (only applicable if tracking taxes) +# Step 11: Set up Tax Groups (only applicable if tracking taxes) Expensify imports NetSuite Tax Groups (not Tax Codes), which you can find in NetSuite under _Setup > Accounting > Tax Groups_. Tax Groups are an alias for Tax Codes in NetSuite and can contain one or more Tax Codes (Please note: for UK and Ireland subsidiaries, please ensure your Tax Groups do not have more than one Tax Code). We recommend naming Tax Groups so your employees can easily understand them, as the name and rate will be displayed in Expensify. -Before importing NetSuite Tax Groups into Expensify: +## Before importing NetSuite Tax Groups into Expensify: 1. Create your Tax Groups in NetSuite by going to _Setup > Accounting > Tax Groups_ 2. Click **New** 3. Select the country for your Tax Group @@ -115,9 +111,9 @@ Ensure Tax Groups can be applied to expenses by going to _Setup > Accounting > S If this field does not display, it’s not needed for that specific country. -## Step 12: Connect Expensify and NetSuite +# Step 12: Connect Expensify and NetSuite -1. Log into Expensify as a Policy Admin and go to **Settings > Workspaces > _[Workspace Name]_ > Connections > NetSuite** +1. Log into Expensify as a Workspace Admin and go to **Settings > Workspaces > _[Workspace Name]_ > Connections > NetSuite** 2. Click **Connect to NetSuite** 3. Enter your Account ID (Account ID can be found in NetSuite by going to _Setup > Integration > Web Services Preferences_) 4. Then, enter the token and token secret diff --git a/docs/assets/images/NetSuite_Configure_06.png b/docs/assets/images/NetSuite_Configure_06.png new file mode 100644 index 000000000000..cddfe2fabcd6 Binary files /dev/null and b/docs/assets/images/NetSuite_Configure_06.png differ diff --git a/docs/assets/images/NetSuite_Configure_08.png b/docs/assets/images/NetSuite_Configure_08.png new file mode 100644 index 000000000000..77690a2c3aa1 Binary files /dev/null and b/docs/assets/images/NetSuite_Configure_08.png differ diff --git a/docs/assets/images/NetSuite_Configure_09.png b/docs/assets/images/NetSuite_Configure_09.png new file mode 100644 index 000000000000..8da56f22838d Binary files /dev/null and b/docs/assets/images/NetSuite_Configure_09.png differ diff --git a/docs/assets/images/NetSuite_Configure_Advanced_10.png b/docs/assets/images/NetSuite_Configure_Advanced_10.png new file mode 100644 index 000000000000..23fe99498052 Binary files /dev/null and b/docs/assets/images/NetSuite_Configure_Advanced_10.png differ diff --git a/docs/assets/images/NetSuite_Connect_Bundle_02.png b/docs/assets/images/NetSuite_Connect_Bundle_02.png new file mode 100644 index 000000000000..c015178873ad Binary files /dev/null and b/docs/assets/images/NetSuite_Connect_Bundle_02.png differ diff --git a/docs/assets/images/NetSuite_Connect_Categories_05.png b/docs/assets/images/NetSuite_Connect_Categories_05.png new file mode 100644 index 000000000000..e71341170129 Binary files /dev/null and b/docs/assets/images/NetSuite_Connect_Categories_05.png differ diff --git a/docs/assets/images/NetSuite_Connect_Customization_01.png b/docs/assets/images/NetSuite_Connect_Customization_01.png new file mode 100644 index 000000000000..8a0c53b45d7f Binary files /dev/null and b/docs/assets/images/NetSuite_Connect_Customization_01.png differ diff --git a/docs/assets/images/NetSuite_Connect_Expense_Reports_03.png b/docs/assets/images/NetSuite_Connect_Expense_Reports_03.png new file mode 100644 index 000000000000..44c8fe6c993d Binary files /dev/null and b/docs/assets/images/NetSuite_Connect_Expense_Reports_03.png differ diff --git a/docs/assets/images/NetSuite_Expense_Categories_04.png b/docs/assets/images/NetSuite_Expense_Categories_04.png new file mode 100644 index 000000000000..d13e9f95cfea Binary files /dev/null and b/docs/assets/images/NetSuite_Expense_Categories_04.png differ diff --git a/docs/assets/images/NetSuite_HelpScreenshot_07.png b/docs/assets/images/NetSuite_HelpScreenshot_07.png new file mode 100644 index 000000000000..55cfe532f890 Binary files /dev/null and b/docs/assets/images/NetSuite_HelpScreenshot_07.png differ