SignalEDI Documentation

Everything you need to integrate, configure, and get value from SignalEDI. For a copy-paste first upload, start with the Developer QuickStart. Use the navigation on the left to jump to any section.

1. Getting Started

Account Setup

Creating a SignalEDI account takes under two minutes. No demo call required, no sales process — just sign up and start.

1. Navigate to signaledi.com/register and enter your work email and a strong password.
2. Check your inbox for a verification email from no-reply@signaledi.com and click the confirmation link.
3. Choose a subscription plan (Starter · Professional · Enterprise) and complete checkout via Stripe. No setup fees.
4. You will land on the onboarding wizard — add your company name, ISA Sender ID, and first trading partner.

First Login

After verification, log in at signaledi.com/login. If you enabled MFA during setup you will be prompted for your TOTP code after entering your password.

Accounts with status PENDING_PAYMENT or PENDING_VERIFICATION are redirected to the /access page until activation is complete.

Dashboard Overview

The dashboard is your real-time command center. Key areas:

2. EDI Basics

What is EDI?

Electronic Data Interchange (EDI) is the computer-to-computer exchange of business documents in a standard electronic format. Instead of emailing a PDF purchase order or faxing an invoice, EDI encodes those documents in a structured text format that both sender and receiver systems can parse automatically.

EDI eliminates manual data entry, reduces errors, and is required by most large retailers (Walmart, Target, Amazon), healthcare payers (Medicare, Blue Cross), and 3PLs. If a trading partner tells you "we only accept EDI," SignalEDI is what you use to become EDI-capable.

X12 Format

ANSI X12 is the dominant EDI standard in North America. An X12 document is a flat text file with segments separated by a tilde (~) and elements within each segment separated by an asterisk (*).

ISA*00*          *00*          *ZZ*SENDERID       *ZZ*RECEIVERID     *260101*1200*U*00401*000000001*0*P*>~
GS*PO*SENDERID*RECEIVERID*20260101*1200*1*X*004010~
ST*850*0001~
BEG*00*SA*PO-2024-001**20260101~
REF*DP*DEPT-47~
N1*ST*WALMART STORE #4872*91*0001234567~
PO1*1*100*EA*24.99**BP*ITEM-001*VN*VENDOR-SKU-A~
CTT*1~
SE*8*0001~
GE*1*1~
IEA*1*000000001~

Each line is a segment. The first element (before the first *) is the segment identifier (e.g. ISA, BEG, PO1). The number after the segment ID is the element position within that segment.

Common Transaction Sets

ISA / GS Segments Explained

Every X12 interchange starts with an ISA (Interchange Control Header) segment and ends with IEA. Within each interchange, one or more GS functional groups wrap the actual transaction sets.

3. Processing Files

How to Upload EDI Files

Navigate to Files → Upload in the dashboard. You can:

• Drag and drop one or more EDI files onto the drop zone.
• Click the drop zone to open a file browser.
• Use the POST /api/files/upload endpoint for programmatic uploads.

Maximum file size: 50 MB per file. Maximum batch: 25 files at once.

Validation & Processing

After upload, SignalEDI runs a multi-step pipeline:

1. Syntax check — verifies ISA/GS envelope structure, segment terminators, and element delimiters.
2. Transaction set validation — checks mandatory segments, element formats, and code values against the X12 specification for the identified transaction set.
3. Partner matching — matches the ISA06/ISA08 IDs to a configured trading partner in your account.
4. Output routing — delivers the processed data per the output mode configured for that partner (EDI passthrough or JSON API).
5. 997 acknowledgment — automatically generates a 997 FA back to the sender if configured.

Supported Formats

Output Modes (EDI vs API)

Per trading partner, you choose how processed data is delivered:

4. Trading Partners

Adding a Trading Partner

Go to Partners → Add Partner. You will need:

• Partner name and contact email.
• Their ISA Sender ID (ISA06) and your ISA Receiver ID (ISA08) for this partner.
• Connection type (SFTP, AS2, or API webhook).
• Transaction sets this partner sends/receives.
• Preferred output mode (EDI or API JSON).

ISA IDs (Interchange Sender/Receiver IDs)

ISA IDs are 15-character alphanumeric identifiers that tell the EDI network who sent a document and who should receive it. Each trading partner relationship uses a unique pair: your sender ID and the partner's receiver ID.

You can find your ISA IDs in Settings → EDI Configuration. If you don't have ISA IDs, SignalEDI will provision them for you during onboarding.

Connection Types

Onboarding Timeline

SignalEDI account setup and technical configuration is same-day. However, getting certified with a major trading partner takes longer because their internal processes control the timeline — not SignalEDI.

5. Billing & Plans

Plan Comparison

Add-ons

Upgrading Your Plan

Go to Dashboard → Billing → Change Plan. Upgrades take effect immediately and are prorated. Downgrades take effect at the end of the current billing cycle.

Billing Portal

Click Manage Billing in the dashboard to open the Stripe Customer Portal, where you can update your payment method, view invoices, and cancel your subscription.

6. API Reference

Authentication

All API requests require a Bearer token. Generate an API key from Settings → API Keys.

GET /api/transactions
Authorization: Bearer sk_live_YOUR_API_KEY
Content-Type: application/json

REST Endpoints

Example: list recent failed transactions:

curl -X GET "https://signaledi.com/api/transactions?status=FAILED&limit=50" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json"

Code Samples

Complete request examples in multiple languages. Click the tabs to switch between cURL, Node.js, Python, and PHP.

curl -X GET "https://signaledi.com/api/transactions" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X POST "https://signaledi.com/api/files/upload" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -F "file=@invoice-850.edi"

curl -X GET "https://signaledi.com/api/transactions/txn_abc123" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

# SignalEDI signs webhooks with X-SignalEDI-Signature header
# Verify with:
echo -n '$BODY' | openssl dgst -sha256 -hmac "whsec_YOUR_SECRET"

Rate Limits

Rate limit headers are returned on all responses: X-RateLimit-Remaining and X-RateLimit-Reset (Unix timestamp).

Webhook Setup

Configure a webhook URL in Settings → Webhooks to receive real-time notifications when transactions complete or fail.

SignalEDI sends a POST request to your URL with the following JSON payload:

{
  "event": "transaction.completed",
  "timestamp": "2026-01-01T12:00:00Z",
  "data": {
    "id": "txn_abc123",
    "transactionSet": "850",
    "direction": "INBOUND",
    "status": "COMPLETED",
    "tradingPartner": "Walmart",
    "outputMode": "API",
    "payload": { ... }
  }
}

Webhook events: transaction.completed, transaction.failed, file.processed, partner.connected.

Verify webhook authenticity by checking the X-SignalEDI-Signature header (HMAC-SHA256 of the raw body using your webhook secret).

7. FAQ