NetSuite SuiteTalk SOAP to REST Migration Checklist
Many NetSuite integrations still use SuiteTalk SOAP. Moving to REST is mostly a mapping and testing exercise, but gaps in record coverage and search behavior can surprise teams. This checklist gives you the order of work.
0 of 34 items complete
11 critical items still open - these are the highest-risk gaps.
1. Inventory
2. Capability mapping
3. Authentication and roles
4. Build and behavior
5. Testing and cutover
Treat every critical item as a gate. Do not cut over while a critical item is open. Verify details against current Oracle documentation, since REST coverage and support timelines change between releases.
Integration migration review
Optional review of your SOAP inventory and REST migration plan.
Optional. The tool and every export work without this. No spam.
How to use the checklist
Work through the five groups in order and mark items as you finish them. Critical items are the ones that cause outages or data problems if skipped, such as missing a vendor-owned integration or cutting over without a rollback path. Export the completed list as evidence for change management, and attach it to the release ticket.
What changes between SOAP and REST
SOAP uses typed XML requests against one endpoint, while REST uses JSON, resource URLs and HTTP verbs. Searches become filters or SuiteQL queries, paging is done with limit and offset, and upserts rely on external ID addressing. Not every record type or operation is exposed in REST, so coverage must be checked per integration against the REST API Browser and metadata catalog before any rewrite begins.
- XML to JSON payloads
- Search calls to REST filters or SuiteQL
- Typed operations to HTTP verbs
- Gaps filled with RESTlets where needed
Risk areas
The biggest risks are searches that depend on saved search features, sublist-heavy transactions whose payloads change shape, concurrency throttling when many calls run in parallel and implicit behavior, such as default values or sourcing, that differs between APIs. Compare outputs record by record in sandbox and sample production data before cutover rather than trusting a few happy-path calls.
Common mistakes
Teams underestimate vendor connectors, skip the inventory and discover forgotten scripts later, migrate without idempotency and create duplicates on retry, and cut over without a way back. Allow time for parallel running, and assign an owner for each integration so nothing is orphaned.
Frequently Asked Questions
Is SuiteTalk SOAP being retired?
Oracle has published a deprecation and support timeline for SOAP web services in its release notes. Check the current notes for your account, since dates and details can change, and plan the migration before the final support date.
Does REST cover everything SOAP does?
Not entirely. Some record types and operations are not available in REST, and saved search behavior differs. Check each integration against the REST API Browser and use SuiteQL or a RESTlet to fill gaps.
How should I handle retries safely?
Address records by external ID so a repeated call updates rather than creates, and back off on 429 or transient errors. Log request and response bodies for failed calls so you can reconcile.
Should I migrate everything at once?
Usually no. Migrate integration by integration, starting with low-risk ones, run old and new in parallel and keep the SOAP path for rollback until each is verified.
Netray builds custom NetSuite integrations and can review your migration plan, with read-only checks and human approval on any write-back.
Related Tools
NetSuite REST Record API URL Builder
Generate correct REST web services URLs and sample calls for a NetSuite record, a record list, a SuiteQL query or the metadata catalog.
NetSuiteNetSuite Token-Based Authentication Setup Checklist
Every step to configure token-based authentication for NetSuite REST, SOAP or RESTlet calls, from features and roles to tokens and test calls.
NetSuiteSuiteQL Query Generator
Fill in a table, columns, filter and sort and get a SuiteQL statement ready for the N/query module, the REST SuiteQL endpoint or the SuiteAnalytics Workbook.
NetSuiteNetSuite Internal ID Lookup Worksheet
An editable table to record internal IDs, script IDs and external IDs per environment, so scripts and integrations stop hardcoding guesses.
More NetSuite tools
See all- NetSuite Saved Search Formula Generator
- NetSuite CSV Import Template Guide
- NetSuite Role Permission Matrix Worksheet
- NetSuite Inventory Costing Method Reference
- NetSuite Month End Close Checklist
- NetSuite License Cost Estimator
- NetSuite User Access Request Form Template
- NetSuite Custom Record Design Spec Template
- NetSuite SuiteScript Deployment Handover Template
New to NetSuite? Start with the NetSuite guide and toolkit, or plan with NetSuite Cost Calculator, Training Path Builder, ERP Certification Study Planner.
Keep exploring
Free tools
- NetSuite Token-Based Authentication Setup ChecklistEvery step to configure token-based authentication for NetSuite REST, SOAP or RESTlet calls, from features and roles to tokens and test calls.
- NetSuite REST Record API URL BuilderGenerate correct REST web services URLs and sample calls for a NetSuite record, a record list, a SuiteQL query or the metadata catalog.
- NetSuite Manufacturing Go-Live ChecklistA 30 item checklist covering data, setup, costing, inventory, roles and cutover before you run production in NetSuite.
ERP fixes and how-tos
- Oracle ERP API Documentation: Where It Is and How to StartWhere the Oracle ERP API documentation lives: Fusion Cloud REST and SOAP, FBDI, BI reports, NetSuite SuiteTalk, plus auth methods and an example call.
- Working with NetSuite's SuiteTalk REST Web Services APICall NetSuite's SuiteTalk REST record and SuiteQL endpoints correctly: base URLs, pagination with limit/offset/hasMore, expandSubResources, the Prefer: transient header, and common 404 and permission errors.
- How to write and run SuiteQL queries in NetSuiteRun SuiteQL from Analytics > SuiteQL Query Tool or via N/query in SuiteScript. Syntax basics, joins, pagination and real examples for NetSuite reporting.
Runs with your ERP
- NetSuite Manufacturing Scheduler SuiteApp: replacing the Task SchedulerThe NetSuite Manufacturing Scheduler SuiteApp replaces the legacy Manufacturing Task Scheduler. What it does, how to move over, pitfalls and where AI helps.
- TrueCommerce EDI and Oracle NetSuite: SuiteApp integration for trading partnersHow TrueCommerce EDI works with NetSuite as a SuiteApp using SuiteTalk: order-to-cash, procure-to-pay and 3PL flows, setup steps, pitfalls and alternatives.
AI on your ERP
- AI agents for NetSuite manufacturing operationsAI agents for NetSuite manufacturing: WIP tracking, routing exceptions, and work order status grounded in SuiteQL, with human approval on anything that writes back.
- NetSuite Inventory and Demand Planning With AI That Checks Your Reorder LogicAI for NetSuite inventory and demand planning: review reorder points, safety stock, item demand plans and stockouts using SuiteQL on private infrastructure.
Integrations
- How to build a mobile app for Oracle NetSuiteBuild or choose a mobile app for Oracle NetSuite: barcode scanning, receiving, inventory moves and labor reporting over RESTlets and SuiteTalk REST, with offline limits.
- How to add AI agents to Oracle NetSuiteHow to add AI agents to Oracle NetSuite: SuiteQL and REST tool layer, RESTlet writes, role-scoped tokens, human approval, and where a private model fits.