App Installation

installation of breadwinner for netsuite is a simple but critical process please review this guide documentation prior to installing the application from the appexchange for best success prerequisites for app installation breadwinner for netsuite is a robust package with many facets to support netsuite due to the complexity of the many objects and records found in netsuite we suggest breadwinner for netsuite should be installed in salesforce enterprise edition or greater installed by a full salesforce administrator account netsuite keys provided by a full netsuite administrator account salesforce now requires a trailblazer account to install apps from the appexchange app installation installation of the breadwinner for netsuite app is done from the salesforce appexchange following the same familiar process as other apps please note however, we suggest you select install for admins only during this installation this follows best practices for data security, controlling general user access to breadwinner data when needed and not exposed by default once the application has been fully installed you will find the breadwinner for netsuite in the salesforce app selector go ahead and click breadwinner for netsuite under apps as shown you should then be able to see that breadwinner has installed many tabs such as netsuite companies and more connecting to netsuite with breadwinner now installed, click the tab breadwinner for netsuite to access the setup page where you will perform the initial setup tasks clicking connect to netsuite button will show a set of key / secret fields that must be filled with values generated in netsuite our task now is to generate those values and enter them here prerequisite for using netsuite web services to use the different netsuite web services you need to ensure that their respective features are enabled in netsuite before you connect to netsuite from breadwinner enabling features is performed from the enable features tab go to setup > company > setup tasks > enable features go to the suitecloud subtab in the suitetalk (web services) section, check the soap web services feature in the suitetalk (web services) section, check the rest web services feature in the manage authentication section, check the token based authentication feature go to the analytics subtab check the suiteanalytics workbook creating required netsuite credentials breadwinner uses netsuite's token based authentication (tba) features to connect to their api the following netsuite credentials are needed to make that connection account id consumer key consumer secret token id token secret it is suggested when creating these values to keep them in a secure document when netsuite token keys and secrets are created, they will only be shown one time, and will have to be re generated should they be lost also be very careful with these keys as they truly are "keys to the kingdom" keep any documents safe from access and do not expose to prying eyes on screen in a screenshare below it is indicated with !!! when these secrets will be revealed onscreen during creation get the account id go to setup > company > company information on the company information page, you can see the account id value on the right column generating an integration record for the consumer key and consumer secret note some selections in this guide may not be available in netsuite do carefully ensure all available settings are correct, some may be harder to locate go to setup > integration > manage integrations > new enter "breadwinner" for the integration record the following values should be checked token based authentication (tba) user credentials the following values should be unchecked (these fields might not be visible, which is ok) tba issuetoken authentication ( ) tba authorization flow authorization code grant leave the state set to the default value click save \<!!! sensitive data will be shown when clicked> copy the consumer key and consumer secret, which will appear only once if you navigate away from the page you will have to recreate the key and secret generating an access token note some selections in this guide may not be available in netsuite do carefully ensure all available settings are correct, some may be harder to locate on the netsuite home page (indicated with a home icon), in the lower left corner, there is a section called "settings" towards the bottom of that, click "manage access tokens" click "new my access token" on the access token page select "breadwinner" (created in the integration record steps above) click save \<!!! sensitive data will be shown when clicked> copy the token id and token secret, which will appear only once if you navigate away from the page you will have to recreate another access token entering the generated values in salesforce now using the values created above, enter them in the breadwinner for netsuite application connection page then click connect you should now see that breadwinner indicates a successful connection troubleshooting if your connection fails, there might be several reasons your netsuite org has ip based restrictions that prevent the breadwinner servers from connecting please add the following ip address to your white list 54 146 35 211 one of the many checkboxes was checked or unchecked in netsuite in either case, please reach out to breadwinner support, and we will gladly provide in depth troubleshooting for you initial import of data as soon as the netsuite connection is made, breadwinner will begin importing data from netsuite this includes values that will be used during setup, such as subsidiaries which are used to define what transaction data is imported to salesforce regularly it may take a few minutes to retrieve this information from netsuite completely changing the authenticated user you might need to change the authenticated user the correct approach depends on whether you have the original consumer key and consumer secret if you do not have the original consumer key and consumer secret, then you will need to regenerate all four values over again we recommend you start by deleting the existing integration record "breadwinner" navigate to the section above creating required netsuite credentials and follow those steps (deleting the old integration record in the process) if you do have the existing consumer key and consumer secret saved from when you created it, then you will only need to generate two values, the token id and token secret navigate to the section above, generating an access token , and follow that to regenerate the token id and token secret once you have those four values (and the netsuite account id, similar in nature to the salesforce org id), navigate to the breadwinner for netsuite tab in salesforce and click reconnect enter the netsuite account id and the four security credential values, and click save you have now established a new connection to netsuite