reprocess-transaction

Reprocess a failed NetSuite inbound Orderful Transaction via the agent-write RESTlet.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reprocess a previously failed or stale inbound Orderful Transaction in a NetSuite customer account by triggering the SuiteApp’s inbound Map/Reduce for a single transaction record.

Core Features & Use Cases

  • Single-transaction retry: Re-enqueues only the specified NetSuite internal transaction ID (not the Orderful UUID) for inbound processing.
  • Status guardrails: Refuses reprocessing for statuses that would be no-ops or harmful (and warns for redundant cases).
  • Asynchronous completion: Returns immediately after queueing the Map/Reduce run, guiding you to verify progress in NetSuite.

Quick Start

Run: node <path-to-this-skill>/reprocess-transaction.mjs ~/orderful-onboarding/<customer-slug> <transaction-id>.

Frequently Asked Questions about reprocess-transaction

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

FAQPage Schema
How do I retry a failed NetSuite inbound transaction through a RESTlet?

To retry a failed NetSuite inbound transaction, you can reprocess the specific internal transaction ID by dispatching the inbound Map/Reduce through the SuiteApp agent-write RESTlet. The process validates your environment and signs the POST request with TBA OAuth headers.

What statuses prevent reprocessing a stale NetSuite transaction?

Reprocessing a stale NetSuite transaction is refused for statuses where retrying would be a no-op or harmful, and it warns you for redundant cases. A SuiteQL status check validates the current state before queueing the Map/Reduce run.

Can I reprocess multiple NetSuite transactions at once using Map/Reduce?

No, this reprocessing mechanism targets single-transaction retries. It re-enqueues only the specified NetSuite internal transaction ID for inbound processing, rather than operating on multiple records or the Orderful UUID simultaneously.

How do I authenticate a NetSuite RESTlet request using OAuth 1.0a?

To authenticate a NetSuite RESTlet request, the reprocess transaction flow signs the POST payload with TBA OAuth 1.0a headers. This requires local access to the customer's onboarding .env file to populate the necessary credentials.

Why does my NetSuite inbound transaction reprocess immediately return without completing?

The reprocess transaction operation returns immediately because it asynchronously queues the Map/Reduce run. Completion happens in the background, meaning you must verify the transaction progress directly within your NetSuite account.