---
title: BillServiceFee
summary: API reference for BillServiceFee.
status: draft
owner: SAIF.Core documentation team
last_reviewed: 2026-09-24
library: SAIF.Data
reference_type: package
---

# BillServiceFee

Domain entity representing Bill service fee data within the legal bills area of the claims/policy domain, mapped for NHibernate persistence.*

## Purpose
- Models bill service fee data used by the legal bills area of this library.*
- Inherits shared identity/lifecycle behavior from `EntityBase`.

## Context
- Namespace: `SAIF.Data.Model.Legal.Bills`
- Assembly/package: `SAIF.Data`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| Id | `long Id { get; set; }` | Primary key / surrogate identifier for this record.* |
| BillServiceCode | `String BillServiceCode { get; set; }` | Coded value identifying bill service code.* |
| EffectiveDate | `DateTime EffectiveDate { get; set; }` | Date/time value for effective date.* |
| ExpirationDate | `DateTime? ExpirationDate { get; set; }` | Date/time value for expiration date.* |
| ImeId | `long? ImeId { get; set; }` | Foreign-key identifier referencing the related ime record.* |
| McoPlanId | `String McoPlanId { get; set; }` | Foreign-key identifier referencing the related mco plan record.* |
| InitialUnitAmount | `Decimal InitialUnitAmount { get; set; }` | Monetary amount for initial unit amount.* |
| AdditionalUnitAmount | `Decimal AdditionalUnitAmount { get; set; }` | Monetary amount for additional unit amount.* |
| MaximumAmount | `Decimal MaximumAmount { get; set; }` | Monetary amount for maximum amount.* |
| FlatAmount | `Decimal FlatAmount { get; set; }` | Monetary amount for flat amount.* |
| InitialUnits | `Decimal InitialUnits { get; set; }` | Value of initial units exposed by this type.* |
| AdditionalUnits | `Decimal AdditionalUnits { get; set; }` | Value of additional units exposed by this type.* |

## Behavioral notes
- Properties are typically declared `virtual` to support NHibernate lazy-loading proxies (see the corresponding mapping file under `Data/SAIF.Data.NHibernate`).*

## Constraints and usage notes
- No additional usage constraints beyond standard NHibernate entity/DTO conventions could be confirmed from static analysis.**

> **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
- `Data/SAIF.Data/Model/Legal/Bills/BillServiceFee.cs`