How to test labs in the Fullscript sandbox

Use this step-by-step guide to simulate the lab ordering flow within your EHR integration. This ensures your integration handles lab purchases, status transitions, and webhook behavior correctly.

1. Navigate to: https://us-snd.fullscript.io/login

2. Log in or create a test practitioner account

   • Sign up as a practitioner on Fullscript if you haven’t already. You must enter license information to proceed with lab orders.

3. Add your NPI number (if you skipped it during onboarding)

   • Navigate to Settings → Account → Basic info
   • Click Edit license information
   • Enter the test NPI number: 1111111111
   • Click Save license information

4. Navigate to Labs

   • Go to Catalog → Labs
   • You will see the Register for labs button.

   Note: If the Register for labs button is greyed out, hover over it to view the tooltip. It will explain what's missing and include a hyperlink to the relevant page to enter your info.

5. Complete the lab registration process

   • Click the Register for labs button.
   • Re-enter your first and last name (NPI should be pre-filled)
   • Leave license info blank (optional)
   • Click the Next button.

6. Agree to the legal documents

   • Review and agree to Fullscript Labs' Terms of Service. Click the Next button.
   • Review and electronically sign the BAA. Click the Submit button.
   • Agree to the authorization network. Click the Done button.

7. Create and send a lab treatment plan

   • Go to Patients, then create a new test patient (if needed).
   • Create a treatment plan for that patient.
   • Add one or more labs from the Labs catalog.
   • Send the treatment plan to the patient.

8. Log in as the test patient and order the lab

   • Log in using the test patient’s email
   • Go to My Health → Plans to view the recommended labs
   • Complete any required personal information if prompted
   • Add the lab(s) to the cart and proceed to checkout

9. Use the sandbox test payment method

   • Card number: 4242 4242 4242 4242
   • Expiration: any future date
   • CVC: any 3 digits
   • Click Place your order

EHR status confirmation

After a lab order is placed, you may observe several status transitions depending on how your system is configured. The following intermediate statuses are optional to surface in your EHR, but are available for testing:

• purchased – Indicates the patient has successfully purchased the lab.
• schedule_appointment – Appears when the lab requires the patient to book an appointment (e.g., for phlebotomy).
• upcoming_appointment – Indicates that the appointment has been scheduled by the patient.
• results_ready – All results have been received and are available for the practitioner. (Note: This must be manually triggered by Fullscript in sandbox—see below.)
• interpretation_shared – Indicates that the results have been shared with the patient.
  • If the practitioner has “Automatically share Quest Diagnostics results” enabled under Settings → Labs, the status will automatically transition from results_ready to interpretation_shared once all results are available.
  • If this setting is disabled, the lab order will remain in results_ready until the practitioner manually chooses to share the results from within Fullscript. Only then will the status update to interpretation_shared.

Simulating results_ready status

To test the delivery of lab results and trigger the lab_order.updated webhook:

1. Complete the lab order flow in sandbox.
2. Email/Slack us the following:
   • Practitioner name
   • Test patient name
3. Fullscript will push a test result file to your EHR.
4. You should then receive the lab_order.updated webhook with the results_ready status.