Planned Procedure Error

315 views
Skip to first unread message

greg....@gmail.com

unread,
Mar 19, 2025, 12:01:06 PMMar 19
to Edge Test Tool (ETT)
Hello,

We are receiving what seems to be an erroneous error for the b1 Ambulatory scenario 1 USCDI v3 validation. The error states "Result Description: The scenario requires Planned Procedure data but the submitted C-CDA does not contain Planned Procedure data" but as you can see in the screenshot below (and in the attached XML) we do have a planned procedure entry that (to my eye) aligns directly with the Companion Guide 4.1 specifications.

image_720.png

Can you confirm for us whether this is an erroneous error? If not, is there something I'm not seeing that is resulting in our entry not being identified as missing a planned procedure?
Newman2.xml

Kim Poletti

unread,
Mar 19, 2025, 12:33:54 PMMar 19
to Edge Test Tool (ETT)
Hi - Thanks for reaching out. This has been logged for review and a member of the team will reach out in the near future.

greg....@gmail.com

unread,
Apr 3, 2025, 2:40:38 PMApr 3
to Edge Test Tool (ETT)
Any updates on this investigation?

Arslan Iqbal

unread,
Apr 3, 2025, 5:18:56 PMApr 3
to Edge Test Tool (ETT)
SITE/ETT team's internal reference SITE-4555

greg....@gmail.com

unread,
Apr 16, 2025, 11:51:11 AMApr 16
to Edge Test Tool (ETT)
I created an account at the Jira site but it tells me I am unable to view the issue - it has either been deleted or I do not have permissions. Can you let me know where this one stands?

Kim Poletti

unread,
Apr 17, 2025, 11:52:13 AMApr 17
to Edge Test Tool (ETT)
Hi Greg,

The ticket number is only for internal reference. The team is still investigating the issue.

Thanks,
Kim

Ivan Quan

unread,
May 7, 2025, 12:04:46 PMMay 7
to Edge Test Tool (ETT)
Hello,

We also have this exact issue as describe by Greg. Is there an update on this?

Thanks,
Ivan

Kyle Meadors

unread,
May 7, 2025, 12:31:27 PMMay 7
to Ivan Quan, Greg Thole, Edge Test Tool (ETT)
The issue is that you are inserting the Planned Procedure in the Procedures component section (<templateId root = "2.16.840.1.113883.10.20.22.2.7.1"/>) but it should be in the Treatment Plan (<templateId root = "2.16.840.1.113883.10.20.22.2.10"/>) section. That is because it is "planned" as in it will happen in the patient's future so it goes into Treatment Plan. If it was a completed SDOH intervention that has already occurred, it would go in the Procedures component section but as a Procedure Activity Procedure (<templateId root = "2.16.840.1.113883.10.20.22.4.14"/>).


--
You received this message because you are subscribed to the Google Groups "Edge Test Tool (ETT)" group.
To unsubscribe from this group and stop receiving emails from it, send an email to edge-test-too...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/edge-test-tool/882be04d-9041-4aa8-8791-a99677d34856n%40googlegroups.com.


--
Kyle Meadors
@kylemeadors

greg....@gmail.com

unread,
May 12, 2025, 3:37:34 PMMay 12
to Edge Test Tool (ETT)
Kyle,

Thank you for the information. Can you clarify where specifically in the CG 4.1 this is referenced (you mention 2 different spots). We found that the online published C-CDA 3.0 guide does reference it on the usage parameters here but could not find any such specification in the authoritative 4.1 CG.

Kyle Meadors

unread,
May 12, 2025, 3:43:12 PMMay 12
to greg....@gmail.com, Edge Test Tool (ETT)
It is section 6.2.13 of the 4.1 Companion Guide - page 199 of the PDF. I've attached it here. The two spots are in that section - one addressing planned interventions and the other addressing completed interventions. 



--
Kyle Meadors
@kylemeadors

CCDA_Companion_4.1_Pg199.pdf

Greg Thole

unread,
May 12, 2025, 3:48:17 PMMay 12
to Kyle Meadors, Edge Test Tool (ETT)
Thanks, Kyle. 

I see that the referenced section specifies that planned interventions must be represented with the Planned Procedure entry template (which our example aligns with) but am not seeing where it specifies that such entries cannot be populated in the Procedures section template. Apologies in advance here if I'm just completely missing it somehow.

Kyle Meadors

