148 Report of Injury, Illness or Incident (004020)
This is the standard X12 004020 spec, with 17 loops and 114 segment positions, as OpenEDI JSON, an ediFabric C# template and an ediFabric Native model. To change it for a trading partner, customize it in the EDI Spec Builder.
Use the 148 spec in your code
ediFabric .NET
Add the C# template and its common files to your project, or reference the template NuGet package, and read 148 files into TS148 objects. See ediFabric .NET.
ediFabric Native
Map version 004020 to the Native model with set_map, then parse 148 files to JSON from Python, Java, C or C#. See Convert between EDI and JSON.
OpenEDI
Select Customize in Spec Builder to copy the spec under your own name, change it for your partner, and parse files against it in EdiNation, ediFabric Native or ediFabric Cloud. Read about OpenEDI.
Generate 148 classes in Python, Java, Node.js, Go, Rust or C
ediFabric Native returns each 148 as JSON, with the property names of the OpenEDI schema. To work with that JSON as typed objects, generate classes from the OpenEDI file in your language and deserialize the JSON into TS148. Serialize the objects back to JSON to build EDI with ediFabric Native. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats, so validate files with ediFabric Native. Read more in Generate a class from OpenEDI.
Python: datamodel-code-generator. Node.js: openapi-typescript. Java, Go, Rust and C: OpenAPI Generator.
148 structure
Loops and segments of the standard 148, with their usage and maximum repeats.
| ID | Name | Usage | Max use |
|---|---|---|---|
| ST | Transaction Set Header | Optional | 1 |
| BHT | Beginning of Hierarchical Transaction | Mandatory | 1 |
| CUR | Currency | Optional | 1 |
| QTY | Quantity | Optional | 1 |
| REF | Reference Identification | Optional | 9 |
| Loop NM1 | Individual or Organizational Name | Optional | >1 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 1 |
| N3 | Address Information | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| PER | Administrative Communications Contact | Optional | 3 |
| ACT | Account Identification | Optional | 9 |
| DTP | Date or Time or Period | Optional | 9 |
| DMG | Demographic Information | Optional | 1 |
| REF | Reference Identification | Optional | 9 |
| QTY | Quantity | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| Loop HL | Hierarchical Level | Mandatory | 999999 |
| HL | Hierarchical Level | Mandatory | 1 |
| CRI | Claim Report Information | Optional | >1 |
| ACT | Account Identification | Optional | 2 |
| DTP | Date or Time or Period | Optional | >1 |
| CUR | Currency | Optional | 1 |
| AMT | Monetary Amount | Optional | >1 |
| FC | Financial Contribution | Optional | 2 |
| REF | Reference Identification | Optional | >1 |
| DMG | Demographic Information | Optional | 1 |
| QTY | Quantity | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| VEH | Vehicle Information | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | 999 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 1 |
| N3 | Address Information | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| PER | Administrative Communications Contact | Optional | 3 |
| ACT | Account Identification | Optional | 9 |
| DTP | Date or Time or Period | Optional | 9 |
| DMG | Demographic Information | Optional | 1 |
| REF | Reference Identification | Optional | >1 |
| QTY | Quantity | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| Loop ESI | Employment Status Information | Optional | 99 |
| ESI | Employment Status Information | Mandatory | 1 |
| EMT | Employment | Optional | 1 |
| TPB | Business Professional Title | Optional | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| REF | Reference Identification | Optional | >1 |
| QTY | Quantity | Optional | >1 |
| NM1 | Individual or Organizational Name | Optional | 1 |
| PER | Administrative Communications Contact | Optional | >1 |
| CRC | Conditions Indicator | Optional | 9 |
| Loop LX | Assigned Number | Optional | 99 |
| LX | Assigned Number | Mandatory | 1 |
| AIN | Income | Optional | 1 |
| CUR | Currency | Optional | 1 |
| TXI | Tax Information | Optional | 9 |
| WS | Work Schedule | Optional | 99 |
| DTP | Date or Time or Period | Optional | >1 |
| QTY | Quantity | Optional | 9 |
| REF | Reference Identification | Optional | >1 |
| Loop LN | Loan Information | Optional | 999 |
| LN | Loan Information | Mandatory | 1 |
| REF | Reference Identification | Optional | >1 |
| Loop VEH | Vehicle Information | Optional | >1 |
| VEH | Vehicle Information | Mandatory | 1 |
| N4 | Geographic Location | Optional | 1 |
| PID | Product/Item Description | Optional | >1 |
| Loop AMT | Monetary Amount | Optional | 99 |
| AMT | Monetary Amount | Mandatory | 1 |
| PCT | Percent Amounts | Optional | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | >1 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| DMG | Demographic Information | Optional | 1 |
| N3 | Address Information | Optional | 1 |
| N4 | Geographic Location | Optional | 1 |
| PER | Administrative Communications Contact | Optional | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| REF | Reference Identification | Optional | >1 |
| Loop LS | Loop Header | Optional | 1 |
| LS | Loop Header | Mandatory | 1 |
| Loop LX | Assigned Number | Optional | >1 |
| LX | Assigned Number | Mandatory | 1 |
| Loop III | Information | Optional | >1 |
| III | Information | Mandatory | 1 |
| IMP | Impairment Detail | Optional | 6 |
| DTP | Date or Time or Period | Optional | >1 |
| CRC | Conditions Indicator | Optional | 9 |
| QTY | Quantity | Optional | >1 |
| REF | Reference Identification | Optional | >1 |
| Loop LM | Code Source Information | Optional | >1 |
| LM | Code Source Information | Mandatory | 1 |
| LQ | Industry Code | Mandatory | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | 999 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 1 |
| N3 | Address Information | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| PER | Administrative Communications Contact | Optional | 2 |
| ACT | Account Identification | Optional | 9 |
| DTP | Date or Time or Period | Optional | >1 |
| DMG | Demographic Information | Optional | 1 |
| REF | Reference Identification | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| LE | Loop Trailer | Mandatory | 1 |
| Loop CFI | Compensation Financial Information | Optional | 999 |
| CFI | Compensation Financial Information | Mandatory | 1 |
| CUR | Currency | Optional | 1 |
| AMT | Monetary Amount | Optional | 9 |
| DTP | Date or Time or Period | Optional | >1 |
| QTY | Quantity | Optional | >1 |
| REL | Relationship | Optional | 30 |
| REF | Reference Identification | Optional | 9 |
| CRC | Conditions Indicator | Optional | >1 |
| Loop AD1 | Adjustment Amount | Optional | 999 |
| AD1 | Adjustment Amount | Mandatory | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| REF | Reference Identification | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | 999 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 1 |
| N3 | Address Information | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| PER | Administrative Communications Contact | Optional | 2 |
| ACT | Account Identification | Optional | 9 |
| DTP | Date or Time or Period | Optional | 9 |
| DMG | Demographic Information | Optional | 1 |
| REF | Reference Identification | Optional | 9 |
| GRI | Statistical Government Information | Optional | 99 |
| SE | Transaction Set Trailer | Optional | 1 |