Ordering Flow overview
To achieve this, a high-level overview of the process is defined as:- An order is placed in Junction’s system through our Dashboard or API.
- The order is added to a background queue and additional checks are made before a test requisition is created with the chosen Laboratory.
- After the requisition is created, some form of communication is carried out with the patient so he can book an appointment with our phlebotomy partners.
- At the day of the appointment, our partner phlebotomist will contact the patient directly to assert that everything is correct for carrying out the appointment.
- The phlebotomist goes to the appointment, draws the patient’s blood and then delivers it to the Laboratory.
- The Laboratory processes the patient’s blood sample and generates the required results.
- Junction exposes the results via API as soon as they are available, both on PDF and structured data via API.
Access Notes and Appointment Notes
There are two ways to provide instructions for the phlebotomist:Access Notes
Setaccess_notes on the patient address when creating an order. These describe how to physically reach the patient’s location — gate codes, parking instructions, entrance details, etc. Access notes are automatically forwarded to the phlebotomy provider on every booking and reschedule.
Appointment Notes
Setappointment_notes in the booking, request, or reschedule request body. These are per-appointment special instructions — for example, “Please bring photo ID” or “Patient prefers left arm”. Appointment notes can be changed on each reschedule and are stored on the appointment itself.
Constraints
- Phlebotomy appointments are not supported for patients under 18 years of age.
- The same patient can’t have more than one active appointment with a specific Phlebotomy provider.
- The addresses provided when fetching the appointment availability slots must be reachable by the phlebotomist, containing street number and unit (if exists).
Order and Appointment Lifecycle, Communications and Webhooks.