Ordering a Registrable Testkit

Use registrable testkits to ship kits without a bound patient, deferring patient registration until the testkit is activated.

Under the standard Testkit ordering flow, you place a Testkit order for a specific patient. The resulting Testkit is bound to that patient, and the Testkit cannot be passed on to someone else.

With Registrable Testkits, Junction offers a different option — Testkits not bound to any specific patient can be ordered to a specific household address. The patient registration process is deferred until an actual patient intends to use the Testkit.

Note that this only applies to Testkits, not Walk-in Tests or At-home Phlebotomy.

This involves two steps:

1. Ordering the Testkit.
2. Registering a patient.

After step 1, the order is sent to the requested address and generates all the same webhooks as a regular order would. However, it is stuck in the received.testkit.awaiting_registration state, meaning that no requisition form is generated for this order, and no results can be obtained until step 2 is done.

After step 2, the order flow resumes as normal, the patient sends the testkit to the lab, the order is progressed to the received.testkit.testkit_registered state and, again, all the same webhooks as in the regular order flow are dispatched.

Example

To make an order, make a request to our POST /v3/order/testkit, to fulfill step 1.

Python

from vital import Client

client = Client(api_key, "sandbox")

data = client.LabTests.create_unregistered_testkit_order(
  user_id="63661a2b-2bb3-4125-bb1a-b590f64f057f",
  lab_test_id="5b41f610-ebc5-4803-8f0c-a61c3bdc7faf",
  shipping_details={
    "receiver_name": "John Doe",
    "street": "123 Main St.",
    "street_number": "Apt. 208",
    "city": "San Francisco",
    "state": "CA",
    "zip": "91189",
    "country": "US",
    "phone_number": "[phone]"
  }
)

The testkit is now ordered, and will be sent to the specified address. Once delivered, it can be kept until its expiration.

Once the testkit is with its intended patient, it should be registered (step 2).

In order to register, Junction requires a sample_id, which is found within the testkit itself. This is a unique identifier. Junction also requires the patient details and address. Besides this, if using Junction’s physician network, then supplying the consents field is required. If providing your own physician, then the physician information is required.

For this example, we will assume the use of your own physician.

To register a testkit order, make a request to our POST /v3/order/testkit/register, to fulfill step 2.

Python

client = Client(api_key, "sandbox")

data = client.LabTests.register_testkit_order(
  user_id="63661a2b-2bb3-4125-bb1a-b590f64f057f",
  sample_id="123123123",
  patient_details={
    "first_name": "John",
    "last_name": "Doe",
    "dob": "2020-01-01",
    "gender": "male",
    "phone_number": "[phone]",
    "email": "[e-mail]"
  },
  patient_address={
    "receiver_name": "John Doe",
    "street": "123 Main St.",
    "street_number": "Apt. 208",
    "city": "San Francisco",
    "state": "CA",
    "zip": "91189",
    "country": "US"
  },
  physician={
    "first_name": "Doctor",
    "last_name": "Doc",
    "npi": "123123123"
  }
)

Your testkit order is now registered, and the order flow should resume as normal. For more information regarding the lifecycle of a test, refer to the lab test lifecycle page.