This guide explains how to integrate Mavenoid with Oracle® NetSuite using the SuiteTalk REST Web Services API to retrieve and display customer order information with Token-based Authentification.

Requirements

• Admin Access To Mavenoid: If you do not have admin permissions, please reach out to your Mavenoid representative.

• OAuth Credentials: Follow the guidance on OAuth-based authentication for setup.

Configure the Integration

Use the Custom JavaScript action to configure the integration.

1. Set Up Authentication:
   Obtain the Company ID, Consumer Key, Consumer Secret, Token Key, and Token Secret by configuring an integration application in NetSuite. Refer to NetSuite's Token-based Authentication (TBA) for instructions. Be sure to follow the The Three-Step TBA Authorization Flow to authenticate your API requests to the SuiteTalk REST Web Services API.

2. Retrieve Order Information:
   Utilize the SuiteTalk REST Web Services API to query customer orders. Here’s an example request:

POST /services/rest/query/v1/suiteql
Host: your_company_id.suitetalk.api.netsuite.com
Prefer: transient
Content-Type: application/json
Authorization: OAuth realm="{your_company_id}",
                oauth_consumer_key="{your_consumer_key}",
                oauth_token="${your_token_key}",
                oauth_signature_method="HMAC-SHA256",
                oauth_timestamp="${timestamp}",
                oauth_nonce="${your_oauth_nonce}",
                oauth_version="1.0",
                oauth_signature="{your_oauth_signature}"
{
  "q": "SELECT
    status,
    linkedtrackingnumbers
FROM
    transaction
WHERE
    recordtype = 'salesorder'
    AND email = '{customer-email}'
    AND tranid = '{order-number}'"
}