← Back to Skills Marketplace
npfaerber

Edi Parser

by npfaerber · GitHub ↗ · v1.0.1
cross-platform ✓ Security Clean
346
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install edi-parser
Description
Parse EDI X12 files (810 Invoice, 850 Purchase Order, 856 ASN). Extract structured data from ISA/GS envelopes, transaction sets, and segments. Use when worki...
README (SKILL.md)

EDI X12 Parser

Parse and extract structured data from EDI X12 transaction sets.

Supported Transaction Sets

  • 810 -- Invoice
  • 850 -- Purchase Order
  • 856 -- Advance Ship Notice (ASN)

Parsing Approach

EDI files use ~ as segment terminator, * as element separator, and > or : as sub-element separator (check ISA-16).

Envelope Structure

ISA*QQ*SenderID*RR*ReceiverID*Date*Time*:*Version*Control#*AckReq*Mode*SubSep~
  GS*FuncCode*SenderCode*ReceiverCode*Date*Time*GroupControl*Standard*Version~
    ST*TransactionSet*Control#~
      ... segments ...
    SE*SegmentCount*Control#~
  GE*TransactionCount*GroupControl~
IEA*GroupCount*InterchangeControl~

Key ISA Fields (1-indexed)

  • ISA-05: Sender qualifier (12=UCS, ZZ=mutually defined, 08=UCC)
  • ISA-06: Sender ID (left-padded to 15 chars)
  • ISA-07: Receiver qualifier
  • ISA-08: Receiver ID

850 Purchase Order

Segment Key Fields
BEG BEG-03=PO Number, BEG-05=PO Date
DTM DTM-01=Qualifier (002=Delivery, 010=Requested Ship), DTM-02=Date
N1 N1-01=Entity (ST=Ship-To, BY=Buyer, SF=Ship-From), N1-02=Name
PO1 PO1-02=Qty, PO1-04=Unit Price, PO1-07=UPC/SKU
PID PID-05=Description

810 Invoice

Segment Key Fields
BIG BIG-01=Invoice Date, BIG-02=Invoice#, BIG-04=PO#
REF REF-01=Qualifier (IA=Vendor#, BM=BOL#), REF-02=Value
N1 N1-01=Entity (ST=Ship-To, RE=Remit-To)
IT1 IT1-02=Qty, IT1-04=Unit Price, IT1-07=UPC
TDS TDS-01=Total invoice amount (cents, divide by 100)

856 ASN

Segment Key Fields
BSN BSN-02=Shipment ID, BSN-03=Date
HL HL-03=Level (S=Shipment, O=Order, P=Pack, I=Item)
REF REF-01=Qualifier (BM=BOL, IA=Vendor#, LO=Load#, AO=Appointment)
PRF PRF-01=PO Number
MAN MAN-02=SSCC-18 barcode
LIN LIN-03=UPC
SN1 SN1-02=Qty Shipped, SN1-03=UOM

Walmart-Specific Notes

  • Walmart ISA receiver: qualifier 08, ID 925485US00
  • REF*IA = Walmart vendor number (required on 856)
  • REF*LO = Load number (new requirement)
  • N1*ST with UL qualifier = GLN for ship-to location
  • MAN*GM = SSCC-18 (required per pallet on 856)

Output Format

When parsing, output a clean table:

| Field | Value |
|-------|-------|
| Transaction | 856 ASN |
| ISA Sender | 12 / 1234567890 |
| ISA Receiver | 08 / 925485US00 |
| PO# | 0123456789 |
| Ship Date | 2026-02-16 |
| Items | 16 line items |

For bulk parsing, output CSV with one row per line item.

Usage Guidance
This skill is instruction-only and internally consistent. Before using it: (1) test with non-sensitive sample EDI files to confirm parsing behavior and delimiter handling (ISA-16 can change sub-element separators); (2) do not feed confidential production documents until you confirm where agent outputs go (ensure your agent/platform won't leak parsed data to external services); (3) prefer skills with a known source/homepage for production use—if a future version adds code files or install steps, re-evaluate for supply-chain risks; (4) if you need Walmart-specific processing, verify the REF/N1/MAN handling against your trading partner agreements.
Capability Analysis
Type: OpenClaw Skill Name: edi-parser Version: 1.0.1 The skill bundle contains metadata and a detailed `SKILL.md` document. The `SKILL.md` provides comprehensive instructions for parsing EDI X12 files, including structure, transaction sets, key fields, and output format. There are no instructions for data exfiltration, malicious execution, persistence, or prompt injection against the agent. All content is aligned with the stated purpose of an EDI parser and lacks any high-risk behaviors or suspicious commands.
Capability Assessment
✓ Purpose & Capability
The name/description (EDI X12 parser for 810/850/856) matches the SKILL.md content. The skill requests no binaries, env vars, or installs — which is proportionate for a parsing instruction-only skill.
✓ Instruction Scope
SKILL.md gives concrete parsing rules, envelope/segment mappings, Walmart-specific notes, and output formats. It does not instruct the agent to read unrelated system files, access credentials, or send data to external endpoints. It assumes the agent will be given or fed EDI text to parse, which is appropriate.
✓ Install Mechanism
No install spec and no code files are present. That minimizes the on-disk code/runtime footprint and aligns with an instructions-only parser.
✓ Credentials
No environment variables, credentials, or config paths are required. The declared requirements are minimal and proportional to the stated functionality.
✓ Persistence & Privilege
always is false and the skill does not request persistent system privileges or modify other skills. Autonomous invocation is allowed by default (disable-model-invocation=false) but this is the platform default and not by itself a red flag here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install edi-parser
  3. After installation, invoke the skill by name or use /edi-parser
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated the sample output table to use generic example values for ISA Sender, PO#, etc. - No changes to parsing logic or supported features.
v1.0.0
Initial release of edi-parser. - Parse EDI X12 files for 810 (Invoice), 850 (Purchase Order), and 856 (Advance Ship Notice) transaction sets. - Extracts structured data from ISA/GS envelopes, transaction sets, and segment fields. - Supports supplier compliance use cases (Walmart/retail). - Provides field-level output tables and CSV exports for line items. - Includes segment/field mapping and Walmart-specific parsing notes.
Metadata
Slug edi-parser
Version 1.0.1
License —
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Edi Parser?

Parse EDI X12 files (810 Invoice, 850 Purchase Order, 856 ASN). Extract structured data from ISA/GS envelopes, transaction sets, and segments. Use when worki... It is an AI Agent Skill for Claude Code / OpenClaw, with 346 downloads so far.

How do I install Edi Parser?

Run "/install edi-parser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Edi Parser free?

Yes, Edi Parser is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Edi Parser support?

Edi Parser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Edi Parser?

It is built and maintained by npfaerber (@npfaerber); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments