
NetSuite EDI Integration- A Complete Setup Guide
On November 17, 2021 by Dhanushya Sree RameshIntroduction
Oracle NetSuite ERP is claimed to be one of the world’s most renowned Cloud-based ERPs for fast-growing businesses. It is a unified business management suite that offers support with the following services like financials, accounting, CRM & eCommerce. NetSuite ERP stands out from its competitors as its built-in functionality allows it to support multiple applications under one platform, including NetSuite EDI Integrations, thus reducing costs and enhancing productivity. The major differentiator lies in the easily customizable dashboards.
NetSuite EDI Integration Options
NetSuite EDI integrations are customizable according to your partners (Retail, 3PL, Transportation, etc). But, it doesn’t have an in-built EDI capability. Usually, NetSuite EDI Integrations are carried out by using an external EDI Platform or EDI Service. NetSuite lets you integrate with EDI Platform through,
- SOAP(Simple Object Access Protocol)
- REST-based APIs.
The most preferred method of integration is REST APIs as modern-day developers are habituated to using this.
NetSuite REST API overview
NetSuite follows a particular design pattern to request or make an API call. Here are some of the important design features of NetSuite’s REST-based API:
- It’s a CRUD-based API that has API endpoints to Create, Read, Update, and Delete:
REST APIs use Uniform Resource Identifiers (URIs) to address resources. This is a typical API URI to fetch a sales order numbered 8689
- It uses HATEOAS (Hypermedia as the Engine of Application State) which distinguishes it from other network application architectures. With HATEOAS, you can interact with other network applications to fetch information dynamically through hypermedia.
Let’s say you’re fetching sales order data that in turn has sub-records like billing information, customer information, etc. Instead of giving the data in an expanded form, the API provides the URIs. You can use this URI to make another API call to fetch the billing information of the sales order.
NetSuite REST API Beta Features:
NetSuite also has some other APIs in the BETA Phase. Of which there is one inteRESTing feature called the transform API. It lets you convert one record type into another.
For example, you can convert a sales order into an invoice. The only downside here is that they can scrap these BETA features without notifying you. So it makes sense to speak to your NetSuite support contact about their plans.
The other APIs in the BETA Program include:
- Transfer Order
- Return Authorization
- Assemble Item
- Vendor
- Credit Memo
- Inventory Count
- Partner
NetSuite Tracking Events
Traditionally there are a couple of ways to track events that happen inside NetSuite ERP or any Cloud-based ERP for that matter:
- Webhooks:
A webhook is a way of invoking an API callback URI for a given event. For example, you can invoke a webhook when a new Purchase order is created inside your ERP system. So when a change happens inside your system you can notify/track the changes to the API URI defined in your webhook setting. The bad news is, the webhook feature is not available in NetSuite yet.
- Polling:
Polling your NetSuite environment periodically may not be elegant but it works in some cases. It could be once every minute or every 30 minutes depending on your process and convenience.
- Suite Script:
This is the closest alternative to webhook. NetSuite has something called SuiteScripts. They are user event scripts that are executed on the NetSuite server. You can execute custom scripts on events such as create, load, update, copy, delete or submit. It is based on javascript with additional modules and features. So if you are familiar with Javascript, you should be able to handle it.
It supports most of the standard and custom records with exceptions in storing personal identification like a driver’s license or passport and other govt. Issued IDs.
How to set up the NetSuite REST API?
There are three high-level steps to follow to set up the NetSuite REST API.
- Create a role for REST API
Create a role where you can define the permissions, and RESTrictions with different levels (View, edit, full, etc) for permissions. These permissions are applied to Transactions, (Bill, invoice, SO, PO, etc.) reports lists, setup, and custom records.
- Create Custom Integration manager:
The second step is to create an Integration manager. While creating a custom integration manager, you can decide whether you want to use a Token-based authentication system or an OAuth 2.0-based authentication system.
- Create access tokens with the integration manager and role:
Finally, using the Role and the Integration manager you created in steps 1 and 2, creating the access token will give you a token ID and a token secret. You will be using the token ID and the secret to make API calls.
How can Zenbridge help?
Zenbridge is a cloud platform to send and receives EDI data using API. Zenbridge is different from traditional EDI systems as it gives you freedom from dealing with EDIs. You can send your data as an API and we will convert it into EDI data and forward it to your partners. The advantage here is that you don’t have to invest or go through the steep learning curve of understanding EDI technology which is quite traditional and complex.
Zenbridge for NetSuite EDI Integration:
Steps for NetSuite EDI Integration are as follows:
Sending EDI-AS-API:
- Send the API request either by using polling for events inside NetSuite ERP or using a suite script to send in data as API to Zenbridge.
- Zenbridge receives an API call from NetSuite, we validate that data against your partner’s compliance requirements.
- The compliant data is converted to EDI and sent to your partner.
- If the data is non-compliant, you will be notified in real-time which reduces the chargebacks.
Receiving EDI-AS-API:
- The partner sends an EDI to your Zenbridge AS2 Mailbox
- Every time an EDI File is received, the EDI file is converted to JSON and fires an API request to your NetSuite environment

Zenbridge Features:
NetSuite and Zenbridge have APIs and facilitate effective and seamless communication between the two thus facilitating NetSuite EDI Integration. Here are some of the features of Zenbridge:
- Ready to connect with all major Retailers and supermarkets across the US. Zenbridge has all their EDI Specifications already configured as API Endpoints
- Real-time compliance validations as Zenbridge is an API-based system thus eliminating chargebacks
- The only platform to support API for all X12, EDIFACT documents across all versions.
- Unified worldwide partner support system such as X12 is used primarily in North America and the REST of the world and EDIFACT is used in Europe
- Customized dashboards for different stakeholders.
Who can use Zenbridge?
The Primary customers are:
- Retail brands:
Our platform is preloaded with API for EDI documents of all major US retailers. EDI integration with your retail partner is just an API call away.
- Transport and Logistics:
If your customers are expecting to be EDI Capability, you can use Zenbridge.
- ERP or custom Applications
Zenbridge has an extensive application that could be applied to multiple industries like supply chain, healthcare, etc.
Having chosen an ERP like NetSuite ERP that comes with API, is a great sign that you have set your company well for integration and automation in the future. APIs make it possible for organizations to be more automated, transparent, and proactive. With the Zenbridge platform, you can carry out EDI integrations without understanding EDI technology or setting up EDI infrastructure.
Leave a Reply