n8n-nodes-netsuite-markival/README.md

NetSuite integration node for n8n with SuiteQL, RESTlet, and Raw REST support

# n8n NetSuite Integration Node (Pre-Alpha)3. n8n installed (minimum version 1.0.0)

> ⚠️ **Important**: 
> - This node is in pre-alpha stage and is not recommended for production use
> - This node requires a valid license key to function
> - Contact support@markival.com to obtain your license key ⚠️ **Pre-Alpha Stage**: This node is in early development (pre-alpha) stage. Features may be incomplete, and breaking changes can occur without notice. Use in production environments at your own risk.

This is a custom n8n node that provides seamless integration with NetSuite's REST API, allowing you to perform various operations like executing SuiteQL queries, interacting with RESTlets, and making raw REST requests to NetSuite.

![NetSuite Node](./nodes/Netsuite/NetSuite.svg)

## Features

- **SuiteQL Queries**: Execute powerful SuiteQL queries directly against your NetSuite data
- **RESTlet Integration**: Make requests to custom NetSuite RESTlets
- **Raw REST Requests**: Perform raw REST API requests for maximum flexibility
- **OAuth 1.0 Authentication**: Secure authentication using NetSuite's OAuth 1.0 implementation
- **License Management**: Built-in license validation with caching for optimal performance

## Licensing

This node requires a valid license key to function. The licensing system includes:

- **Automated Validation**: Your license is automatically validated with each use
- **Caching**: License validations are cached for 8 hours to ensure optimal performance
- **Error Handling**: Clear error messages if license validation fails
- **Security**: Secure license validation through Markival's authentication servers

To obtain a license key:

1. Contact support@markival.com
2. Provide your NetSuite Account ID
3. Choose your subscription plan
4. Receive your license key via email

## Prerequisites

Before you can use this node, you'll need:

1. An active NetSuite account
2. A valid license key from Markival (contact support@markival.com to obtain one)
3. OAuth 1.0 credentials from NetSuite:
   - Consumer Key
   - Consumer Secret
   - Access Token
   - Token Secret
4. n8n installed (minimum version 1.0.0)

> ⚠️ **Important**: This node requires a valid license key to function. Contact support@markival.com to obtain your license key.

## Installation

This is a community node that requires n8n version >= 1.0.0. You can install it in following ways:

### 1. Via NPM

1. Open a terminal in your n8n root directory
2. Run the following command:
   \`\`\`bash
   npm install n8n-nodes-netsuite-mrk
   \`\`\`
3. Start n8n

### 2. Via Community Nodes Tab (Recommended)

1. Open your n8n instance
2. Go to **Settings > Community Nodes**
3. Select **Install**
4. Type \`n8n-nodes-netsuite-mrk\` in **Enter npm package name**
5. Agree to the risks of using community nodes
6. Click **Install**

### 3. Manual Installation

If you wish to install the node manually in your n8n instance:

1. Download the [latest release](https://github.com/Sarosh-Markival/markival-n8n-netsuite-node/releases) from GitHub
2. Extract the contents
3. Copy the \`n8n-nodes-netsuite-mrk\` folder into your custom nodes directory:
   - Linux/Mac: \`~/.n8n/custom\`
   - Windows: \`C:\Users\YOUR_USERNAME\.n8n\custom\`
4. Restart n8n

## Configuration

1. Open your n8n workflow
2. Add the "MRK NetSuite" node
3. Create new credentials of type "NetSuite OAuth1 API"
4. Enter your credentials:
   - Consumer Key
   - Consumer Secret
   - Access Token
   - Token Secret
   - Account ID (e.g., 30000-SB1)
   - Realm (e.g., 30000_SB1)
   - License Key (obtained from Markival)

## Usage

The node supports three main operations:

### 1. SuiteQL

Execute SuiteQL queries to fetch data from your NetSuite account. Write and execute any valid SuiteQL query to retrieve information from NetSuite records.

### 2. RESTlet

Interact with your custom NetSuite RESTlets:

- Specify the Script ID and Deploy ID
- Choose HTTP method (GET, POST, PUT, DELETE)
- Add request body for POST/PUT operations

### 3. Raw Request

Make direct REST API requests to NetSuite endpoints:

- Use common endpoints or specify custom ones
- Support for all HTTP methods
- Add custom headers and query parameters
- Include request body for POST/PUT/PATCH operations

For detailed SuiteQL syntax and examples, refer to the [NetSuite Help Center](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_157373386674.html).

## Troubleshooting

### Common Issues

1. **License Validation Failed**

   - Ensure your license key is valid and not expired
   - Check if your Account ID matches the licensed account
   - Contact support if the issue persists

2. **Authentication Errors**

   - Verify OAuth credentials are correct
   - Ensure Account ID and Realm are properly formatted
   - Check if token permissions include necessary roles

3. **API Request Issues**
   - Verify endpoint URLs and request formats
   - Check request parameters and body format
   - Ensure proper permissions in NetSuite

### Getting Help

If you encounter issues:

1. Review your n8n logs for detailed error messages
2. Contact support:
   - Email: support@markival.com
   - Include:
     - Error message
     - Node configuration (excluding sensitive data)
     - Steps to reproduce
     - n8n version

## Development Status

This node is currently in **pre-alpha** stage, which means:
- Features are still being developed and tested
- Breaking changes may occur between versions
- API and functionality might change significantly
- Not recommended for production use without thorough testing
- Limited documentation and examples

## Support

For pre-alpha support and feedback:
- GitHub Issues: [Report a bug](https://github.com/Sarosh-Markival/markival-n8n-netsuite-node/issues)
- Email: support@markival.com

## Author

Sarosh Aamir
[sarosh@markival.com]()

---

Made with ❤️ for n8n