--- title: ClaimIntake summary: Operations exposed by the ClaimIntake WCF service class for claim submission, intake status, and review flagging. status: draft owner: Claims Systems Team last_reviewed: 2026-09-10 --- # ClaimIntake `ClaimIntake` is the WCF service class that lets SAIF's internal applications submit a first report of injury, read the intake status of a submitted claim, and flag a submitted claim for manual review. It is called by the claims portal and by the `SAIF.Claims.Intake.Client` proxy package. | Field | Value | | --- | --- | | **Service class** | `ClaimIntake` | | **Declared contract** | `IClaimIntake` - In repository (`src/SAIF.Claims.Intake.Service/IClaimIntake.cs`) | | **Route** | `ClaimIntake.svc` | | **Source** | `src/SAIF.Claims.Intake.Service/ClaimIntake.svc.cs` | | **Service attributes** | `[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]`, `[LogErrorBehavior]` | | **Instancing / concurrency** | `InstanceContextMode.PerCall` / `ConcurrencyMode.Single` | | **Binding** | `basicHttpBinding` (`ClaimIntakeBasic`) | | **Class-level authorization** | None in code | | **Error handling** | `ClaimIntakeErrorHandler` installed by `[LogErrorBehavior]` - see [Faults and error pipeline](../faults.md) | | **Operations** | 3 | | **Also hosted in** | - | --- ## SubmitClaim Records a first report of injury and returns a receipt carrying the assigned claim number. | Field | Value | | --- | --- | | **Operation name** | `SubmitClaim` | | **Contract name** | `SubmitClaim` | | **SOAP action** | `http://services.saif.example/claims/intake/v1/ClaimIntake/SubmitClaim` | | **Implementing member** | `ClaimIntake.SubmitClaim` (`src/SAIF.Claims.Intake.Service/ClaimIntake.svc.cs:44`) | | **Pattern** | Request/response | | **Binding** | `basicHttpBinding` (`ClaimIntakeBasic`) | | **Authorization** | `SAIF\ClaimsIntakeSubmitters` role | | **Process** | OP-001 | ### Input message | Part | Type | Required | Default | Purpose | | --- | --- | --- | --- | --- | | `submission` | `ClaimSubmission` | Yes | - | The first report of injury being submitted | #### Complex input types | Type | Kind | Members | Declared in | | --- | --- | --- | --- | | `ClaimSubmission` | Data contract | `BodyPartCode`, `ClaimantContact`, `ClaimantFirstName`, `ClaimantLastName`, `EmployerPolicyNumber`, `InjuryDate`, `InjuryDescription` | `src/SAIF.Claims.Intake.Service/DataContracts/ClaimSubmission.cs` | | `ClaimantContact` | Data contract | `Email`, `Phone` | `src/SAIF.Claims.Intake.Service/DataContracts/ClaimantContact.cs` | ### Output message | Field | Value | | --- | --- | | **Return type** | `ClaimReceipt` | | **Meaning** | Confirmation that intake accepted the report, carrying the assigned claim number | | **Empty-result behavior** | Never empty: on success the receipt is always populated, and on failure the operation throws instead of returning null | | Member | Type | Nullable | Purpose | | --- | --- | --- | --- | | `ClaimNumber` | `string` | No | The claim number assigned by intake, or the existing number when the submission is a duplicate | | `IsDuplicate` | `bool` | No | True when an earlier submission matched and no new record was written (BR-CLM-003) | | `ReceivedUtc` | `DateTime` | No | When intake accepted the original submission | | `Status` | `string` | No | The intake status at the time of the call, always `Received` on a first submission | ### Faults | Fault | Declared | Raised when | Surfaced as | Detail crosses the boundary | | --- | --- | --- | --- | --- | | `ClaimValidationFault` | `[FaultContract(typeof(ClaimValidationFault))]` | The injury date is in the future (BR-CLM-001) or the employer policy is not active on the injury date (BR-CLM-002) | Typed SOAP fault | Yes | | `OracleException` | Not declared | The `PKG_CLAIM_INTAKE.INSERT_CLAIM` call fails | Generic SOAP fault produced by WCF through the error pipeline | No | ### Authorization `SubmitClaim` carries `[PrincipalPermission(SecurityAction.Demand, Role = @"SAIF\ClaimsIntakeSubmitters")]`, so a caller outside that Windows group is rejected before the method body runs. See the Submitter role requirement section of Authentication and authorization. ### Side effects | Aspect | Finding | | --- | --- | | Records written | `CLM.CLAIM_INTAKE` (data model) | | Downstream calls | `PKG_CLAIM_INTAKE.INSERT_CLAIM` (Oracle stored procedure) | | Files or messages produced | None | | Shared state touched | None | | Repeat-call behavior | A second submission with the same policy number, claimant name, and injury date within 24 hours returns the original receipt with `IsDuplicate` set to true and writes no second record (BR-CLM-003) | ### Example message ```xml HND alex.rivera@example.com 503-555-0142 Alex Rivera PL-0048213 2026-09-03T00:00:00 Laceration to left hand while clearing a jammed conveyor. ``` ```xml 2026-0041872 false 2026-09-10T16:42:08Z Received ``` --- ## GetClaimStatus Returns the current intake status of a previously submitted claim. | Field | Value | | --- | --- | | **Operation name** | `GetClaimStatus` | | **Contract name** | `GetClaimStatus` | | **SOAP action** | `http://services.saif.example/claims/intake/v1/ClaimIntake/GetClaimStatus` | | **Implementing member** | `ClaimIntake.GetClaimStatus` (`src/SAIF.Claims.Intake.Service/ClaimIntake.svc.cs:88`) | | **Pattern** | Request/response | | **Binding** | `basicHttpBinding` (`ClaimIntakeBasic`) | | **Authorization** | None in code | | **Process** | - | ### Input message | Part | Type | Required | Default | Purpose | | --- | --- | --- | --- | --- | | `claimNumber` | `string` | Yes | - | The claim number returned by `SubmitClaim` | ### Output message | Field | Value | | --- | --- | | **Return type** | `ClaimStatusResult` | | **Meaning** | The intake status recorded for the claim and when it last changed | | **Empty-result behavior** | Returns null when no claim matches the claim number, and also when the lookup fails (see Swallowed failures in [Faults and error pipeline](../faults.md)) | | Member | Type | Nullable | Purpose | | --- | --- | --- | --- | | `ClaimNumber` | `string` | No | The claim number that was requested | | `LastUpdatedUtc` | `DateTime` | No | When the status last changed | | `Status` | `string` | No | One of `Received`, `InReview`, `Accepted`, or `Denied` | | `StatusReason` | `string` | Yes | Free-text reason recorded with the status, absent when none was entered | ### Faults | Fault | Declared | Raised when | Surfaced as | Detail crosses the boundary | | --- | --- | --- | --- | --- | | `Exception` | Not declared | Any failure inside the method, including a database error | Not surfaced - the exception is caught and the operation returns null | No | No fault contract is declared for this operation. See [Faults and error pipeline](../faults.md) for what the caller actually receives. ### Authorization None in code. The `ClaimIntakeBasic` binding requires Windows transport authentication, so the caller is identified, but no role or permission check is made inside the method. See Authentication and authorization. ### Side effects | Aspect | Finding | | --- | --- | | Records written | None | | Downstream calls | `PKG_CLAIM_INTAKE.GET_STATUS` (Oracle stored procedure) | | Files or messages produced | None | | Shared state touched | None | | Repeat-call behavior | Returns the current status each time; no state changes | ### Example message ```xml 2026-0041872 ``` ```xml 2026-0041872 2026-09-10T16:42:08Z Received ``` --- ## FlagClaimForReview Marks a submitted claim for manual review and records the reason, without returning anything to the caller. | Field | Value | | --- | --- | | **Operation name** | `FlagClaimForReview` | | **Contract name** | `FlagClaimForReview` | | **SOAP action** | `http://services.saif.example/claims/intake/v1/ClaimIntake/FlagClaimForReview` | | **Implementing member** | `ClaimIntake.FlagClaimForReview` (`src/SAIF.Claims.Intake.Service/ClaimIntake.svc.cs:121`) | | **Pattern** | One-way (`IsOneWay = true`) | | **Binding** | `basicHttpBinding` (`ClaimIntakeBasic`) | | **Authorization** | `SAIF\ClaimsIntakeSubmitters` role | | **Process** | OP-002 | ### Input message | Part | Type | Required | Default | Purpose | | --- | --- | --- | --- | --- | | `claimNumber` | `string` | Yes | - | The claim to flag | | `reason` | `string` | Yes | - | Why the claim needs manual review; an empty value is rejected (BR-CLM-004) | ### Output message | Field | Value | | --- | --- | | **Return type** | void | | **Meaning** | A successful send means only that the request was accepted for processing; the caller cannot learn whether the flag was recorded | | **Empty-result behavior** | Not applicable - a one-way operation returns no message | ### Faults | Fault | Declared | Raised when | Surfaced as | Detail crosses the boundary | | --- | --- | --- | --- | --- | | `OracleException` | Not declared | The `PKG_CLAIM_INTAKE.ADD_REVIEW_FLAG` call fails | Not surfaced - a one-way operation returns no message, so the failure is only logged by the error pipeline | No | No fault contract is declared for this operation. See [Faults and error pipeline](../faults.md) for what the caller actually receives. ### Authorization `FlagClaimForReview` carries `[PrincipalPermission(SecurityAction.Demand, Role = @"SAIF\ClaimsIntakeSubmitters")]`, the same requirement as `SubmitClaim`. See the Submitter role requirement section of Authentication and authorization. ### Side effects | Aspect | Finding | | --- | --- | | Records written | `CLM.CLAIM_INTAKE_NOTE` (data model) | | Downstream calls | `PKG_CLAIM_INTAKE.ADD_REVIEW_FLAG` (Oracle stored procedure) | | Files or messages produced | None | | Shared state touched | None | | Repeat-call behavior | Each call inserts another note row; duplicate flags are not detected | ### Example message ```xml 2026-0041872 Injury description conflicts with the employer's report. ``` This operation is one-way, so there is no response envelope. --- ## Coverage checklist | Public member | Documented section | Pattern | | --- | --- | --- | | `ClaimReceipt SubmitClaim(ClaimSubmission submission)` | [`SubmitClaim`](#submitclaim) | Request/response | | `ClaimStatusResult GetClaimStatus(string claimNumber)` | [`GetClaimStatus`](#getclaimstatus) | Request/response | | `void FlagClaimForReview(string claimNumber, string reason)` | [`FlagClaimForReview`](#flagclaimforreview) | One-way | | `ClaimIntake()` | Not an operation - parameterless constructor, not declared on `IClaimIntake` | - | ## Related documentation - [Index](../index.md) - Overview - Architecture - Activation and hosting - Operations - [Faults and error pipeline](../faults.md) - Authentication and authorization - Dependencies - Configuration - Operations and processes - Business rules - Data model - Operational runbook - Tech debt ## Sources - `src/SAIF.Claims.Intake.Service/ClaimIntake.svc.cs` - `src/SAIF.Claims.Intake.Service/IClaimIntake.cs` - `src/SAIF.Claims.Intake.Service/DataContracts/ClaimSubmission.cs` - `src/SAIF.Claims.Intake.Service/DataContracts/ClaimantContact.cs` - `src/SAIF.Claims.Intake.Service/DataContracts/ClaimReceipt.cs` - `src/SAIF.Claims.Intake.Service/DataContracts/ClaimStatusResult.cs` - `src/SAIF.Claims.Intake.Service/DataContracts/ClaimValidationFault.cs` - `src/SAIF.Claims.Intake.Service/Web.config`