X12-types

This library provides bindings for the ASC X12 standard.

Supported Bindings

• 003030
  • 998 - Set Cancellation
• 004010
  • 204 - Motor Carrier Load Tender
  • 214 - Transportation Carrier Shipment Status Message
  • 309 - U.S. Customs Manifest
  • 310 - Freight Receipt and Invoice (Ocean)
  • 315 - Status Details (Ocean)
  • 322 - Terminal Operations and Intermodal Ramp Activity
  • 404 - Rail Carrier Shipment Information
  • 810 - Invoice
  • 997 - Functional Acknowledgment
  • 998 - Set Cancellation
• 005010
  • 148 - Report of Injury, Illness or Incident
  • 163 - Transportation Appointment Schedule Information
  • 180 - Return Merchandise Authorization and Notification
  • 204 - Motor Carrier Load Tender
  • 210 - Motor Carrier Freight Details and Invoice
  • 211 - Motor Carrier Bill of Lading
  • 212 - Motor Carrier Delivery Trailer Manifest
  • 216 - Motor Carrier Shipment Pickup Notification
  • 217 - Motor Carrier Loading and Route Guide
  • 214 - Transportation Carrier Shipment Status Message
  • 270 - Eligibility, Coverage or Benefit Inquiry
  • 271 - Eligibility, Coverage or Benefit Information
  • 274 - Healthcare Provider Information
  • 275 - Patient Information
  • 276 - Health Care Claim Status Request
  • 277 - Health Care Claim Status Notification
  • 278 - Health Care Services Review Information
  • 300 - Reservation (Booking Request) (Ocean)
  • 301 - Confirmation (Ocean)
  • 303 - Booking Cancellation (Ocean)
  • 304 - Shipping Instructions
  • 309 - Customs Manifest
  • 310 - Freight Receipt and Invoice (Ocean)
  • 315 - Status Details (Ocean)
  • 350 - Customs Status Information
  • 353 - Customs Events Advisory Details
  • 404 - Rail Carrier Shipment Information
  • 417 - Rail Carrier Waybill Interchange
  • 425 - Rail Waybill Request
  • 753 - Request for Routing Instructions
  • 754 - Routing Instructions
  • 810 - Invoice
  • 811 - Consolidated Service Invoice/Statement
  • 812 - Credit/Debit Adjustment
  • 816 - Organizational Relationships
  • 820 - Payment Order/Remittance Advice
  • 821 - Financial Information Reporting
  • 822 - Account Analysis
  • 823 - Lockbox
  • 824 - Application Advice
  • 830 - Planning Schedule with Release Capability
  • 832 - Price/Sales Catalog
  • 834 - Benefit Enrollment and Maintenance (005010X220A1)
  • 835 - Health Care Claim Payment/Advice
  • 837 - Health Care Claim (covers 837P/I/D — Professional, Institutional, Dental)
  • 840 - Request for Quotation
  • 843 - Response to Request for Quotation
  • 845 - Price Authorization Acknowledgment/Status
  • 846 - Inventory Inquiry/Advice
  • 850 - Purchase Order
  • 852 - Product Activity Data
  • 855 - Purchase Order Acknowledgment
  • 856 - Ship Notice/Manifest
  • 857 - Shipment and Billing Notice
  • 860 - Purchase Order Change Request - Buyer Initiated
  • 861 - Receiving Advice/Acceptance Certificate
  • 862 - Shipping Schedule
  • 864 - Text Message
  • 865 - Purchase Order Change Acknowledgment - Seller Initiated
  • 866 - Production Sequence
  • 867 - Product Transfer and Resale Report
  • 869 - Order Status Inquiry
  • 870 - Order Status Report
  • 875 - Grocery Products Purchase Order
  • 880 - Grocery Products Invoice
  • 888 - Item Maintenance
  • 889 - Promotion Announcement
  • 940 - Warehouse Shipping Order
  • 943 - Warehouse Stock Transfer Shipment Advice
  • 944 - Warehouse Stock Transfer Receipt Advice
  • 945 - Warehouse Shipping Advice
  • 990 - Response to a Load Tender
  • 997 - Functional Acknowledgment
  • 999 - Implementation Acknowledgment
• 005030
  • 404 - Rail Carrier Shipment Information

Something missing? Please open an issue.

sample code

Rendering X12

use x12_types::util::X12Element;
use x12_types::v004010::*;

let x = Transmission {
    isa: ISA {
        _01: element::I01::N00,
        _02: "          ".to_string(),
        _03: element::I03::N00,
        _04: "          ".to_string(),
        _05: element::I05::Zz,
        _06: "SOURCE         ".to_string(),
        _07: element::I05::Zz,
        _08: "TARGET         ".to_string(),
        _09: element::I08::from_x12("220524"),
        _10: element::I09::from_x12("1120"),
        _11: element::I10::U,
        _12: element::I11::N00401,
        _13: element::I12::from_x12("000000001"),
        _14: element::I13::N0,
        _15: element::I14::Production,
        _16: ">".to_string(),
    },
    functional_group: vec![FunctionalGroup {
        gs: GS {
            _01: "QO".to_string(),
            _02: "SOURCE".to_string(),
            _03: "TARGET".to_string(),
            _04: "20220524".to_string(),
            _05: "1600".to_string(),
            _06: "1".to_string(),
            _07: "X".to_string(),
            _08: "004010".to_string(),
        },
        ...
        ge: GE {
            _01: "1".to_string(),
            _02: "1".to_string(),
        },
    }],
    iea: IEA {
        _01: element::I16::from_x12("1"),
        _02: element::I12::from_x12("000000001"),
    },
};
let serialized = format!("{x}");
// resulting string
//
// ISA*00*          *00*          *ZZ*SOURCE         *ZZ*TARGET         *220524*1120*U*00401*000000001*0*P*>~
// GS*QO*SOURCE*TARGET*20220524*1600*1*X*004010~
// ....
// GE*1*1~
// IEA*1*000000001~

Parsing X12

use x12_types::util::Parser;
use x12_types::v005010::*;

let str = r#"ISA*01*0000000000*01*0000000000*ZZ*ABCDEFGHIJKLMNO*ZZ*123456789012345*101127*1719*U*00400*000003438*0*P*>~
GS*HP*ABCCOM*01017*20110315*1005*1*X*004010X091A1~
ST*835*07504123~
BPR*H*5.75*C*NON************20110315~
...
SE*93*07504123~
GE*1*1~
IEA*1*004075123~"#;
    let (rest, obj) = Transmission::<_835>::parse(str).unwrap();
    println!("{obj:?}");
// resulting string
//
// Transmission { isa: 
//  ISA { _01: N01, _02: "0000000000", _03: N01, _04: "0000000000", _05: Zz, _06: "ABCDEFGHIJKLMNO", _07: Zz, _08: "123456789012345", _09: I08 { raw: "101127" }, _10: I09 { raw: "1719" }, _11: U, _12: N00400, _13: I12 { raw: "000003438" }, _14: N0, _15: Production, _16: ">" }, 
//  functional_group: [
//    FunctionalGroup { 
//      gs: GS { _01: "HP", _02: "ABCCOM", _03: "01017", _04: "20110315", _05: "1005", _06: "1", _07: "X", _08: "004010X091A1" }, 
//      segments: [_835 { ...

More examples are located in the examples directory. Tests are embedded into each version directory.

Usage from the CLI

We are also maintaining a CLI-tool for a more accessible way to consume EDIs.

https://crates.io/crates/edi-cli

Contributions

Since the X12 is fairly huge, we only implement types on demand. So if you are missing some types, please open an issue or merge request.