This guide contains information on a High Growth paid plan feature. For more information on our subscription plans, check out this guide.
Before You Start
Before you start, you will need to:
Enrol on the Veeqo High Growth Paid Plan.
Generate an API key in Veeqo.
NOTE: You will need NetSuite administrator permissions to complete tasks detailed below.
How to Connect Your NetSuite Channel
There are two broad steps to connecting your NetSuite channel into Veeqo.
1. Enabling a connection on NetSuite
To enable a Veeqo connection on NetSuite, follow the steps below:
Enable relevant features
Enable relevant features
Go to NetSuite and login as an admin.
Click Setup > Company > Enable features.
Select SuiteCloud and scroll to the SuiteTalk (Web Services) category. Confirm the below features are enabled:
SOAP WEB SERVICES
REST WEB SERVICES
REST RECORD SERVICE (BETA) - if this isn't available, look for a blue banner at the top of the Enable Features page about enrolling in beta testing. Follow the link and apply to participate in the "Oracle NetSuite Umbrella Beta Program".
Scroll to the Manage Authentication category and ensure that the following features are enabled:
TOKEN-BASED AUTHENTICATION
OAUTH 2.0
Save changes.
Assign the authentication to a role
Assign the authentication to a role
Go to Setup > Users/Roles > Manage Roles.
If you want to create a new role follow the steps below (recommended), otherwise, skip to step 3:
Click on New Role.
In the name field, enter a name for this role. We suggest "Veeqo Integration".
Click on Permissions in the lower panel. You will see 5 options:
Under Transactions, set the following permissions with the appropriate access level:
Customer deposit: Full
Customer payment: Full
Customer refund: Full
Find transaction: Full
Fulfil orders: Full
Sales order: Full
Under Reports, set the following permissions with the appropriate access level:
SuiteAnalytics workbook: Edit
Under Lists, set the following permissions with the appropriate access level:
Subsidiaries: Full
Contacts: Full
Currency: Edit
Customers: Full
Entity-subsidiary relationship view: View
Items: Full
Record custom field: Full
Payment methods: Full
Shipping items: Full
Perform search: Full
Under Setup, set the following permissions with the appropriate access level:
Accounting lists: View
Customer status: Full
Custom fields: View
Custom body fields: View
Custom entity fields: View
Custom record types: View
Custom column fields: View
Custom item fields: View
Custom lists: View
Custom transaction fields: View
Log in using access tokens: Full
REST web services: Full
Click Save.
Assign the role to a user
Assign the role to a user
Go to Setup > Users/Roles > Manage Users.
Select the user you want to update with new permissions.
In the lower panel, select Access.
Assign the Veeqo Integration role that you saved in stage 3.
Save changes.
2. Contact Veeqo to Configure NetSuite
Contact your Account Manager to get NetSuite added to your account! You will receive an email from our integration partner at this stage, your account manager can provide more details.
IMPORTANT: You will not be able to proceed to step 3 until you have spoken with your account manager and been given the go ahead. The NetSuite integration is a paid plan feature and requires configuration updates on our side before you can successfully connect.
3. Create a Veeqo Integration in NetSuite
Create the integration in NetSuite
Create the integration in NetSuite
In NetSuite (logged in as an admin user), go to setup > integration > manage integrations.
Click the new button:
In the name field, we recommend adding "Veeqo Integration".
Set the state field to enabled.
Move down to the token-based authentication section and select "I want to use OAuth 1 authentication in Patchworks". Make sure that the following options are selected:
TOKEN-BASED AUTHENTICATION
TBA: ISSUETOKEN ENDPOINT
TBA: AUTHORIZATION FLOW
CALLBACK URL set to https://app.wearepatchworks.com/oauth/authenticate for the production environment
Select "I don't want to use OAuth 2 (client credentials) authentication in Patchworks" and ensure that no OAuth 2.0 options are selected.
Save changes. At this point, client credentials are provided for this integration. We recommend adding these to a password manager as these credentials are only displayed once and are needed to add Patchworks instances of the NetSuite connector - make sure that you have them noted securely for future reference.
Enable integration using Patchworks
Enable integration using Patchworks
Go to Patchworks and login with the details you received via email.
Hover your mouse on the icons to the left of the screen.
Select "Process Flows" and click on "Connectors and Instances".
Go to NetSuite and select "add Instance".
In the left menu, click on the 3 symbol to expand and click "Connectors and Instances".
Go to Veeqo and select "add Instance".
Give your store a name.
Check your time zone is correct for where you are located, click next step. Date format should reflect your date format preferences. Rate limit should remain untouched.
Select OAuth1 and click next step.
Fill out the webform using the credentials below:
Consumer Key: Generated in Netsuite as part of your initial Veeqo integration
Consumer Secret: Generated in Netsuite as part of your initial Veeqo integration
Account ID: This is always the first element of the URL that you can see having logged into NetSuite.
For example, with the following URL: https://tstdrv1431250.app.netsuite.com/app/center/card.nl?sc=-29&whence= then the account id would be: tstdrv1431250
Token: Generated per user in Netsuite. These values should be added to a password manager at the time they are generated as they can't be re-accessed in NetSuite. If you can't find these credentials, a new set can be generated.
Token Secret: Generated per user in Netsuite. These values should be added to a password manager at the time they are generated as they can't be re-accessed in NetSuite. If you can't find these credentials, a new set can be generated.
Signature Algorithm: Always set to sha256.
Signature Method: Always set to HMAC-SHA256.
Realm: For a NetSuite sandbox the accountid shown in NetSuite (as opposed to your NetSuite URL) typically includes an -SB element - for example: 1234567-SB1. The realm will be the same value EXCEPT that the -SB element changes from a dash to an underscore. So, an accountid of 1234567-SB1 becomes 1234567_SB1 for the realm.
Click create.
IMPORTANT: if you reset credentials that have already been used to configure Patchworks connector instances, process flows will fail until you apply the new credentials.
Once you have completed the above, your orders should start to sync between NetSuite and Veeqo. Contact your account manager who can review the setup and confirm everything is complete.