X12 270/271 Eligibility Benefit Inquiry

[pwelter34]

Hello,

Any have a model for X12 270/271 Eligibility Benefit Inquiry? I'm struggling to make the HL Hierarchical Level deserialize correctly. Anyone have any success with this?

https://www.stedi.com/edi/x12/transaction-set/270

How do you model the "Loop" definitions? In the doc, there is 2000 Loop, 2100 Loop and 2110 Loop. How should the classes and properties by setup for those?

thanks for help

[WhereRtheInterwebs]

This might not be 100% implemented, but it does work.

[EdiSegment]
[EdiSegmentGroup("ISA", SequenceEnd = "IEA")]
public class Interchange271
{
    [EdiValue("9(2)", Path = "ISA/0", Mandatory = true)]
    public int AuthorizationInformationQualifier { get; set; }

    [EdiValue("X(10)", Path = "ISA/1", Mandatory = true)]
    public string AuthorizationInformation { get; set; }

    [EdiValue("9(2)", Path = "ISA/2", Mandatory = true)]
    public int SecurityInformationQualifier { get; set; }

    [EdiValue("X(10)", Path = "ISA/3", Mandatory = true)]
    public string SecurityInformation { get; set; }

    [EdiValue("X(2)", Path = "ISA/4", Mandatory = true)]
    public string InterchangeIDQualifier1 { get; set; }

    [EdiValue("X(15)", Path = "ISA/5", Mandatory = true)]
    public string InterchangeSenderID { get; set; }

    [EdiValue("X(2)", Path = "ISA/6", Mandatory = true)]
    public string InterchangeIDQualifier2 { get; set; }

    [EdiValue("X(15)", Path = "ISA/7", Mandatory = true)]
    public string InterchangeReceiverID { get; set; }

    [EdiValue("9(6)", Path = "ISA/8", Mandatory = true, Format = "yyMMdd")]
    public DateTime InterchangeDate { get; set; }

    [EdiValue("9(4)", Path = "ISA/9", Mandatory = true, Format = "HHmm")]
    public DateTime InterchangeTime { get; set; }

    [EdiValue("X(1)", Path = "ISA/10", Mandatory = true)]
    public string InterchangeControlStandardsIdentifier { get; set; }

    [EdiValue("9(5)", Path = "ISA/11", Mandatory = true)]
    public int InterchangeControlVersionNumber { get; set; }

    [EdiValue("9(9)", Path = "ISA/12", Mandatory = true)]
    [EdiValue("9(9)", Path = "IEA/1", Mandatory = true)]
    public int InterchangeControlNumber { get; set; }

    [EdiValue("X(1)", Path = "ISA/13", Mandatory = true)]
    public string AcknowledgmentRequested { get; set; }

    [EdiValue("X(1)", Path = "ISA/14", Mandatory = true)]
    public string UsageIndicator { get; set; }

    [EdiValue("X(1)", Path = "ISA/15", Mandatory = true)]
    public string ComponentElementSeparator { get; set; }

    [EdiValue("9(0)", Path = "IEA/0", Mandatory = true)]
    public int FunctionalGroupCount
    {
        get => GS.Count;
        set => _ = value;
    }
    
    public List<GS> GS { get; set; } = new List<GS>();
}

[EdiSegment]
[EdiGroup]
public class GS
{
    [EdiValue("X(2)", Path = "GS/0")]
    public string FunctionalIdentifierCode { get; set; }

    [EdiValue("X(9)", Path = "GS/1")]
    public string ApplicationSenderCode { get; set; }

    [EdiValue("X(9)", Path = "GS/2")]
    public string ApplicationReceiverCode { get; set; }

    [EdiValue("9(8)", Path = "GS/3", Mandatory = true, Format = "yyyyMMdd")]
    public DateTime Date { get; set; }

    [EdiValue("9(6)", Path = "GS/4", Format = "HHmmss")]
    public DateTime Time { get; set; }

    [EdiValue("9(0)", Path = "GS/5")]
    [EdiValue("9(0)", Path = "GE/1", Mandatory = true)]
    public int GroupControlNumber { get; set; }

    [EdiValue("X(2)", Path = "GS/6")]
    public string ResponsibleAgencyCode { get; set; }

    [EdiValue("X(12)", Path = "GS/7")]
    public string VersionReleaseIndustryIdentifierCode { get; set; }

    public List<ST> ST { get; set; } = new List<ST>();

    [EdiValue("9(0)", Path = "GE/0", Mandatory = true)]
    [EdiCount(EdiCountScope.Messages)]
    public int NumberOfTransactionSetsIncluded { get; set; }
}

[EdiMessage]
public class ST
{
    [EdiValue("9(3)", Path = "ST/0", Mandatory = true)]
    public int TransactionSetIdentifierCode { get; set; } // Should be "271"

