155 Business Credit Report (005020)
This is the standard X12 005020 spec, with 19 loops and 140 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 155 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 155 files into TS155 objects. See ediFabric .NET.
ediFabric Native
Map version 005020 to the Native model with set_map, then parse 155 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 155 classes in Python, Java, Node.js, Go, Rust or C
ediFabric Native returns each 155 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 TS155. 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.
155 structure
Loops and segments of the standard 155, with their usage and maximum repeats.
| ID | Name | Usage | Max use |
|---|---|---|---|
| ST | Transaction Set Header | Optional | 1 |
| BGN | Beginning Segment | Mandatory | 1 |
| Loop N1 | Party Identification | Mandatory | 2 |
| N1 | Party Identification | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 2 |
| N3 | Party Location | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| NX2 | Location ID Component | Optional | >1 |
| PER | Administrative Communications Contact | Optional | >1 |
| Loop HL | Hierarchical Level | Mandatory | >1 |
| HL | Hierarchical Level | Mandatory | 1 |
| N1 | Party Identification | Mandatory | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| LUI | Language Use | Optional | 1 |
| C3 | Currency Identifier | Optional | 1 |
| CRC | Conditions Indicator | Optional | >1 |
| MTX | Text | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | >1 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 2 |
| TPB | Business Professional Title | Optional | 3 |
| DTP | Date or Time or Period | Optional | >1 |
| Loop NX1 | Property or Entity Identification | Optional | >1 |
| NX1 | Property or Entity Identification | Mandatory | 1 |
| N3 | Party Location | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| NX2 | Location ID Component | Optional | >1 |
| COM | Communication Contact Information | Optional | >1 |
| YNQ | Yes/No Question | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| Loop REQ | Request Information | Optional | >1 |
| REQ | Request Information | Mandatory | 1 |
| LOD | Location Description | Optional | 3 |
| MTX | Text | Optional | >1 |
| FDA | Facility Description | Optional | >1 |
| III | Information | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| AWD | Amount with Description | Optional | >1 |
| QTY | Quantity Information | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| N1 | Party Identification | Optional | 1 |
| N2 | Additional Name Information | Optional | 2 |
| Loop INR | Information Request | Optional | >1 |
| INR | Information Request | Mandatory | 1 |
| NX1 | Property or Entity Identification | Optional | 1 |
| ITC | Information Type and Comment Results | Optional | >1 |
| C3 | Currency Identifier | Optional | 1 |
| QTY | Quantity Information | Optional | >1 |
| ASO | Asset Ownership | Optional | >1 |
| SPR | Supplier Rating | Optional | >1 |
| DMG | Demographic Information | Optional | 1 |
| EMS | Employment Position | Optional | 1 |
| TER | Territory | Optional | >1 |
| YNQ | Yes/No Question | Optional | >1 |
| ASI | Action or Status Indicator | Optional | 1 |
| CRC | Conditions Indicator | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| N9 | Extended Reference Information | Optional | >1 |
| MTX | Text | Optional | >1 |
| Loop INQ | Credit Inquiry Details | Optional | >1 |
| INQ | Credit Inquiry Details | Mandatory | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| C3 | Currency Identifier | Optional | 1 |
| III | Information | Optional | >1 |
| PYT | Historical Payment Terms | Optional | >1 |
| PYM | Payment Manner and Percentage | Optional | >1 |
| AWD | Amount with Description | Optional | >1 |
| QTY | Quantity Information | Optional | 1 |
| ACD | Account Description | Optional | >1 |
| MEA | Measurements | Optional | >1 |
| SPR | Supplier Rating | Optional | >1 |
| ASO | Asset Ownership | Optional | >1 |
| Loop LX | Transaction Set Line Number | Optional | >1 |
| LX | Transaction Set Line Number | Mandatory | 1 |
| NM1 | Individual or Organizational Name | Optional | 1 |
| NX1 | Property or Entity Identification | Optional | 1 |
| N2 | Additional Name Information | Optional | 2 |
| TPB | Business Professional Title | Optional | 6 |
| N3 | Party Location | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| NX2 | Location ID Component | Optional | >1 |
| COM | Communication Contact Information | Optional | >1 |
| N9 | Extended Reference Information | Optional | >1 |
| AWD | Amount with Description | Optional | >1 |
| ASO | Asset Ownership | Optional | >1 |
| YNQ | Yes/No Question | Optional | >1 |
| PCT | Percent Amounts | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| QTY | Quantity Information | Optional | >1 |
| Loop LM | Code Source Information | Optional | >1 |
| LM | Code Source Information | Mandatory | 1 |
| III | Information | Mandatory | >1 |
| PCT | Percent Amounts | Optional | >1 |
| Loop LX | Transaction Set Line Number | Optional | >1 |
| LX | Transaction Set Line Number | Mandatory | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| MTX | Text | Optional | >1 |
| LQ | Industry Code Identification | Optional | >1 |
| AWD | Amount with Description | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | >1 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 2 |
| TPB | Business Professional Title | Optional | 6 |
| Loop REQ | Request Information | Optional | >1 |
| REQ | Request Information | Mandatory | 1 |
| AWD | Amount with Description | Optional | >1 |
| CRC | Conditions Indicator | Optional | >1 |
| QTY | Quantity Information | Optional | >1 |
| PCT | Percent Amounts | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| YNQ | Yes/No Question | Optional | >1 |
| MTX | Text | Optional | >1 |
| Loop API | Activity or Process Information | Optional | >1 |
| API | Activity or Process Information | Mandatory | 1 |
| YNQ | Yes/No Question | Optional | 1 |
| N9 | Extended Reference Information | Optional | >1 |
| CDS | Case Description | Optional | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| BBC | Legal Claims | Optional | >1 |
| MEA | Measurements | Optional | >1 |
| ASO | Asset Ownership | Optional | >1 |
| MTX | Text | Optional | >1 |
| PCT | Percent Amounts | Optional | >1 |
| Loop LM | Code Source Information | Optional | >1 |
| LM | Code Source Information | Mandatory | 1 |
| III | Information | Mandatory | >1 |
| Loop CRC | Conditions Indicator | Optional | >1 |
| CRC | Conditions Indicator | Mandatory | 1 |
| AWD | Amount with Description | Optional | >1 |
| Loop NM1 | Individual or Organizational Name | Optional | >1 |
| NM1 | Individual or Organizational Name | Mandatory | 1 |
| N2 | Additional Name Information | Optional | 2 |
| TPB | Business Professional Title | Optional | 6 |
| N3 | Party Location | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| NX2 | Location ID Component | Optional | >1 |
| COM | Communication Contact Information | Optional | >1 |
| DTP | Date or Time or Period | Optional | >1 |
| ITC | Information Type and Comment Results | Optional | 1 |
| MTX | Text | Optional | >1 |
| YNQ | Yes/No Question | Optional | >1 |
| AWD | Amount with Description | Optional | >1 |
| Loop IN1 | Individual Identification | Optional | >1 |
| IN1 | Individual Identification | Mandatory | 1 |
| IN2 | Individual Name Structure Components | Optional | >1 |
| TPB | Business Professional Title | Optional | 3 |
| N3 | Party Location | Optional | 2 |
| N4 | Geographic Location | Optional | 1 |
| NX2 | Location ID Component | Optional | >1 |
| Loop CED | Administration of Justice Event Description | Optional | >1 |
| CED | Administration of Justice Event Description | Mandatory | 1 |
| DTP | Date or Time or Period | Optional | >1 |
| MTX | Text | Optional | >1 |
| NM1 | Individual or Organizational Name | Optional | 1 |
| N2 | Additional Name Information | Optional | 2 |
| Loop LM | Code Source Information | Optional | >1 |
| LM | Code Source Information | Mandatory | 1 |
| LQ | Industry Code Identification | Mandatory | >1 |
| SE | Transaction Set Trailer | Optional | 1 |