BillProcedureService

Manages the create, read, update, and delete lifecycle of procedure line items attached to a claim bill, coordinating with IUnitOfWork for transactional persistence, IBillQueryProvider for loading the owning bill, IValidationService for per-item validation, IUserProfileService to stamp the acting user, and IProcedureService to confirm procedure code validity. Reassigns sequential BillProcedureId values when adding new procedures and rejects concurrent updates by comparing UpdateNumber before applying changes.

Purpose

• Creates new bill procedure line items on a bill, assigning sequential procedure IDs and validating each item before commit.
• Retrieves the procedures currently attached to a bill, annotating each with code-validity flags.
• Updates existing procedure line items while enforcing optimistic-concurrency checks against UpdateNumber.
• Deletes one, several, or all procedure line items from a bill.
• Exposes the reference list of primary procedure codes usable when entering procedures.

Context

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

Public members

Member	Signature	Purpose
BillProcedureService (constructor)	public BillProcedureService(IUnitOfWork uow, IUserProfileService uprof, IValidationService val, IBillQueryProvider billQueryProvider, IProcedureService ProcedureService)	Wires the unit of work, user-profile, validation, bill-query, and procedure-lookup collaborators, and captures the current user's ID (uppercased, prefix before the first -) for stamping audit fields.*
CreateProcedures	public List<BillProcedure> CreateProcedures(long billId, List<BillProcedure> newProcedures, IMessageContainer messageContainer)	Validates and appends new procedure lines to the bill, assigning each a sequential BillProcedureId continuing from the current maximum, then returns the newly added procedures with validity flags populated; returns an empty list and rolls back if validation fails.
GetProcedures	public List<BillProcedure> GetProcedures(long billId, IMessageContainer messageContainer)	Returns all procedure line items currently on the bill, each flagged with IsValidCode and IsValidProcedureDate based on lookup against IProcedureService.
UpdateProcedures	public List<BillProcedure> UpdateProcedures(long billId, List<BillProcedure> updatedProcedures, IMessageContainer messageContainer)	Applies edits to existing procedure lines after validation, rejecting the entire update (adding an error and returning an empty list) if a line's UpdateNumber no longer matches the persisted value, indicating a concurrent edit.
DeleteProcedures	public void DeleteProcedures(long billId, long[] ProcedureIds, IMessageContainer messageContainer)	Removes the specified procedure line items (by BillProcedureId) from the bill within a single transaction.
DeleteProcedures	public void DeleteProcedures(long billId, IMessageContainer messageContainer)	Removes every procedure line item from the bill.
GetPrimaryProcedureCodes	public List<CbpPrimaryProcedureCode> GetPrimaryProcedureCodes()	Returns the full reference list of primary procedure codes available for selection when entering a procedure.

Behavioral notes

• Wraps CreateProcedures, UpdateProcedures, and both DeleteProcedures overloads in unitOfWork.Begin()/unitOfWork.Commit(), disposing the unit of work without committing when validation or concurrency checks fail.
• Enforces optimistic concurrency on updates by comparing UpdateNumber and surfacing a conflict message identifying the last updating user before aborting.
• Normalizes procedure codes to uppercase and trims whitespace before validation via a private CleanProcedures step.*
• Uses IValidationService.Validate per procedure item and forwards each validation error into the supplied IMessageContainer.
• A static constructor calls BillMappingHelper.MapBillService(), registering AutoMapper mappings once per process before any instance is used.

Constraints and usage notes

• Callers must supply a non-null IUnitOfWork, IUserProfileService, IValidationService, IBillQueryProvider, and IProcedureService; the constructor enforces this via Enforce.ArgumentNotNull.
• UpdateProcedures requires callers to pass back the UpdateNumber they last read; stale values abort the whole batch, not just the conflicting item.

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/Claims/Bills/BillProcedureService.cs