{"id":"678b6420-df08-4025-ba93-b0d474bdd748","task":"NUCC taxonomy code selection and mapping for providers","domain":"nucc.org","steps":["Download or browse the current NUCC Health Care Provider Taxonomy code set from https://www.nucc.org/index.php/code-sets-mainmenu-41/provider-taxonomy-mainmenu-40/code-lookups — the code set is updated twice a year in January and July.","Identify the correct code using the three-level hierarchy: Provider Grouping (e.g., Allopathic & Osteopathic Physicians) > Classification (e.g., Internal Medicine) > Specialization (e.g., Cardiovascular Disease).","Map your taxonomy code to claims: in the X12 837P professional claim, place the taxonomy code in Loop 2000B NPI/taxonomy for billing provider and Loop 2310B for rendering provider using qualifier ZZ in PRV03.","In FHIR resources, represent the taxonomy code in PractitionerRole.specialty using the system http://nucc.org/provider-taxonomy and the 10-character alphanumeric code as the code value.","Validate your selected code against the CMS crosswalk at https://www.cms.gov/medicare/enrollment-renewal/providers-suppliers/health-care-taxonomy to confirm Medicare recognizes the code for enrollment and billing.","When a provider has multiple specialties, select one primary taxonomy for claims; document the primary selection and ensure it matches the primary taxonomy registered in NPPES."],"gotchas":["Taxonomy codes are 10 characters and alphanumeric — do not pad or truncate; a wrong code can cause claim rejections or incorrect payer routing even if the NPI is valid.","The taxonomy code set is released twice yearly; codes can be added, revised, or retired — validate codes at ingestion time and re-validate existing provider records against each new release.","CMS requires taxonomy on Medicare claims but treats it as informational in some contexts; other payers may deny claims outright for missing or incorrect taxonomy — check payer-specific companion guides."],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:40.307Z"},"url":"https://mcp.waymark.network/r/678b6420-df08-4025-ba93-b0d474bdd748"}