# X12 ISA/GS Envelope Skeleton Generator

> Source: https://netray.co/tools/x12-isa-gs-envelope-skeleton-generator
> Publisher: Netray (netray.co), AI and integration engineering for ERP and manufacturing systems.
> Section: Free Tools

## Short answer

Fill in sender, receiver, qualifiers and control numbers and get a matching envelope to test a translator or a partner connection.

## Category

developer

## Audience

- EDI coordinator
- EDI analyst
- ERP integration developer

## Tool

**Kind:** template

**Output:** code

**Language:** edi

**Fields:**

#### ISA05 sender qualifier

**Key:** sender_qual

**Type:** select

**Options:**

- 01
- 12
- 14
- ZZ

**Default:** ZZ

#### ISA06 sender ID (pad to 15 characters)

**Key:** sender_id

**Type:** text

**Default:** ACMEMFG        

**Help:** Exactly 15 characters, trailing spaces included.

#### ISA07 receiver qualifier

**Key:** receiver_qual

**Type:** select

**Options:**

- 01
- 12
- 14
- ZZ

**Default:** 01

#### ISA08 receiver ID (pad to 15 characters)

**Key:** receiver_id

**Type:** text

**Default:** 123456789      

**Help:** Exactly 15 characters, trailing spaces included.

#### ISA09 date (YYMMDD)

**Key:** isa_date

**Type:** text

**Default:** 261020

#### ISA10 time (HHMM)

**Key:** isa_time

**Type:** text

**Default:** 0915

#### ISA12 envelope version

**Key:** version

**Type:** select

**Options:**

- 00401
- 00501

**Default:** 00401

#### ISA13 interchange control number (9 digits)

**Key:** isa_ctrl

**Type:** text

**Default:** 000000101

#### ISA15 usage indicator

**Key:** usage

**Type:** select

**Options:**

- T
- P

**Default:** T

#### GS01 functional identifier

**Key:** gs_code

**Type:** select

**Options:**

- PO
- PR
- SH
- IN
- FA

**Default:** PO

#### GS02 application sender

**Key:** gs_sender

**Type:** text

**Default:** ACMEMFG

#### GS03 application receiver

**Key:** gs_receiver

**Type:** text

**Default:** BIGRETAIL

#### GS04 date (CCYYMMDD)

**Key:** gs_date

**Type:** text

**Default:** 20261020

#### GS06 group control number

**Key:** gs_ctrl

**Type:** text

**Default:** 101

#### GS08 version

**Key:** gs_version

**Type:** text

**Default:** 004010

#### ST01 transaction set

**Key:** st_code

**Type:** select

**Options:**

- 850
- 855
- 856
- 810
- 997

**Default:** 850

#### ST02 set control number

**Key:** st_ctrl

**Type:** text

**Default:** 0001

**Blocks:**

#### Envelope (one set, with a placeholder body)

**Body:** ISA*00*          *00*          *{{sender_qual}}*{{sender_id}}*{{receiver_qual}}*{{receiver_id}}*{{isa_date}}*{{isa_time}}*U*{{version}}*{{isa_ctrl}}*0*{{usage}}*>~
GS*{{gs_code}}*{{gs_sender}}*{{gs_receiver}}*{{gs_date}}*{{isa_time}}*{{gs_ctrl}}*X*{{gs_version}}~
ST*{{st_code}}*{{st_ctrl}}~
[replace this line with the body segments of the transaction set]
SE*[segment count including ST and SE]*{{st_ctrl}}~
GE*1*{{gs_ctrl}}~
IEA*1*{{isa_ctrl}}~

#### Check before sending

**Body:** ISA06 and ISA08 must be exactly 15 characters. ISA13 must equal IEA02. GS06 must equal GE02. ST02 must equal SE02. SE01 counts ST through SE inclusive. ISA11 is shown as U (standards identifier) for version 00401. For 00501 use the repetition separator character the partner specifies, usually ^.

**Notes:** This is a skeleton for testing translators and partner connections, not a production map. Replace the bracketed line with real segments. Confirm separators, qualifiers, usage indicator and version in the partner guide, and keep ISA15 at T until the partner approves production.

## Content

**Intro:** Setting up a new EDI partner usually starts with an empty envelope to test connectivity. This generator builds the ISA, GS, ST, SE, GE and IEA segments with matching control numbers so you can drop in the body of any transaction set.

**Sections:**

#### How to use it

**Body:** Enter the qualifiers and IDs exactly as the partner gave them, including padding to 15 characters. Set the transaction set and version, pick T for test, and copy the generated lines into your translator or test harness. Replace the placeholder with the body segments, then count the segments from ST through SE and fill in SE01.

**Bullets:**

- Use unique control numbers for each test file.
- Keep ISA15 at T until the partner confirms production.
- Match GS08 to the version in the partner guide.
- Save the generated file with a name that includes ISA13.

#### Why the envelope matters

**Body:** A gateway reads the ISA first. If the sender qualifier and ID do not match a configured trading partner, the file is dropped before any mapping runs, and you may never get a 997. That is why many connection problems that look like mapping errors are envelope problems, and why this part is worth testing before the first real document.

#### Common mistakes

**Body:** Trimming trailing spaces in a text editor changes the ISA length, so edit with a tool that does not strip whitespace. Copying a production ISA13 into a test file also causes duplicate checks to fire. Another mistake is using the same GS06 across groups in one interchange. Counters should increase automatically in the translator.

**Cta:** If you maintain many trading partner profiles, Netray can help build a partner profile register that generates correct envelopes from one source.

**Faq:**

#### Do I need a GS segment?

**Answer:** Yes for X12. Each interchange contains at least one functional group, and each group has a GS and a GE. The group carries the functional identifier and the version used for the sets.

#### What does U in ISA11 mean?

**Answer:** In version 00401 and earlier ISA11 holds the interchange control standards identifier, with U meaning U.S. EDI Community of ASC X12. From 00402 it is the repetition separator, commonly ^.

#### How do I count SE01?

**Answer:** Count every segment from ST to SE inclusive. For ST, BAK, N1, PO1, ACK, CTT and SE the count is 7.

#### Can I use this for production?

**Answer:** The output is a starting skeleton. In production the envelope is built by your translator with managed counters. Use this for testing and for comparing against what your translator produces.

## Search terms

x12 envelope generator, ISA segment generator, x12 ISA GS template, edi test file envelope, ISA IEA control number match, x12 skeleton file, edi envelope example, generate x12 ISA

---
Talk to an engineer: https://netray.co/contact?intent=erp_ai | Machine catalog: https://netray.co/agent/catalog.json