    [EdiValue("9(5)", Path = "ST/1", Mandatory = true)]
    [EdiValue("9(5)", Path = "SE/1", Mandatory = true)]
    public int TransactionSetControlNumber { get; set; }

    [EdiValue("X(35)", Path = "ST/2")]
    public string TransactionSetVersion { get; set; }

    public BHT BHT { get; set; }

    public List<HL> HL { get; set; } = new List<HL>();

    [EdiValue("9(0)", Path = "SE/0", Mandatory = true)]
    [EdiCount(EdiCountScope.Segments)]
    public int NumberOfIncludedSegments { get; set; }
}

[EdiSegment]
[EdiPath("BHT")]
public class BHT
{
    [EdiValue("9(4)", Path = "BHT/0", Mandatory = true)]
    public int HierarchicalStructureCode { get; set; }

    [EdiValue("9(2)", Path = "BHT/1", Mandatory = true)]
    public int TransactionSetPurposeCode { get; set; } // e.g., "13" for Request

    [EdiValue("X(30)", Path = "BHT/2")]
    public string ReferenceIdentification { get; set; }

    [EdiValue("9(8)", Path = "BHT/3", Mandatory = true, Format = "yyyyMMdd")]
    public DateTime Date { get; set; }

    [EdiValue("9(4)", Path = "BHT/4", Mandatory = true, Format = "HHmm")]
    public DateTime Time { get; set; }

    [EdiValue("X(2)", Path = "BHT/5")]
    public string TransactionTypeCode { get; set; }
}

[EdiSegment]
[EdiSegmentGroup("HL")]
public class HL
{
    [EdiValue("9(0)", Path = "HL/0", Mandatory = true)]
    public int HierarchicalIDNumber { get; set; }

    [EdiValue("9(0)", Path = "HL/1")]
    public int? HierarchicalParentIDNumber { get; set; }

    [EdiValue("9(2)", Path = "HL/2", Mandatory = true)]
    public int HierarchicalLevelCode { get; set; } // e.g., "20", "21", "22", "23"

    [EdiValue("9(1)", Path = "HL/3")]
    public int? HierarchicalChildCode { get; set; }

    public List<TRN> TRN { get; set; } = new List<TRN>();

    public List<NM1> Name { get; set; } = new List<NM1>();

    public List<EB> EB { get; set; } = new List<EB>();

    public EQ EQ { get; set; }
}

[EdiSegment]
[EdiPath("EQ")]
public class EQ
{
    [EdiValue("9(2)", Path = "EQ/0", Mandatory = true)]
    public int EQTypeCode { get; set; }
}

[EdiSegment]
[EdiSegmentGroup("NM1", "N3", "N4", "DMG")]
public class NM1
{
    [EdiValue("X(2)", Path = "NM1/0", Mandatory = true)]
    public string EntityIdentifierCode { get; set; } // e.g., "PR", "1P", "IL", "03"

    [EdiValue("9(1)", Path = "NM1/1", Mandatory = true)]
    public int NameTypeCode { get; set; } // e.g., "2", "1"

    [EdiValue("X(60)", Path = "NM1/2", Mandatory = true)]
    public string NameLastOrOrganizationName { get; set; }

    [EdiValue("X(35)", Path = "NM1/3")]
    public string NameFirst { get; set; }

    [EdiValue("X(35)", Path = "NM1/4")]
    public string NameMiddle { get; set; }

    [EdiValue("X(10)", Path = "NM1/5")]
    public string NamePrefix { get; set; }

    [EdiValue("X(10)", Path = "NM1/6")]
    public string NameSuffix { get; set; }

    [EdiValue("X(2)", Path = "NM1/7")]
    public string IdentificationCodeQualifier { get; set; } // e.g., "46", "FI", "MI"

    [EdiValue("X(80)", Path = "NM1/8")]
    public string IdentificationCode { get; set; }

    [EdiValue("X(2)", Path = "NM1/9")]
    public string EntityRelationshipCode { get; set; }

    [EdiValue("X(2)", Path = "NM1/10")]
    public string EntityIdentifierCode2 { get; set; }

    public List<REF> REF { get; set; } = new List<REF>();

    public N3 N3 { get; set; }
    public N4 N4 { get; set; }

    public DMG DMG { get; set; }

    public List<DTP> DTP { get; set; } = new List<DTP>();

}

[EdiSegment]
[EdiPath("N3")]
public class N3
{
    [EdiValue("X(55)", Path = "N3/0")]
    public string AddressInformation { get; set; }
}

[EdiSegment]
[EdiPath("N4")]
public class N4
{
    [EdiValue("X(30)", Path = "N4/0", Mandatory = true)]
    public string CityName { get; set; }

    [EdiValue("X(2)", Path = "N4/1", Mandatory = true)]
    public string StateOrProvinceCode { get; set; }

