---
title: MedicalEdiFileService
summary: API reference for MedicalEdiFileService.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-24
library: SAIF.Services
reference_type: package
---

# 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