About the ShipHawk SuiteCommerce Connector
| Note |
|---|
INTERNAL – Work In Progress |
The ShipHawk SuiteCommerce Connector allows your organization to use ShipHawk’s in-cart rating functionality with your SuiteCommerce website. By connecting your SuiteCommerce solution with the ShipHawk extension, your organization can ensure your customers are receiving the optimal shipping rate at the time of checkout.
...
To learn more about the features included with the SuiteCommerce ShipHawk Connector, refer to How the ShipHawk SuiteCommerce Connector Works.
Local Development Setup
Required Prerequisites
An Integrated Development Environment (IDE) is required. Visual Studio Code is recommended.
Ensure the latest version of Node.js is installed. If you have a higher version, downgrade to the required version.
“ShipHawk SCA Connector” Bundle Setup
Go to the TMS Netsuite Sca Connector repository, and clone it to your local machine.
...
From Visual Studio Code. Open a new terminal by navigating to Terminal > New Terminal
...
In your terminal, enter the following command:
| Code Block |
|---|
npm install -g @oracle/suitecloud-cli |
To check if SuiteCloud CLI was successfully installed, type in the command
suitecloud. A list of all commands you can run after SuiteCloud CLI is installed will populate in the terminal.Enter the following command to setup your account to use with SuiteCloud CLI:
| Code Block |
|---|
suitecloud account:setup |
Select browser-based authentication
Choose "Create a new authentication ID" if you don’t have one yet, or select an existing authID from the list below.
...
.
...
A new NetSuite browser window will populate and prompt you to log in to your account. Ensure you are logged into your account
...
Click Allow.
...
You have now established you are working with this NetSuite account from your IDE.
...
After making any changes, you need to deploy the modified files back to your NetSuite account.
...
Enter the following command in your terminal: suitecloud project:deploy
“ShipHawkSCExtension” Extension Setup
Log in to your NetSuite Dev account and install the ShipHawk SCA Connector bundle from the “ShipHawk Integration - 2017A V1.0” account by following the installation instructions.
Go to the Bundles list find the SuiteCommerce Extension Management bundle and remember the bundle ID.
...
Go to
Documents > File > File Cabinetin NetSuite.On the File Cabinet page, locate the SuiteBundles folder in the directory on the left side.
Inside the SuiteBundles folder, find the folder titled Bundle 521562 (specific to SuiteCommerce Extension Management).
Download the file named ExtensionDevelopmentTools-24.2.10.zip or the latest available version.
...
Locate the downloaded zip file in your Downloads folder.
...
Right-click on the zip file and select Extract All...
...
Move the unzipped folder to your work directory. You can rename it if you want.
...
Open ExtensionDevelopmentTools-24.2.10 via the IDE that you use.
The
...
Now you need to set up token-based authentication (TBA) for your site. To take advantage of this, complete the following steps:
Create an integration record.
In the Name field, enter a name for the integration record.
In the State field, select Enabled.
Check the Token-Based Authentication box.
Check the TBA: Authorization Flow box.
In the Callback URL field, enter: http://localhost:7777/tba.
Clear the Authorization Code Grant box.
Check the User Credentials box.
Save the integration. Be sure to copy the consumer key/secret before closing the page.
Paste the consumer key/secret in the .env file in your ExtensionDevelopmentTools-24.2.10 project.
...
Set up a development environment for your extension by running a series of commands in Visual Studio Code.
In Visual Studio Code, navigate to the Terminal tab. Select New Terminal.
In your terminal, enter the following command:
Code Block npm installAfter running the npm install command, you must ensure the gulp command is installed in your local directory. A list of available commands should populate in your terminal.
...
Enter the following command. This command extracts the related files (themes) from your SuiteCommerce Site
Code Block language bash gulp extension:fetch --toYou will be prompted to Choose a saved token. You should opt to use a new token by selecting the New Token option at the bottom of the Choose a saved token list and press Enter.
...
You will be prompted to enter a new authentication ID (auth ID). Enter any value that is clear and meaningful to you.
...
After you input an (authID) in your IDE code editor, you will be redirected to NetSuite. NetSuite will be prompted to allow the application to access your account.
| Info |
|---|
If you get any issue on this step try to remove the .env file and run the last command again. |
Click Allow
...
Navigate back to your terminal. You will then be prompted to select a website from the ‘Choose your website’ command. If there are multiple options, select the website you would like to add the extension to.
...
After you have made your selection, you will also be prompted to ‘Choose your domain’. Select the domain that corresponds with your SuiteCommerce site.
...
If there are multiple extensions, don’t select any of them just skip the step.
When you finish running the
extension:fetch --tocommand, a new directory will populate inside your existing directory titled Workspace.Copy the folder named ShipHawkSCExtension from the TMS Netsuite Sca Connector project located by path src/FileCabinet/SuiteScripts/ShipHawkSCExtension and Paste it to the Workspace directory.
Now you can add any changes to the ShipHawkSCExtension and deploy them to your account for testing.
Before you deploy the extension you need to change a version in the
manifest.jsonfile to the appropriate version of the current sprint. For instance, if the latest deployed version from the bundle is4.0.1and you work on a minor fix you need to update it to4.0.2To deploy the extension run the next command:
gulp extension:deploy --toYou will be prompted to ‘Choose a saved token’. You can use the token created in step (17) or create a new one.
Select the website and domain that correspond with your SuiteCommerce site.
...
Verify that the following information appears on the list below:
Vendor: (ShipHawk)
Name: ShipHawk
Fantasy Name: ShipHawk SCA Extension
Press Enter every time a new line appears.
...
Under ‘Selected supported products’, choose the SuiteCommerce Online option. This will upload the extension into your NetSuite account.
...
Clear the target version from the next lines using the backspace (or delete).
...
Your extension will begin uploading to your NetSuite account. After the upload is complete, your extension will be available for activation.
You can confirm the connector was deployed to your NetSuite Account by navigating to Commerce > Extensions > Extension Manager. Click Edit on the target website that you selected. Then, click the Extensions tab in the Active Themes & Extensions page in NetSuite. If deployed correctly, you should see your connector on this page.
...
After testing your changes on the dev account Copy/Paste them to the TMS Netsuite Sca Connector.
...
integration process is as follows:
| Table of Contents | ||
|---|---|---|
|
Installation Instructions
Prerequisites
Before beginning the installation process, you must meet the prerequisites listed below. If your NetSuite account has SuiteCommerce installed, these prerequisites will likely already have been fulfilled.
...
Congratulations, you have installed the ShipHawk SCA Connector!
Troubleshooting
...
If the ShipHawk SCA Connector is already installed on your account you might encounter the situation shown below. Then please select the Replace Existing Objects action while installing the bundle.
...
To activate the
...
extension
Though the ShipHawk SuiteCommerce Connector may be installed, it needs to be manually activated in NetSuite in order for it to display on your SuiteCommerce website.
...
Locate the ShipHawk SuiteCommerce Extension and select the Active Checkbox.
Click the Activate button, located at either the top or bottom of the list.
...
To deactivate the
...
extension
Navigate to the Extension Manager page. From your NetSuite menu bar, click Commerce > Extensions > Extension Manager.
Find your SuiteCommerce Domain and click Edit. This will take you to the Activate Themes and Extensions page.
...
NetSuite will utilize the native Shipping Functionality when your connector becomes deactivated.
Troubleshooting
...
If you opt to deactivate your SuiteCommerce Connector and it is still appearing on your SuiteCommerce site and Domain, you may need to clear your site’s cache in NetSuite for the change to take effect. This section will instruct you on how to do so:
...
You have cleared your cache for your domain. This will update your domain with the ‘deactivated’ extension status.
Additional Settings
The last step in the installation process is to configure some additional settings in NetSuite.
...
Receiving an “ERROR: Field not found” when installing the extension can be caused by adding the custom sales order fields incorrectly, or failing to add them altogether.
Click Save.
Ensuring Rates can be used at Checkout
...
Navigate to Lists > Accounting > Shipping Items.
From the list, locate all Shipping Rates you want returned at the time of checkout. Repeat this for each Shipping Item necessary.
Click Edit.
...
Click Save to update the record.
If there was a target version on this field, this should resolve the error and you should now see the ShipHawk SCExtension populated on the Extension Manager page.
Customizations in customer installations (internal only)
A list of customers who have their own customizations for our extension (provided by Katoomi):
...
.