diff --git a/assets/data-integration/care_team.csv b/assets/data-integration/care_team.csv index 434f08f..fdefe7d 100644 --- a/assets/data-integration/care_team.csv +++ b/assets/data-integration/care_team.csv @@ -1,4 +1,4 @@ -record_id,patient_identifier,member_npi,member_related_person_id,role_code,status,source_system,last_updated,author_org_npi,is_deleted -CT-0001,MRN-4471903,1407006835,,223366009,active,,2026-08-19T02:00:00-04:00,, -CT-0002,MRN-4471903,,RP-3310,223366009,active,,2026-08-19T02:00:00-04:00,, -CT-0003,MRN-7782200,1932108107,,223366009,inactive,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,member_npi,member_related_person_id,role_code,status,source_system,last_updated,author_org_npi,is_deleted +CT-0001,MRN-4471903,1999999992,,223366009,active,,2026-08-19T02:00:00-04:00,, +CT-0002,MRN-4471903,,RP-3310,223366009,active,,2026-08-19T02:00:00-04:00,, +CT-0003,MRN-7782200,1888888884,,223366009,inactive,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/documents.csv b/assets/data-integration/documents.csv index 8f52e28..a459db7 100644 --- a/assets/data-integration/documents.csv +++ b/assets/data-integration/documents.csv @@ -1,4 +1,4 @@ -record_id,patient_identifier,type_code,attachment_file,record_id,document_date,author_npi,encounter_id,source_system,last_updated,author_org_npi,is_deleted -DOC-0001,MRN-4471903,11488-4,attachments/DOC-0001.pdf,DOC-0001,2026-04-18T10:00:00-04:00,1407006835,ENC-9912,,2026-08-19T02:00:00-04:00,, -DOC-0002,MRN-7782200,18842-5,attachments/DOC-0002.pdf,DOC-0002,2026-02-06T11:30:00-05:00,1407006835,ENC-9913,,2026-08-19T02:00:00-04:00,, -DOC-0003,MRN-5510042,11506-3,attachments/DOC-0003.pdf,DOC-0003,2026-01-09T15:05:00-05:00,,,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,type_code,attachment_file,record_id,document_date,author_npi,encounter_id,source_system,last_updated,author_org_npi,is_deleted +DOC-0001,MRN-4471903,11488-4,attachments/DOC-0001.pdf,DOC-0001,2026-04-18T10:00:00-04:00,1999999992,ENC-9912,,2026-08-19T02:00:00-04:00,, +DOC-0002,MRN-7782200,18842-5,attachments/DOC-0002.pdf,DOC-0002,2026-02-06T11:30:00-05:00,1999999992,ENC-9913,,2026-08-19T02:00:00-04:00,, +DOC-0003,MRN-5510042,11506-3,attachments/DOC-0003.pdf,DOC-0003,2026-01-09T15:05:00-05:00,,,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/encounters.csv b/assets/data-integration/encounters.csv index 9d41297..ffc8548 100644 --- a/assets/data-integration/encounters.csv +++ b/assets/data-integration/encounters.csv @@ -1,5 +1,5 @@ -record_id,encounter_id,encounter_id_system,patient_identifier,status,class,type_code,type_system,period_start,period_end,reason_code,reason_system,location_id,diagnosis_condition_id,participant_npi,participant_type_code,participant_type_system,discharge_disposition_code,discharge_disposition_system,service_provider_npi,source_system,last_updated,author_org_npi,is_deleted -ENC-9912,ENC-9912,urn:oid:2.16.840.1.113883.3.99.2,MRN-4471903,finished,AMB,99213,,2026-04-18T09:00:00-04:00,2026-04-18T09:30:00-04:00,29857009,,LOC-221,,1407006835,ATND,,,,1234567893,,2026-08-19T02:00:00-04:00,, -ENC-9913,ENC-9913,urn:oid:2.16.840.1.113883.3.99.2,MRN-7782200,finished,IMP,99213,,2026-02-01T14:00:00-05:00,2026-02-06T11:00:00-05:00,,,,CND-4501,1407006835,ADM,,01,http://www.nubc.org/patient-discharge,1234567893,,2026-08-19T02:00:00-04:00,, -ENC-9914,ENC-9914,urn:oid:2.16.840.1.113883.3.99.2,MRN-3391077,finished,EMER,99213,,2026-05-20T22:10:00-04:00,2026-05-21T02:40:00-04:00,29857009,,,,,,,,,,,2026-08-19T02:00:00-04:00,, -ENC-9915,ENC-9915,urn:oid:2.16.840.1.113883.3.99.2,MRN-5510042,cancelled,AMB,99213,,,,,,,,,,,,,,,2026-08-19T02:00:00-04:00,, +record_id,encounter_id,encounter_id_system,patient_identifier,status,class,type_code,type_system,period_start,period_end,reason_code,reason_system,location_id,diagnosis_condition_id,participant_npi,participant_type_code,participant_type_system,discharge_disposition_code,discharge_disposition_system,service_provider_npi,source_system,last_updated,author_org_npi,is_deleted +ENC-9912,ENC-9912,urn:oid:2.16.840.1.113883.3.99.2,MRN-4471903,finished,AMB,99213,,2026-04-18T09:00:00-04:00,2026-04-18T09:30:00-04:00,29857009,,LOC-221,,1999999992,ATND,,,,1234567893,,2026-08-19T02:00:00-04:00,, +ENC-9913,ENC-9913,urn:oid:2.16.840.1.113883.3.99.2,MRN-7782200,finished,IMP,99213,,2026-02-01T14:00:00-05:00,2026-02-06T11:00:00-05:00,,,,CND-4501,1999999992,ADM,,01,http://www.nubc.org/patient-discharge,1234567893,,2026-08-19T02:00:00-04:00,, +ENC-9914,ENC-9914,urn:oid:2.16.840.1.113883.3.99.2,MRN-3391077,finished,EMER,99213,,2026-05-20T22:10:00-04:00,2026-05-21T02:40:00-04:00,29857009,,,,,,,,,,,2026-08-19T02:00:00-04:00,, +ENC-9915,ENC-9915,urn:oid:2.16.840.1.113883.3.99.2,MRN-5510042,cancelled,AMB,99213,,,,,,,,,,,,,,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/immunizations.csv b/assets/data-integration/immunizations.csv index e0835bf..53c966e 100644 --- a/assets/data-integration/immunizations.csv +++ b/assets/data-integration/immunizations.csv @@ -1,4 +1,4 @@ -record_id,patient_identifier,status,status_reason_code,status_reason_system,vaccine_code,vaccine_system,occurrence_date,performer_npi,primary_source,source_system,last_updated,author_org_npi,is_deleted -IM-0001,MRN-4471903,completed,,,140,,2025-10-02,1407006835,true,,2026-08-19T02:00:00-04:00,, -IM-0002,MRN-7782200,not-done,PATOBJ,http://terminology.hl7.org/CodeSystem/v3-ActReason,140,,2025-11-14,,,,2026-08-19T02:00:00-04:00,, -IM-0003,MRN-5510042,completed,,,140,,2019-09-30,,false,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,status,status_reason_code,status_reason_system,vaccine_code,vaccine_system,occurrence_date,performer_npi,primary_source,source_system,last_updated,author_org_npi,is_deleted +IM-0001,MRN-4471903,completed,,,140,,2025-10-02,1999999992,true,,2026-08-19T02:00:00-04:00,, +IM-0002,MRN-7782200,not-done,PATOBJ,http://terminology.hl7.org/CodeSystem/v3-ActReason,140,,2025-11-14,,,,2026-08-19T02:00:00-04:00,, +IM-0003,MRN-5510042,completed,,,140,,2019-09-30,,false,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/practitioners.csv b/assets/data-integration/practitioners.csv index 6990fc0..e70f4b2 100644 --- a/assets/data-integration/practitioners.csv +++ b/assets/data-integration/practitioners.csv @@ -1,4 +1,4 @@ -record_id,npi,last_name,first_name,specialty_nucc,primary_org_npi,practitioner_role_code,location_id,phone,email,role_period_start,role_period_end,source_system,last_updated,author_org_npi,is_deleted -PRC-0001,1407006835,Roe,Richard,207R00000X,1234567893,doctor,LOC-221,5551234567,,2021-04-01,,,2026-08-19T02:00:00-04:00,, -PRC-0002,1407006835,Roe,Richard,207R00000X,1234567893,doctor,LOC-884,5554445555,,,,,2026-08-19T02:00:00-04:00,, -PRC-0003,1932108107,Fox,Dana,,,,,,,,,,2026-08-19T02:00:00-04:00,, +record_id,npi,last_name,first_name,specialty_nucc,primary_org_npi,practitioner_role_code,location_id,phone,email,role_period_start,role_period_end,source_system,last_updated,author_org_npi,is_deleted +PRC-0001,1999999992,Roe,Richard,207R00000X,1234567893,doctor,LOC-221,5551234567,,2021-04-01,,,2026-08-19T02:00:00-04:00,, +PRC-0002,1999999992,Roe,Richard,207R00000X,1234567893,doctor,LOC-884,5554445555,,,,,2026-08-19T02:00:00-04:00,, +PRC-0003,1888888884,Fox,Dana,,,,,,,,,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/procedures.csv b/assets/data-integration/procedures.csv index 3e58f9c..c4a4e9b 100644 --- a/assets/data-integration/procedures.csv +++ b/assets/data-integration/procedures.csv @@ -1,4 +1,4 @@ -record_id,patient_identifier,status,code,code_system,performed_start,performed_end,performer_npi,encounter_id,service_request_id,reason_code,reason_system,source_system,last_updated,author_org_npi,is_deleted -PRO-0001,MRN-4471903,completed,80146002,http://snomed.info/sct,2026-04-18,,1407006835,ENC-9912,,,,,2026-08-19T02:00:00-04:00,, -PRO-0002,MRN-7782200,completed,80146002,http://snomed.info/sct,2026-02-02,2026-02-02,1407006835,ENC-9913,,,,,2026-08-19T02:00:00-04:00,, -PRO-0003,MRN-3391077,completed,80146002,http://snomed.info/sct,2026-05-24,,,,SR-2201,733423003,,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,status,code,code_system,performed_start,performed_end,performer_npi,encounter_id,service_request_id,reason_code,reason_system,source_system,last_updated,author_org_npi,is_deleted +PRO-0001,MRN-4471903,completed,80146002,http://snomed.info/sct,2026-04-18,,1999999992,ENC-9912,,,,,2026-08-19T02:00:00-04:00,, +PRO-0002,MRN-7782200,completed,80146002,http://snomed.info/sct,2026-02-02,2026-02-02,1999999992,ENC-9913,,,,,2026-08-19T02:00:00-04:00,, +PRO-0003,MRN-3391077,completed,80146002,http://snomed.info/sct,2026-05-24,,,,SR-2201,733423003,,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/service_requests.csv b/assets/data-integration/service_requests.csv index 195d7d7..eb2cd97 100644 --- a/assets/data-integration/service_requests.csv +++ b/assets/data-integration/service_requests.csv @@ -1,4 +1,4 @@ -record_id,patient_identifier,status,intent,code,code_system,category,category_system,reason_code,reason_system,authored_on,occurrence_date,requester_npi,source_system,last_updated,author_org_npi,is_deleted -SR-2201,MRN-3391077,active,order,103696004,http://snomed.info/sct,sdoh,http://hl7.org/fhir/us/core/CodeSystem/us-core-category,733423003,,2026-05-10,2026-05-24,1407006835,,2026-08-19T02:00:00-04:00,, -SR-0002,MRN-4471903,active,order,103696004,http://snomed.info/sct,,,,,2026-04-18,,1407006835,,2026-08-19T02:00:00-04:00,, -SR-0003,MRN-7782200,completed,plan,103696004,http://snomed.info/sct,,,,,2025-12-01,,,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,status,intent,code,code_system,category,category_system,reason_code,reason_system,authored_on,occurrence_date,requester_npi,source_system,last_updated,author_org_npi,is_deleted +SR-2201,MRN-3391077,active,order,103696004,http://snomed.info/sct,sdoh,http://hl7.org/fhir/us/core/CodeSystem/us-core-category,733423003,,2026-05-10,2026-05-24,1999999992,,2026-08-19T02:00:00-04:00,, +SR-0002,MRN-4471903,active,order,103696004,http://snomed.info/sct,,,,,2026-04-18,,1999999992,,2026-08-19T02:00:00-04:00,, +SR-0003,MRN-7782200,completed,plan,103696004,http://snomed.info/sct,,,,,2025-12-01,,,,2026-08-19T02:00:00-04:00,, diff --git a/assets/data-integration/vital_signs.csv b/assets/data-integration/vital_signs.csv index b213f3f..72c80f5 100644 --- a/assets/data-integration/vital_signs.csv +++ b/assets/data-integration/vital_signs.csv @@ -1,6 +1,6 @@ -record_id,patient_identifier,status,loinc_code,effective_datetime,value,unit,component_systolic,component_diastolic,encounter_id,performer_npi,source_system,last_updated,author_org_npi,is_deleted -VS-0001,MRN-4471903,final,85354-9,2026-04-18T09:05:00-04:00,,,128,82,ENC-9912,1407006835,,2026-08-19T02:00:00-04:00,, -VS-0002,MRN-4471903,final,8867-4,2026-04-18T09:05:00-04:00,72,/min,,,ENC-9912,,,2026-08-19T02:00:00-04:00,, -VS-0003,MRN-4471903,final,8302-2,2026-04-18T09:05:00-04:00,163,cm,,,,,,2026-08-19T02:00:00-04:00,, -VS-0004,MRN-4471903,final,29463-7,2026-04-18T09:05:00-04:00,64.5,kg,,,,,,2026-08-19T02:00:00-04:00,, -VS-0005,MRN-7782200,final,8310-5,2026-02-02T21:40:00-05:00,38.2,Cel,,,ENC-9913,,,2026-08-19T02:00:00-04:00,, +record_id,patient_identifier,status,loinc_code,effective_datetime,value,unit,component_systolic,component_diastolic,encounter_id,performer_npi,source_system,last_updated,author_org_npi,is_deleted +VS-0001,MRN-4471903,final,85354-9,2026-04-18T09:05:00-04:00,,,128,82,ENC-9912,1999999992,,2026-08-19T02:00:00-04:00,, +VS-0002,MRN-4471903,final,8867-4,2026-04-18T09:05:00-04:00,72,/min,,,ENC-9912,,,2026-08-19T02:00:00-04:00,, +VS-0003,MRN-4471903,final,8302-2,2026-04-18T09:05:00-04:00,163,cm,,,,,,2026-08-19T02:00:00-04:00,, +VS-0004,MRN-4471903,final,29463-7,2026-04-18T09:05:00-04:00,64.5,kg,,,,,,2026-08-19T02:00:00-04:00,, +VS-0005,MRN-7782200,final,8310-5,2026-02-02T21:40:00-05:00,38.2,Cel,,,ENC-9913,,,2026-08-19T02:00:00-04:00,, diff --git a/docs/data-integration/provider-directory/README.md b/docs/data-integration/provider-directory/README.md index bf970e3..965e42a 100644 --- a/docs/data-integration/provider-directory/README.md +++ b/docs/data-integration/provider-directory/README.md @@ -22,7 +22,7 @@ One row per unique NPI, practice location, plan and specialty. A provider at two | Column | Required | Format / values | Example | |---|---|---|---| -| `npi` | Yes | 10 digits | `1234567893` | +| `npi` | Yes | 10 digits | `1999999992` | | `first_name` | Yes | text | `Jane` | | `last_name` | Yes | text | `Smith` | | `middle_name` | No | text | `G` | @@ -35,7 +35,7 @@ One row per unique NPI, practice location, plan and specialty. A provider at two | `board_certification` | If available | qualification code or name | `Board Certified, Cardiology` | | `plan_id` | Yes | key from `plans`; one plan per row | `PLAN-DSNP` | | `network_id` | Yes | key from `networks` | `NET-001` | -| `organization_npi` | If applicable | 10 digits; blank for a solo practitioner with no group NPI | `1407006835` | +| `organization_npi` | If applicable | 10 digits; blank for a solo practitioner with no group NPI | `1234567893` | | `accepting_new_patients` | Recommended | `accepting`, `not-accepting`, `existing-only`, `existing+family` [AcceptingPatientsVS](https://hl7.org/fhir/us/davinci-pdex-plan-net/STU1.2/ValueSet-AcceptingPatientsVS.html) | `accepting` | | `location_name` | Yes | text; Plan-Net requires a name on every location | `Riverdale Family Practice` | | `address_line1` | Yes | text | `225 Broadway` | @@ -56,11 +56,11 @@ One row per facility NPI, plan and network. | Column | Required | Format / values | Example | |---|---|---|---| -| `npi` | Yes | 10 digits | `1407006835` | +| `npi` | Yes | 10 digits | `1234567893` | | `facility_name` | Yes | text | `Example Hospital` | | `facility_type_nucc` | Yes | NUCC organization taxonomy code(s), `;`-separated [OrgTypeVS](https://hl7.org/fhir/us/davinci-pdex-plan-net/STU1.2/ValueSet-OrgTypeVS.html) | `282N00000X` | | `affiliation_type` | Recommended | `provider`, `pharmacy`, `lab`, `dme`, `urgent`, `hospice` [OrganizationAffiliationRoleVS](https://hl7.org/fhir/us/davinci-pdex-plan-net/STU1.2/ValueSet-OrganizationAffiliationRoleVS.html) | `provider` | -| `parent_org_npi` | If available | 10 digits, if part of a larger system | `1234567893` | +| `parent_org_npi` | If available | 10 digits, if part of a larger system | `1666666668` | | `plan_id` | Yes | key from `plans` | `PLAN-ISNP` | | `network_id` | Yes | key from `networks` | `NET-002` | | `location_name` | Recommended | text; defaults to `facility_name` if there is no distinct site name | `Example Hospital` | diff --git a/docs/data-integration/uscdi/care-team.md b/docs/data-integration/uscdi/care-team.md index 800e7f4..0f0286d 100644 --- a/docs/data-integration/uscdi/care-team.md +++ b/docs/data-integration/uscdi/care-team.md @@ -27,7 +27,7 @@ practitioners.csv Data template with example rows | Column | Required | Format / values | Example | |---|---|---|---| -| `npi` | Yes | 10 digits | `1407006835` | +| `npi` | Yes | 10 digits | `1999999992` | | `last_name` | Yes | text | `Roe` | | `first_name` | Recommended | text | `Richard` | | `specialty_nucc` | Recommended | NUCC taxonomy code(s), `;`-separated [Healthcare Provider Taxonomy](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.114222.4.11.1066&server=https://tx.fhir.org/r4) | `207R00000X` | @@ -50,7 +50,7 @@ care_team.csv Data template with example rows | Column | Required | Format / values | Example | |---|---|---|---| | `patient_identifier` | Yes | patient key | `MRN-4471903` | -| `member_npi` | Yes | 10 digits; send this or `member_related_person_id` | `1407006835` | +| `member_npi` | Yes | 10 digits; send this or `member_related_person_id` | `1999999992` | | `member_related_person_id` | Yes | `record_id` of the `related_persons` row, for non-clinicians; send this or `member_npi` | `RP-3310` | | `role_code` | Yes | SNOMED or NUCC code [Care Team Member Function](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1099.30&server=https://tx.fhir.org/r4) | `223366009` | | `status` | Recommended | `proposed`, `active`, `suspended`, `inactive`, `entered-in-error` [care-team-status](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/care-team-status%7C4.0.1) | `active` | diff --git a/docs/data-integration/uscdi/clinical-notes.md b/docs/data-integration/uscdi/clinical-notes.md index 4d9fcca..0f188cd 100644 --- a/docs/data-integration/uscdi/clinical-notes.md +++ b/docs/data-integration/uscdi/clinical-notes.md @@ -44,7 +44,7 @@ documents.csv Data template with example rows | `attachment_file` | Yes | path relative to the delivery root | `attachments/DOC-0001.pdf` | | `record_id` | Recommended | your stable row key | `DOC-0001` | | `document_date` | Recommended | datetime | `2026-04-18T10:00:00-04:00` | -| `author_npi` | Recommended | 10 digits | `1407006835` | +| `author_npi` | Recommended | 10 digits | `1999999992` | | `encounter_id` | If applicable | `encounters` key | `ENC-9912` | - `type_code` has a required binding, so the note type must come from that value set. It is large, but the four codes above cover most of what a payer holds. diff --git a/docs/data-integration/uscdi/clinical-tests.md b/docs/data-integration/uscdi/clinical-tests.md index 1008bf6..b28bdfa 100644 --- a/docs/data-integration/uscdi/clinical-tests.md +++ b/docs/data-integration/uscdi/clinical-tests.md @@ -34,7 +34,7 @@ clinical_observations.csv Data template with example rows | `value_code` | If coded | SNOMED CT or LOINC code, with `value_system` | | | `data_absent_reason` | If there is no result | `unknown`, `asked-declined`, `not-performed` [data-absent-reason](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/data-absent-reason%7C4.0.1) | | | `effective_datetime` | Recommended | datetime | `2026-04-18` | -| `performer_npi` | If available | 10 digits | `1407006835` | +| `performer_npi` | If available | 10 digits | `1999999992` | | `panel_id` | If available | `record_id` of the parent `clinical_observations` row | `CO-1200` | - Send exactly one of `value_quantity`, `value_string`, `value_code` or `data_absent_reason`. A row with a result and an absent reason contradicts itself; a row with neither cannot become an Observation. diff --git a/docs/data-integration/uscdi/encounters.md b/docs/data-integration/uscdi/encounters.md index 7f97186..ae32783 100644 --- a/docs/data-integration/uscdi/encounters.md +++ b/docs/data-integration/uscdi/encounters.md @@ -36,7 +36,7 @@ encounters.csv Data template with example rows | `reason_code` | If available | SNOMED CT or ICD-10-CM code(s), `;`-separated, with `reason_system`; SNOMED CT if omitted [encounter-reason](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/encounter-reason%7C4.0.1) | `29857009` chest pain | | `location_id` | Recommended | `locations` key | `LOC-221` | | `diagnosis_condition_id` | If available | `record_id` of the `conditions` row(s), `;`-separated | `CND-4501` | -| `participant_npi` | If available | 10 digits, `;`-separated | `1407006835` | +| `participant_npi` | If available | 10 digits, `;`-separated | `1999999992` | | `participant_type_code` | If available | `ATND` attender, `ADM` admitter, `DIS` discharger, `CON` consultant, `REF` referrer, with `participant_type_system`; v3-ParticipationType if omitted [encounter-participant-type](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/encounter-participant-type%7C4.0.1) | `ATND` | | `discharge_disposition_code` | If applicable | NUBC patient discharge status code, as carried in UB-04 field 17, with `discharge_disposition_system` [AHA NUBC Patient Discharge Status](https://terminology.hl7.org/5.5.0/CodeSystem-AHANUBCPatientDischargeStatus.html) | `01` discharged to home or self-care | | `service_provider_npi` | If available | 10 digits | `1234567893` | diff --git a/docs/data-integration/uscdi/immunizations.md b/docs/data-integration/uscdi/immunizations.md index a2531a3..c2cfbb9 100644 --- a/docs/data-integration/uscdi/immunizations.md +++ b/docs/data-integration/uscdi/immunizations.md @@ -31,7 +31,7 @@ immunizations.csv Data template with example rows | `status_reason_code` | If `not-done` | SNOMED CT or v3 ActReason code, with `status_reason_system` [immunization-status-reason](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/immunization-status-reason%7C4.0.1) | `PATOBJ` patient objection | | `vaccine_code` | Yes | CVX code, with `vaccine_system`; CVX if omitted [CVX Vaccines Administered Vaccine Set](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/vaccine-code%7C4.0.1) | `140` influenza, seasonal, injectable, preservative free | | `occurrence_date` | Yes | datetime | `2025-10-02` | -| `performer_npi` | If available | 10 digits | `1407006835` | +| `performer_npi` | If available | 10 digits | `1999999992` | | `primary_source` | Recommended | `true` / `false` | `true` | - `vaccine_code` is the one coded field with no fallback: a row without it cannot become an Immunization. Send `vaccine_system` as `http://hl7.org/fhir/sid/cvx`. US Core requires the CVX coding, so a row sourced from a billed claim that only carries an NDC should send that NDC with `vaccine_system` as `http://hl7.org/fhir/sid/ndc`; Payerbox crosswalks it to CVX. diff --git a/docs/data-integration/uscdi/procedures.md b/docs/data-integration/uscdi/procedures.md index 1c38bf4..81c8b15 100644 --- a/docs/data-integration/uscdi/procedures.md +++ b/docs/data-integration/uscdi/procedures.md @@ -30,7 +30,7 @@ procedures.csv Data template with example rows | `code` | Yes | CPT, HCPCS, ICD-10-PCS, or SNOMED CT code, with `code_system`; CPT if omitted [US Core Procedure Codes](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/us/core/ValueSet/us-core-procedure-code) | `80146002` appendectomy | | `performed_start` | Recommended | date or datetime | `2026-04-18` | | `performed_end` | If a period | date or datetime | | -| `performer_npi` | If available | 10 digits | `1407006835` | +| `performer_npi` | If available | 10 digits | `1999999992` | | `encounter_id` | If applicable | `encounters` key | `ENC-9912` | | `service_request_id` | If available | `record_id` of the `service_requests` row, when the procedure fulfils a request | `SR-2201` | | `reason_code` | If available | SNOMED CT or ICD-10-CM code(s), `;`-separated, with `reason_system`; SNOMED CT if omitted [procedure-reason](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/ValueSet/procedure-reason%7C4.0.1) | `733423003` food insecurity | @@ -56,7 +56,7 @@ service_requests.csv Data template with example rows | `reason_code` | If available | SNOMED CT or ICD-10-CM code(s), `;`-separated, with `reason_system`; SNOMED CT if omitted [US Core Condition Codes](https://healthsamurai.github.io/fhir-valueset-viewer/#url=http://hl7.org/fhir/us/core/ValueSet/us-core-condition-code) | `733423003` food insecurity | | `authored_on` | If available | datetime | `2026-05-10` | | `occurrence_date` | If available | datetime | `2026-05-24` | -| `requester_npi` | If available | 10 digits | `1407006835` | +| `requester_npi` | If available | 10 digits | `1999999992` | - `status` and `intent` are both required bindings, so a value outside these lists is rejected. A referral a payer holds is normally `active` with intent `order`. - `code` says what was requested. It is the one coded field with no fallback: a row without it cannot become a ServiceRequest. Its value set is deliberately broad, so use the system your domain uses — LOINC for a lab order, CPT or HCPCS off a claim. diff --git a/docs/data-integration/uscdi/vital-signs.md b/docs/data-integration/uscdi/vital-signs.md index 87d740e..cd60f73 100644 --- a/docs/data-integration/uscdi/vital-signs.md +++ b/docs/data-integration/uscdi/vital-signs.md @@ -33,7 +33,7 @@ vital_signs.csv Data template with example rows | `component_systolic` | Blood pressure only | decimal | `128` | | `component_diastolic` | Blood pressure only | decimal | `82` | | `encounter_id` | If applicable | `encounters` key | `ENC-9912` | -| `performer_npi` | If available | 10 digits | `1407006835` | +| `performer_npi` | If available | 10 digits | `1999999992` | - `effective_datetime` is required here, unlike every other observation in the feed. A vital sign without a time is not a conformant reading. - A quantitative vital needs both `value` and `unit`, and the unit must be UCUM. `/min` for heart and respiratory rate, `cm` for height, `kg` for weight, `Cel` for temperature, `%` for oxygen saturation, `kg/m2` for BMI.