Add Test to Bill

This operation appends tests from an inbound HL7 order to an existing active bill. It is handled synchronously inside hl7/2_3/createOrder/.

When This Flow Runs

All conditions must be true:

• orderNumber is present.
• An active bill exists for the same lab and order number, or for the numeric labBillId equivalent of the order number.
• addTestToBill = 1.
• uniqueOrderNo = 0.
• testList contains at least one test.

If testList is empty, the router returns 400 Invalid Test codes.

Implementation Path

Configuration

Test Selection

The router collects testCode values from the inbound testList and fetches active allTests records for the lab.

For each resolved test:

• The test is skipped when it already exists on the bill, unless add_duplicate_test = 1.
• The test amount comes from the organization price list when orgPriceList = 1 and a list price is available.
• Otherwise, the master test amount is used.
• report_level_tags from the inbound test item is preserved.

Internal Add-Test Request

The router creates an internal request object for bill_add_test_third_party.

Each resolved test item includes Crelio test fields such as testId, testName, isProfile, testAmount, sampleId, testQuantity, outsource fields, and report_level_tags.

Side Effects

After the add-test controller completes, the router:

• Saves AOE values using create_question_values_from_aoe_data.
• Writes an activity log in category 194.
• Returns a successful response even if no new tests were eligible because all inbound tests already existed on the bill.

Responses

When at least one test is added:

{
  "status": 200,
  "Message": "[Add Tests to Bill] Tests <test names> have been added to Bill(ID: <labBillId>) for Patient <name> (ID: <patientId>) through HL7 integration"
}

When the inbound tests are duplicates and no new test is added:

{
  "status": 200,
  "Message": "No new tests were added to the existing Bill(ID: <labBillId>) for Patient <name> (ID: <patientId>)"
}

Common Issues