netsuite-setup

Bootstrap and validate NetSuite TBA credentials and Orderful API key.

6|6|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Orderful/orderful-netsuite-skills --skill netsuite-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netsuite-setup
Source: https://github.com/Orderful/orderful-netsuite-skills/tree/main/skills/netsuite-setup
Command: npx skills add https://github.com/Orderful/orderful-netsuite-skills --skill netsuite-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill bootstraps and validates NetSuite Token-Based Authentication credentials and an Orderful API key for a specific customer, so you can reliably run later onboarding and troubleshooting actions.

Core Features & Use Cases

  • Creates per-customer credential files: Scaffolds ~/orderful-onboarding/<customer-slug>/.env from the repo template for sandbox (and production placeholders).
  • Guides required NetSuite setup: Walks the user to enable SuiteCloud features, create the NetSuite Integration record, and generate an Access Token with the correct permissions (including common gotchas).
  • Runs credential validation checks: Verifies NetSuite access (SuiteQL), the Orderful SuiteApp agent-write RESTlet reachability, and the Orderful API key by making authenticated requests.
  • Troubleshoots common failures: Provides targeted next steps for signature/realm mismatches, token-role permission issues, RESTlet deployment/version problems, and Orderful API key errors.

Quick Start

Ask the AI to run /netsuite-setup to create your customer’s credential .env, then confirm when validation passes.

Frequently Asked Questions about netsuite-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up NetSuite Token-Based Authentication for a new SuiteApp customer onboarding?

NetSuite Token-Based Authentication setup for a new SuiteApp customer involves creating an Integration record, generating an Access Token with correct role permissions, and scaffolding a per-customer `.env` file. This validates SuiteQL access and RESTlet deployment.

What is the best way to validate NetSuite credentials and an Orderful API key?

The best way to validate NetSuite credentials and an Orderful API key is to run authenticated requests against SuiteQL, probe the agent-write RESTlet deployment, and authenticate with api.orderful.com to ensure all environment configurations are correct.

Why does my NetSuite token-based authentication fail with a signature or realm mismatch?

NetSuite token-based authentication signature or realm mismatches typically occur due to incorrect Integration record setup or role permission issues. Troubleshooting involves verifying the Access Token permissions and confirming the RESTlet deployment version.

Do I need to enable specific SuiteCloud features before configuring NetSuite environment credentials?

Yes, configuring NetSuite environment credentials requires enabling specific SuiteCloud features before creating the Integration record. This ensures the environment supports generating the Access Token needed to validate SuiteQL and RESTlet reachability.

Can I scaffold separate environment configuration files for NetSuite sandbox and production?

Yes, you can scaffold separate environment configuration files for NetSuite sandbox and production. The setup process creates a per-customer `.env` file from a repo template, including sandbox configurations and production placeholders for secure credential management.

What steps are needed to troubleshoot NetSuite RESTlet deployment and permission issues?

Troubleshooting NetSuite RESTlet deployment and permission issues requires checking the agent-write RESTlet reachability, verifying the Access Token role permissions, and confirming the deployment version to resolve common signature or token-role failures.