MedicalEdiFileService¶

Implements IMedicalEdiFileService, reading and validating EDI 999 functional-acknowledgment files: parsing a file from disk into an Edi999File, checking its envelope/segment structure and batch type, and extracting the acknowledgment status (IK5), rejected-segment details (IK3), and originating batch number (AK1) from its segments.

Purpose¶

Reads a 999 transaction-set file from disk into a strongly typed IEdiFile/Edi999File, logging and rethrowing on read failure.
Validates that a parsed EDI file has the expected ISA/IEA envelope structure and matches an expected transaction-set (batch) type.
Extracts the originating batch number, acknowledgment response segment, and any rejected (IK3) detail segments from a 999 file.
Determines whether an acknowledgment response indicates the original file was accepted or rejected.

Context¶

Namespace: SAIF.Services.Edi
Assembly/package: SAIF.Services (packaged inside the SAIF.SAIFCode.Core NuGet package)

Public members¶

Member	Signature	Purpose
MedicalEdiFileService(...)	`public MedicalEdiFileService(IUserProfileService prof)`	Stores the user-profile collaborator, requiring it to be non-null (the profile itself is not otherwise used by the members shown).
Read999TransactionSet	`public static IEdiFile Read999TransactionSet(string filepath, ILogWriter controlLog)`	Reads and parses the EDI file at `filepath` into an `Edi999File`, logging the full exception text to `controlLog` and rethrowing if the read fails.
IsFileStructureValid	`public bool IsFileStructureValid(IEdiFile file)`	Returns true when `file`'s first segment is `ISA` and its last segment is `IEA`, confirming a well-formed EDI envelope.
IsFileBatchTypeValid	`public bool IsFileBatchTypeValid(IEdiFile file, string batchType)`	Returns true when `file` contains an `ST` segment whose transaction-set identifier code matches `batchType`.
GetBatchNumberFrom999File	`public long GetBatchNumberFrom999File(IEdiFile file)`	Returns the control number from `file`'s `AK1` segment, identifying which original batch this 999 acknowledges.
GetIk5SegmentResponseCode	`public Ik5Segment GetIk5SegmentResponseCode(IEdiFile file)`	Returns the parsed `IK5` segment (overall acknowledgment response) from `file`'s first matching segment.
IsSegmentValid	`public bool IsSegmentValid(Ik5Segment ik5Segment)`	Returns false when `ik5Segment` is null, true otherwise.
HasFileBeenAccepted	`public bool HasFileBeenAccepted(Ik5Segment ik5Segment)`	Returns false when `ik5Segment.ResponseCode` is `"R"` (rejected), true for any other response code.
GetIk3Segments	`public IList<Ik3Segment> GetIk3Segments(IEdiFile file)`	Returns every `IK3` (transaction-set-level rejection detail) segment found in `file`, parsed to `Ik3Segment`.

Behavioral notes¶

Read999TransactionSet is exposed both as a public static method and as an explicit IMedicalEdiFileService.Read999TransactionSet interface implementation that simply forwards to the static method, so the interface-typed call and the static call share identical behavior*.
Read999TransactionSet uses SAIF.Common.Files.Edi.EdiManager to build and read the file, then wraps the result in Edi999File before returning.
HasFileBeenAccepted treats any response code other than the literal "R" as accepted, including unexpected/unknown codes*.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources¶

Services/SAIF.Services/Edi/MedicalEdiFileService.cs