USCDIv3 Validator Requirements - Medication

[Ramnish R]

Hi, 

I am currently using https://site.healthit.gov/c-cda/uscdi-v3 to validate my C-CDA Medication section. I have been following https://hl7.org/ccdasearch/templates/2.16.840.1.113883.10.20.22.4.18.html and https://hl7.org/ccdasearch/pdfs/2.16.840.1.113883.10.20.22.4.18.pdf example to implement the section. I have got the validator error saying the Dispense section V4 is missing the "code" value. 

Example from the implementation guide PDF

<<

<!-- Medication Dispense Status -->
<code code="in-progress" codeSystem="2.16.840.1.113883.4.642.4.1971"
codeSystemName="medicationdispense-status" displayName="In Progress"/>

>>

As per one of the previous posts, the codeSystem has to be 2.16.840.1.113883.4.642.4.1313. 

• Which implementation guide (and c-cda version) must I refer for the USCDIv3 validator?
• Is  2.16.840.1.113883.4.642.4.1313 the correct valueset for supply.code? Shouldn't it be  2.16.840.1.113883.4.642.4.1971?

Thank you in advance.

-

Ramnish R

[Arslan Iqbal]

Thanks for this submission, our team will review this. (Internal ticket only for our reference: SITE-4658)

-SITE/ETT team

[Vishal Patel]

Hi team,
any updates on this thread?

[Mat Davis]

REPOSTED DUE TO FORMATTING ISSUE

Hi Ramnish and Vish, a few things here:

1 - Much appreciated for the level of details and links you provided Ramnish - I think a few things are being mixed up here.

2 - Answers to your questions:

2.1 - "Which implementation guide (and c-cda version) must I refer for the USCDIv3 validator?"
2.1.1 - The same one your PDF link points to

2.1.2 - Sometimes, there are updates that exist in the PDF link that weren't applied to the HTML link and possibly, vice versa.
PDF -  https://hl7.org/ccdasearch/pdfs/2.16.840.1.113883.10.20.22.4.18.pdf
HTML - https://hl7.org/ccdasearch/templates/2.16.840.1.113883.10.20.22.4.18.html

2.1.3 - If you scroll to the very bottom in the PDF link, it displays the important details:
• Valueset OID -  2.16.840.1.113883.4.642.3.1312
• Valueset Link - http://hl7.org/fhir/R4/valueset-medicationdispense-status.html
• CodeSystem OID -  2.16.840.1.113883.4.64 2.4.1313


2.2 - "Is  2.16.840.1.113883.4.642.4.1313 the correct valueset for supply.code?"
2.2.1 - Not in this case
2.2.2 - ...1313 = the CodeSystem, not the valueset
2.2.3 - ...1312 = the valueset
2.2.4 - According to the same PDF link you posted, ...1312 is the correct valueset for Medication Dispense ( 2.16.840.1.113883.10.20.22.4.18 ) > code

2.3 - "Shouldn't it be  2.16.840.1.113883.4.642.4.1971?"
2.3.1 - I'm curious what makes you think ...1971 should be the target here --- Maybe you did a generic google search?
2.3.2 - I looked up ...1971 --- https://build.fhir.org/codesystem-medicationdispense-status.html
• it's only been active as of 11-27-2025
• the version says 6.0.0-ballot which makes me think FHIR R6 and that it's not targetted for this use USCDIv3 case
2.3.3 - Meanwhile, the valueset link in the PDF link you posted
• Points to FHIR R4 -  http://hl7.org/fhir/R4/valueset-medicationdispense-status.html
• Has a generated date of 01 Nov 2019
• Displays the valueset OID = 2.16.840.1.113883.4.642.3.1312

Outside of this convo, C-CDA vs FHIR Medication Dispense is a very interesting deep dive but I opted not to go down that rabbit hole and other rabbit holes on this specific conversation.

Hope this helps.

Thanks - Mat

On Friday, November 28, 2025 at 5:44:56 PM UTC-6 Mat Davis wrote:

Hi Ramnish and Vish, a few things here:

1. Much appreciated for the level of details and links you provided Ramnish - I think a few things are being mixed up here.
   
   
2. Answers to your questions:
   
   

1. 1. Which implementation guide (and c-cda version) must I refer for the USCDIv3 validator?

1. 1. 1. The same one your PDF link points to
         
         
      2. Sometimes, there are updates that exist in the PDF link that weren't applied to the HTML link and possibly, vice versa.
         1. PDF -  https://hl7.org/ccdasearch/pdfs/2.16.840.1.113883.10.20.22.4.18.pdf
         2. HTML - https://hl7.org/ccdasearch/templates/2.16.840.1.113883.10.20.22.4.18.html
            
            
      3. If you scroll to the very bottom in the PDF link, it displays the important details:
         1. Valueset OID -  2.16.840.1.113883.4.642.3.1312
         2. Valueset Link - http://hl7.org/fhir/R4/valueset-medicationdispense-status.html
         3. CodeSystem OID -  2.16.840.1.113883.4.64 2.4.1313
            
            
            

1. 1. Is  2.16.840.1.113883.4.642.4.1313 the correct valueset for supply.code?

1. 1. 1. Not in this case
      2. ...1313 = the CodeSystem, not the valueset
      3. ...1312 = the valueset
      4. According to the same PDF link you posted, ...1312 is the correct valueset for Medication Dispense ( 2.16.840.1.113883.10.20.22.4.18 ) > code
         
         

1. 1. Shouldn't it be  2.16.840.1.113883.4.642.4.1971?

1. 1. 1. I'm curious what makes you think ...1971 should be the target here --- Maybe you did a generic google search?
      2. I looked up ...1971 --- https://build.fhir.org/codesystem-medicationdispense-status.html
         1. it's only been active as of 11-27-2025
         2. the version says 6.0.0-ballot which makes me think FHIR R6 and that it's not targetted for this use case
      3. Meanwhile, the valueset link in the PDF link you posted 
         1. Points to FHIR R4 -  http://hl7.org/fhir/R4/valueset-medicationdispense-status.html
         2. Has a generated date of 01 Nov 2019
         3. Displays the valueset OID = 2.16.840.1.113883.4.642.3.1312

Outside of this convo, C-CDA vs FHIR Medication Dispense is a very interesting deep dive but I opted not to go down that rabbit hole and other rabbit holes on this specific conversation.

Hope this helps.

Thanks - Mat