Validating and submitting orders
Create Order
Bill Type Field Requirements
The following definitions apply to the Field Requirement column:
-
Client Bill (order.bill_type = "C") places the responsibility for reimbursement on the Labcorp client.
-
Patient Bill (order.bill_type = "P") places the responsibility for reimbursement on the patient.
-
Third Party Bill (order.bill_type = "T") places the responsibility for reimbursement on a third party entity (i.e. Medicare, Medicaid, and Private Insurance).
-
'A' - This field is always needed for the specified bill type. Failure to provide these fields may require clarification prior to processing the lab.
-
'D' - This field is desirable but not always needed for the specified bill type.
-
'N/A' - This field is not applicable for the specified bill type.
| Order Field | Description | Client | Patient | Third Party |
|---|---|---|---|---|
| order.patient.external_id | External Patient ID | A | A | A |
| order.patient.last_name | Patient Last Name | A | A | A |
| order.patient.first_name | Patient First Name | A | A | A |
| order.patient.middle_name | Patient Middle Name | D | D | D |
| order.patient.date_of_birth | Patient Date of Birth | A | A | A |
| order.patient.gender | Patient Gender | A | A | A |
| order.patient.address.street_address | Patient Address (Line 1) | A | A | A |
| order.patient.address.city | Patient City | A | A | A |
| order.patient.address.state | Patient State or Province | A | A | A |
| order.patient.address.postal_code | Patient Zip or Postal Code | A | A | A |
| order.patient.phone_number | Patient Phone Number | A | A | A |
| order.patient.email | Communication Address (Patient Email Address) | A | A | A |
| order.account.number | Account Number | A | A | A |
| order.bill_type | Bill Type | A | A | A |
| order.patient.patient_class | Patient Class | A | A | A |
| order.primary_insurance.id | Insurance Company Identification Number | N/A | N/A | D |
| order.secondary_insurance.id | Insurance Company Identification Number - Secondary (a.k.a Secondary Insurance Subscriber Number) | N/A | N/A | D |
| order.primary_insurance.payer_code | Insurance Payer Code | N/A | N/A | D |
| order.secondary_insurance.payer_code | Insurance Payer Code- Secondary | N/A | N/A | D |
| order.primary_insurance.name | Insurance Company Name | N/A | N/A | D |
| order.secondary_insurance.name | Insurance Company Name - Secondary | N/A | N/A | D |
| order.primary_insurance.address.street_address | Insurance Company Address (Line 1) | N/A | N/A | A |
| order.secondary_insurance.address.street_address | Insurance Company Address (Line 1) - Secondary | N/A | N/A | A |
| order.primary_insurance.address.line2 | Insurance Company Address (Line 2) | N/A | N/A | D |
| order.secondary_insurance.address.line2 | Insurance Company Address (Line 2) - Secondary | N/A | N/A | D |
| order.primary_insurance.address.city | Insurance Company City | N/A | N/A | A |
| order.secondary_insurance.address.city | Insurance Company City - Secondary | N/A | N/A | A |
| order.primary_insurance.address.state | Insurance Company State | N/A | N/A | A |
| order.secondary_insurance.address.state | Insurance Company State -Secondary | N/A | N/A | A |
| order.primary_insurance.address.postal_code | Insurance Company Zip Code | N/A | N/A | A |
| order.secondary_insurance.address.postal_code | Insurance Company Zip Code - Secondary | N/A | N/A | A |
| order.primary_insurance.group_number | Group Number of Insured Patient | N/A | N/A | D |
| order.secondary_insurance.group_number | Group Number of Insured Patient - Secondary | N/A | N/A | D |
| order.primary_insurance.employer_name | Insured's Group Employer Name | N/A | N/A | D |
| order.secondary_insurance.employer_name | Insured's Group Employer Name - Secondary | N/A | N/A | D |
| order.primary_insurance.patient_relationship | Insured's Relationship to Patient | N/A | N/A | A |
| order.secondary_insurance.patient_relationship | Insured's Relationship to Patient - Secondary | N/A | N/A | A |
| order.primary_insurance.workers_comp | Type of Agreement (Worker's Compensation Flag) | N/A | N/A | A |
| order.primary_insurance.policy_number | Policy Number (Insurance Number/Subscriber Number/Member ID) | N/A | N/A | A |
| order.secondary_insurance.policy_number | Policy Number (Insurance Number/Subscriber Number/Member ID) - Secondary | N/A | N/A | A |
| order.guarantor.last_name | Guarantor Last Name | A | A | A |
| order.guarantor.first_name | Guarantor First Name | A | A | A |
| order.guarantor.address.street_address | Guarantor Address (Line 1) | A | A | A |
| order.guarantor.address.city | Guarantor City | A | A | A |
| order.guarantor.address.state | Guarantor State | A | A | A |
| order.guarantor.address.postal_code | Guarantor Zip Code | A | A | A |
| order.guarantor.phone_number | Guarantor Phone Number | A | A | A |
| order.guarantor.patient_relationship | Guarantor Relationship to Patient | A | A | A |
| order.guarantor.employer_name | Guarantor's Employer Name | N/A | D | D |
| order.guarantor.charge_adjustment_code | Guarantor Charge Adjustment Code | N/A | N/A | D |
| order.guarantor.household_annual_income | Guarantor Household Annual Income | D | D | D |
| order.guarantor.household_size | Guarantor Household Size | D | D | D |
| order.diagnoses[0].code | Diagnosis Code Identifier | D | D | A |
| order.diagnoses[0].description | Diagnosis Code Text Description | D | D | D |
| order.ordering_provider.id.npi order.authorizing_provider.id.npi | Ordering Provider ID Number (NPI number is expected) | A | A | A |
| order.ordering_provider.last_name order.authorizing_provider.last_name | Ordering Provider Last Name | A | A | A |
| order.ordering_provider.first_name order.authorizing_provider.first_name | Ordering Provider First Initial or Name | A | A | A |
Create Order › Request Body
Account information of the calling system placing the order.
The patient information for whom the labs are being ordered.
Information identifying the Guarantor.
sending_applicationTo identify vendor for routing purposes through LCS. Assigned by Labcorp and used for translation. This field must match the assigned Vendor Mnemonic.
- No control or whitespace characters except space
- ampersands
- backslashes (\)
- carets (^)
- pipes (|)
- or any byte value > 0x7d
receiving_applicationTo identify the Labcorp System receiving the orders. More could be added in the future.
- No control or whitespace characters except space
- ampersands
- backslashes (\)
- carets (^)
- pipes (|)
- or any byte value > 0x7d
sending_facilityThe sending facility. This field must match the Client Site ID (CSID).
- No control or whitespace characters except space
- ampersands
- backslashes (\)
- carets (^)
- pipes (|)
- or any byte value > 0x7d
receiving_facilityUsed for routing through the Labcorp system.
- No control or whitespace characters except space
- ampersands
- backslashes (\)
- carets (^)
- pipes (|)
- or any byte value > 0x7d
control_idThe message identifier.
- No control or whitespace characters except space
- ampersands
- backslashes (\)
- carets (^)
- pipes (|)
- or any byte value > 0x7d
bill_typeUsed to determine responsible "Bill to" party.
Bill Types:
C- ClientP- PatientT- Third Party
An array of specimens that will be sent to Labcorp for testing.
The authorizing provider field may be used for, but is not limited to, cases where an ordering provider does not have sufficient authority to submit the order. The authorizing provider must supply an NPI ID and may optionally include the following types of ID: UPIN, Local ID, Provider Number.
Information about the Next of Kin if the patient is < 17 years old.
Primary insurance to used for billing.
Secondary insurance used for billing.
Used when a courtesy copy of the report is requested.
Used to set the priority of the Order
Create Order › Responses
The order was accepted and processed. Requisitions are returned in the response; delivery to Labcorp continues asynchronously.
workflowIdA server generated unique ID for the order workflow also serves as the ID for the original order.
A dictionary consisting of unique source order IDs as keys and the corresponding requisition data as values.
An array of validation issues that were found, but which did not stop processing of the Order.
Optional array of notifications.
Validate Order
Validate Order › Request Body
Account information of the calling system placing the order.
The patient information for whom the labs are being ordered.
Information identifying the Guarantor.
sending_applicationTo identify vendor for routing purposes through LCS. Assigned by Labcorp and used for translation. This field must match the assigned Vendor Mnemonic.
receiving_applicationTo identify the Labcorp System receiving the orders. More could be added in the future.
sending_facilityThe sending facility.
receiving_facilityUsed for routing through the Labcorp system.
control_idThe message identifier.
bill_typeUsed to determine responsible "Bill to" party.
Bill Types:
C- ClientP- PatientT- Third Party
An array of specimens that will be sent to Labcorp for testing.
The authorizing provider field may be used for, but is not limited to, cases where an ordering provider does not have sufficient authority to submit the order. The authorizing provider must supply an NPI ID and may optionally include the following types of ID: UPIN, Local ID, Provider Number.
Information about the Next of Kin if the patient is < 17 years old.
Primary insurance to used for billing.
Secondary insurance used for billing.
Used when a courtesy copy of the report is requested.
Used to set the priority of the Order
Validate Order › Responses
Successfully processed order validation request.
The Order that was provided.
An array of validation issues that were found. The array is empty if there are no validation issues found.