    [EdiValue("X(9)", Path = "N4/2", Mandatory = true)]
    public string PostalCode { get; set; }
}

[EdiSegment]
[EdiPath("DMG")]
public class DMG
{
    [EdiValue("X(2)", Path = "DMG/0", Mandatory = true)] // Often "D8" for YYYYMMDD
    public string DateTimePeriodFormatQualifier { get; set; }

    [EdiValue("9(8)", Path = "DMG/1", Mandatory = true, Format = "yyyyMMdd")]
    public DateTime? DateTimePeriod { get; set; } // Date of Birth

    [EdiValue("X(1)", Path = "DMG/2", Mandatory = true)]
    public string GenderCode { get; set; } // e.g., "M", "F", "U"

    [EdiValue("X(1)", Path = "DMG/3")]
    public string RaceOrEthnicityCode { get; set; }

    [EdiValue("X(1)", Path = "DMG/4")]
    public string CitizenshipStatusCode { get; set; }

    [EdiValue("X(1)", Path = "DMG/5")]
    public string MaritalStatusCode { get; set; }

    [EdiValue("X(1)", Path = "DMG/6")]
    public string BasisOfVerificationCode { get; set; }

    [EdiValue("9(1)", Path = "DMG/7")]
    public int? Count { get; set; }

    [EdiValue("X(1)", Path = "DMG/8")]
    public string CodeListQualifierCode { get; set; }

    [EdiValue("X(30)", Path = "DMG/9")]
    public string IndustryCode { get; set; }
}

[EdiSegment]
[EdiSegmentGroup("EB")]
public class EB
{
    [EdiValue("X(2)", Path = "EB/0")]
    public string EligibilityOrBenefitInformation { get; set; }

    [EdiValue("X(2)", Path = "EB/1")]
    public string CoverageLevelCode { get; set; }

    [EdiValue("X(2)", Path = "EB/2")]
    public string ServiceTypeCode { get; set; }

    [EdiValue("X(2)", Path = "EB/3")]
    public string InsuranceTypeCode { get; set; }

    [EdiValue("X(50)", Path = "EB/4")]
    public string PlanCoverageDescription { get; set; }

    [EdiValue("X(2)", Path = "EB/5")]
    public string TimePeriodQualifier { get; set; }

    [EdiValue("9(2)", Path = "EB/6")]
    public decimal BenefitAmount { get; set; }

    [EdiValue("9(2)", Path = "EB/7")]
    public decimal BenefitPercent { get; set; }

    [EdiValue("X(1)", Path = "EB/8")]
    public string AuthorizationOrCertificationIndicator { get; set; }

    [EdiValue("X(1)", Path = "EB/9")]
    public string InPlanNetworkIndicator { get; set; }

    public NM1 NM1 { get; set; }
    public List<REF> REF { get; set; } = new List<REF>();
    public List<DTP> DTP { get; set; } = new List<DTP>();
}

[EdiSegment]
[EdiPath("REF")]
public class REF
{
    [EdiValue("X(2)", Path = "REF/0", Mandatory = true)]
    public string ReferenceIdentificationQualifier { get; set; } // e.g., "0F", "1W"

    [EdiValue("X(80)", Path = "REF/1")]
    public string ReferenceIdentification { get; set; }

    [EdiValue("X(80)", Path = "REF/2")]
    public string Description { get; set; }
}

[EdiSegment]
[EdiPath("DTP")]
public class DTP
{
    [EdiValue("9(3)", Path = "DTP/0", Mandatory = true)]
    public int DateTimeQualifier { get; set; } // e.g., "297", "296"

    [EdiValue("X(3)", Path = "DTP/1", Mandatory = true)]
    public string DateTimePeriodFormatQualifier { get; set; } // e.g., "D8"

    [EdiValue("9(8)", Path = "DTP/2", Mandatory = true, Format = "yyyyMMdd")]
    public DateTime DateTimePeriod { get; set; }
}

[EdiSegment]
[EdiPath("TRN")]
public class TRN
{
    [EdiValue("9(0)", Path = "TRN/0", Mandatory = true)]
    public int TraceTypeCode { get; set; }

    [EdiValue("X(30)", Path = "TRN/1", Mandatory = true)]
    public string TraceNumber { get; set; }

    [EdiValue("X(10)", Path = "TRN/2")]
    public string OriginatingCompanyIdentifier { get; set; }

    [EdiValue("X(2)", Path = "TRN/3")]
    public string OriginatingCompanySegmentIdentifier { get; set; }

    [EdiValue("9(6)", Path = "TRN/4")]
    public int? OriginatingCompanySegmentPosition { get; set; }

    [EdiValue("X(80)", Path = "TRN/5")]
    public string ReferenceIdentification { get; set; }
}