Connect To NetSuite
Expensify integrates directly with NetSuite to automate report exports, customize your coding preferences, and leverage NetSuite’s advanced features. Follow the steps below to set up the integration.
Before You Connect NetSuite to Expensify
- Token-based authentication ensures each request to NetSuite is signed and verified for authenticity.
- You must have administrator access in NetSuite to initiate the connection.
- Control Plan in Expensify is required for this integration.
- Employees do not need NetSuite access or a license to submit expense reports; the integration is managed by the Workspace Admin.
- Each NetSuite subsidiary requires its own Expensify Group Workspace.
- Verify that your workspace’s report output currency matches the NetSuite Subsidiary’s default currency.
- Set your Search Page Size to 1000 in NetSuite under Setup > Integration > Web Services Preferences > ‘Search Page Size’.
Step 1: Install the Expensify Bundle in NetSuite
- Log into NetSuite as an administrator and go to Customization > SuiteBundler > Search & Install Bundles.
- Search for “Expensify” and select the Expensify Connect bundle (Bundle ID 283395).
- Click Install.
- If you already have the Expensify Connect bundle installed, go to Customization > SuiteBundler > Search & Install Bundles > List and update to the latest version.
- Ensure Show on Existing Custom Forms is selected for all available fields.
Step 2: Enable Token-Based Authentication
- In NetSuite, navigate to Setup > Company > Enable Features > SuiteCloud > Manage Authentication.
- Enable Token-Based Authentication.
- Click Save.
Step 3: Add Expensify Integration Role to a User
The user you assign this role to must have the required permissions but does not need to be an administrator.
- Go to Lists > Employees in NetSuite and find the employee you wish to add the Expensify Integration role to.
- Click Edit > Access, select the Expensify Integration role from the dropdown, and assign it to the user.
- Click Save.
Note: Tokens are tied to both the user and role. You cannot change the role once the token-based connection has been established. Always use the same user/role combination for syncing or exporting.
Step 4: Create Access Tokens
- Use Global Search in NetSuite to search for “page: tokens”.
- Click New Access Token.
- Select Expensify as the application.
- Choose the Expensify Integration role.
- Click Save.
- Copy the Token and Token ID and save them securely, as they will only be visible once.
Step 5: Confirm Expense Reports are Enabled in NetSuite
- Log into NetSuite as an administrator and go to Setup > Company > Enable Features > Employees.
- Ensure the Expense Reports checkbox is checked.
- If not, check it and click Save.
Step 6: Confirm Expense Categories are Set Up in NetSuite
- Go to Setup > Accounting > Expense Categories in NetSuite.
- If no Expense Categories are visible, click New to create them.
Step 7: Confirm Journal Entry Transaction Forms are Configured Properly
- Navigate to Customization > Forms > Transaction Forms.
- Click Customize or Edit next to the Standard Journal Entry form.
- Under Screen Fields > Main, ensure the “Created From” label is set to Show and the Display Type is set to Normal.
- Under the Lines sub-header, verify that Receipt URL is set to Show.
- Repeat this for all other journal-type transaction forms.
Step 8: Confirm Expense Report Transaction Forms are Configured Properly
- Go to Customization > Forms > Transaction Forms in NetSuite.
- Click Customize or Edit next to the Standard Expense Report form.
- Under Screen Fields > Main, ensure the “Created From” label is set to Show and the Display Type is Normal.
- Under the Expenses sub-header, verify that Receipt URL is set to Show.
- Repeat this for all other expense report-type transaction forms.
Step 9: Confirm Vendor Bill Transactions Forms are Configured Properly
- Navigate to Customization > Forms > Transaction Forms in NetSuite.
- Click Customize or Edit next to your preferred Vendor Bill form.
- Under Screen Fields > Main, ensure the “Created From” label is set to Show and that Departments, Classes, and Locations have the “Show” label unchecked.
- Under the Expenses sub-header, ensure Receipt URL, Department, Location, and Class are set to Show.
- Repeat for all other vendor bill-type transaction forms.
Step 10: Confirm Vendor Credit Transactions Forms are Configured Properly
- Navigate to Customization > Forms > Transaction Forms in NetSuite.
- Click Customize or Edit next to your preferred Vendor Credit form.
- Under Screen Fields > Main, ensure the “Created From” label is set to Show and that Departments, Classes, and Locations have the “Show” label unchecked.
- Under the Expenses sub-header, ensure Receipt URL, Department, Location, and Class are set to Show.
- Repeat for all other vendor credit-type transaction forms.
Step 11: Set Up Tax Groups (only if tracking taxes)
Tax Groups in NetSuite are imported into Expensify, and they act as aliases for Tax Codes.
- Go to Setup > Accounting > Tax Groups in NetSuite.
- Click New to create a new Tax Group.
- Select the country and Tax Name (this will be visible to employees in Expensify).
- Choose the relevant Tax Code and Subsidiary.
- Click Save.
Ensure Tax Groups can be applied to expenses by setting the Tax Code Lists Include preference to Tax Groups And Tax Codes or Tax Groups Only in Setup > Accounting > Set Up Taxes.
Step 12: Connect Expensify and NetSuite
- Log into Expensify as a Workspace Admin and go to Settings > Workspaces > [Workspace Name] > Connections > NetSuite.
- Click Connect to NetSuite.
- Enter your Account ID (found in NetSuite under Setup > Integration > Web Services Preferences).
- Enter the token and token secret.
- Click Connect to NetSuite.
After connecting, the NetSuite connection will sync, and the configuration dialogue box will appear.
Note: The connection must be created using a NetSuite account with the Expensify Integration role.
FAQ
Can negative expenses be exported to NetSuite?
Yes, you can export reports with negative totals to NetSuite by selecting Vendor Bill as your export option. A Vendor Credit will be created in NetSuite instead of a bill.
Important: Only enable this if you pay employees/vendors outside of Expensify.
How do you switch the owner of the connection between NetSuite and Expensify?
To transfer the connection ownership:
- Navigate to Settings > Workspaces > Workspace Name > Connections > NetSuite.
- Click Configure to review the current settings.
- Select Do not connect to NetSuite, then Connect to NetSuite again.
- Enter the new admin’s email address and NetSuite account ID.
- Follow the steps to reconfigure the connection.