unread,
May 12, 2025, 4:19:11 PMMay 12
to Greg Thole, Edge Test Tool (ETT)
There are a few places in the main CCDA 2.1 IG spec that indicate that the right location for is Plan of Treatment. First, the Plan of Treatment section indicates that Planned Procedure can be contained in it (https://www.hl7.org/ccdasearch/templates/2.16.840.1.113883.10.20.22.2.10.html).

Conversely, the Procedure Section (https://www.hl7.org/ccdasearch/templates/2.16.840.1.113883.10.20.22.2.7.1.html) does not list Planned Procedure as an entry section is would contain (just Procedure Activity Procedure, Procedure Activity Act, Procedure Activity Observation).

As well, the section is described as containing "describes all interventional, surgical, diagnostic, or therapeutic procedures or treatments pertinent to the patient historically at the time" so that also indicates you would not expect to find future procedures in this section but only historical. The LOINC code for this Procedures Component section is officially named "History of Procedures" further showing it is in the past and not the future. 

Both of those are taken from the main CCDA 2.1 IG. The Companion Guide provides some further direction on mapping, but it is combined with the main CCDA IG for interoperability purposes of CCDA mapping. 
--
Kyle Meadors
@kylemeadors

greg....@gmail.com

unread,
May 15, 2025, 10:31:06 AMMay 15
to Edge Test Tool (ETT)
Thanks for the additional information, Kyle. That all makes sense and we've made a change to remove Planned Procedure entries from Procedures section.

However, for the Referral Note document template we were putting the Planned Procedure in the Assessment and Plan section as the R2.1 IG specifies that the document must include either (1) the Assessment and Plan section or (2) both the Assessment section and the Plan of Treatment section. We expected that this would be allowed since Assessment and Plan is effectively an equivalent of Plan of Treatment for those purposes, but that is still rendering the same error. While Plan of Treatment is specified as best practice/intended source of the Planned procedure entry, we're not seeing anything that would explicitly disallow substituting it in the Assessment and Plan section given the R2.1 IG requirements around those sections. Can a change be made to allow for Planned Procedure entries in the Assessment and Plan section, as well?

Thank you

greg....@gmail.com

unread,
May 19, 2025, 9:56:24 AMMay 19
to Edge Test Tool (ETT)
Good morning, Kyle. Just following up on the outstanding question here to start the week. TIA!

br...@waveoneassociates.com

unread,
May 19, 2025, 10:46:57 AMMay 19
to Edge Test Tool (ETT)
Please post an updated example, and confirm the scenario you are testing.

If you have screen shot of error, that may help SITE team. 

Best
Brett 

Kyle Meadors

unread,
May 19, 2025, 3:56:30 PMMay 19
to greg....@gmail.com, Edge Test Tool (ETT)
Hey Greg. First, let me clarify that I am neither with ONC nor the SITE test tool team, so I can't speak authoritatively on this matter. I am just one of many implementers.

But I have been around a bit, currently as an EHR regulatory consultant with Chart Lux and prior to that EHR Testing Director at Drummond Group so I have been dealing with CCDAs and CCDA interoperability for 15 years now, which is why I'm active on this list and offering comments to assist but also to still learn. 

One thing with the CCDA specification is that it is very flexible, due largely to it being an "open template" design where we can add additional sections at places and also having options to place data in different locations. But that can hinder interoperability which is why the original CCDA Companion Guide came out back with the 2014 Edition FR release when it was simply "best practice" suggestions and not official compliance requirements. Since then, ONC has turned the Companion Guide into a requirement along with the main CCDA IG, and the CCDA IG vs 3.0 fully merges the core IG with the Companion Guide requirements because of how important interoperability is.

All that to say, even if you could insert the Planned Procedure in the Assessment and Plan section per the flexibility in the main CCDA IG, I can understand if it is rejected by ONC/SITE test tool because of an interoperability concern as I don't think the combined component section is the "common" method of implementation. 

But, the tool is not absolute and it can be changed, and that is why we present questions like yours here. Looking the specification, I would agree with you that Planned Procedure could be in the Assessment and Plan section (2.16.840.1.113883.10.20.22.2.9:2014-06-09), and given the HL7 authors have kept both combined or separate options available, I think the tool should accept the Planned Procedure (2.16.840.1.113883.10.20.22.4.41:2022-06-01) in either of those component sections. But the test tool team and any ONC liaisons would need to weigh in on this. They may have better reasons for not doing that. 

Finally, to Brett's recent email, and this is for everyone posting questions here, always include your CCDA that is creating the error in the email in question , if possible. Debugging or even analyzing CCDA questions is something of a dark art as much as science, and seeing the specimen at hand greatly helps make for a better response. 

Kyle



--
Kyle Meadors
@kylemeadors

greg....@gmail.com

unread,
May 20, 2025, 5:50:47 PMMay 20
to Edge Test Tool (ETT)
Hey Brett,

Apologies for the delay, missed this message in the thread. To clarify, the specific updated scenario we're testing is populating the Planned Procedure template in the Assessment and Plan section for SDOH Interventions when using the Referral Note doc template. Our expectation was that this would be allowed since C-CDA R2.1 IG allows for the Referral Note to use either (1) Assessment and Plan or (2) Assessment + Plan of Treatment. I've attached the example C-CDA and below is the error message of concern - indicates Planned Procedure data is not included, which we believe is because the validator is exclusively looking for it in Plan of Treatment section.

Error for Planned Procedure:
Result DescriptionThe scenario requires Planned Procedure data but the submitted C-CDA does not contain Planned Procedure data.

CCDReferralNotesA&PWithPlannedProcedures (1).xml

br...@waveoneassociates.com

unread,
May 20, 2025, 5:59:51 PMMay 20
to Edge Test Tool (ETT)
Please confirm the Validation Criteria and the Scenario file

I can infer based on the start of this chain, but want to make sure i am testing exactly the same way you are!

Greg Thole

unread,
May 20, 2025, 6:02:42 PMMay 20
to br...@waveoneassociates.com, Edge Test Tool (ETT)
My bad, Brett. Criterion is 170.315_b1_ToC_Amb and the scenario file is Amb sample 1 (Alice Newman).

image.png

You received this message because you are subscribed to a topic in the Google Groups "Edge Test Tool (ETT)" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/edge-test-tool/tgBkheSpKr8/unsubscribe.
To unsubscribe from this group and all its topics, send an email to edge-test-too...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/edge-test-tool/20beec8f-5541-4f42-a418-2ca26888acf3n%40googlegroups.com.

br...@waveoneassociates.com

unread,
May 20, 2025, 6:18:27 PMMay 20
to Edge Test Tool (ETT)
No problem, I can recreate now, and see your error!

- Are you working through the other errors? 
- Have you considered the section.text?

The section.text currently only includes urine dipstick, and no other contained entries.

My initial reaction (which isn't always correct!) is you should be allowed to include the SDOH in the A&P section as you have suggested. Let me check with SITE team if the rigidness is for a reason I am not recalling.

Best
Brett  

Greg Thole

unread,
May 20, 2025, 10:15:33 PMMay 20
to br...@waveoneassociates.com, Edge Test Tool (ETT)
Thanks, Brett!

We are working through the other errors. The vast majority are related to provenance (time stamps and author names) that we will be requesting test data change approvals on with our ATL and we have code changes in progress that we expect to remedy the remainder. We also have updates in progress for the narrative text, just isn't reflected in this example. Full disclosure - we just manually manipulated that sample to move the Planned Procedure entry into A&P and test how the validator responded before finalizing designs for code changes. 

Anyway, glad to hear your initial reaction aligns with our thinking. Look forward to hearing what the SITE team has to say.

Thanks again!

Dan Brown SITE

unread,
Jun 4, 2025, 3:58:14 PMJun 4
to Edge Test Tool (ETT)
Hi Greg,

We have analyzed and we agree with Brett. You should be allowed to include the SDOH in the A&P section. We will look to update the content validator as such so that it is not so strict. Unfortunately, we can't give you a specific timeline for the update as there are many competing priorities.

greg....@gmail.com

unread,
Jun 5, 2025, 12:11:52 AMJun 5
to Edge Test Tool (ETT)
Thanks for confirming, Dan. We will keep an eye out for the update. Out of curiosity, is there a planned upcoming release with other changes/corrections that we can expect?

Dan Brown SITE

unread,
Jun 5, 2025, 5:21:13 PMJun 5
to Edge Test Tool (ETT)
We typically release on the last Monday of each month. It's certainly possible that the fix will be included then. It's also possible we will do an additional release in between this month. It is less likely a fix for this will be included if that happens, though.

James Spillman

unread,
Jun 30, 2025, 12:09:23 PMJun 30
to Edge Test Tool (ETT)
A fix for this has been deployed. Can you retest?
Message has been deleted

greg....@gmail.com

unread,
Jul 8, 2025, 11:02:59 AMJul 8
to Edge Test Tool (ETT)
Apologies for the delay as I'm just returning from parental leave today. I checked with my colleagues and they did successfully test the deployed update. Thank you very much for the engagement on this item!
Reply all
Reply to author
Forward
0 new messages