Diagnosis Creation in an Encounter

API users now have the ability to create, modify and delete diagnoses via API for open encounters in athenaNet.  This diagnosis creation functionality is used within the exam portion of an encounter and helps to support order creations.  A diagnosis must be added to an open encounter before orders can be added to the encounter.  See the documentation on Order Creation for important information related to the ordering workflow. 

The following APIs have been added.

Pulls all diagnoses currently associated with the specified encounter. No input parameters other than the encounterid are supported.  Returns SNOMED diagnosis codes that have been added to the encounter.

Add a single SNOMED diagnosis code to the specified encounter.  The encounterid and snomedcode fields are required inputs.  API users may optionally specify laterality and an explicit ICD-9 and/or ICD-10 codes to be used for billing.  If ICD codes are not explicitly specified, default codes will be chosen based on athenaNet’s SNOMED to ICD mappings, when available.  If ICD codes are explicitly specified, they will be recorded as submitted through the API, even if the ICD codes do not match athenaNet’s SNOMED to ICD mappings.

Update a single SNOMED diagnosis for the specified encounter.  The diagnosisidencounterid and snomedcode fields are required inputs.  API users may optionally specify laterality and explicit ICD-9 and/or ICD-10 codes to be used for billing.  If ICD codes are not explicitly specified, default codes will be chosen based on athenaNet’s SNOMED to ICD mappings, when available.  If ICD codes areexplicitly specified, they will be recorded as submitted through the API, even if the ICD codes do not match athenaNet’s SNOMED to ICD mappings.

Note that any information submitted for a diagnosis will completely replace existing information for this diagnosis in the encounter, including attached ICD codes.  If an existing diagnosis has ICD codes in the encounter you wish to preserve, please ensure you resubmit all of them with this PUT call.  If no ICD codes are submitted, they will be repopulated with default codes based on the SNOMED code, even if the SNOMED code was not changed.

Deletes the specified diagnosis from the specified encounter.  No input parameters other than the diagnosisid and encounterid are supported.

Additional Notes

  • Diagnosis APIs work only with encounters in OPEN or REVIEW status. 
  • Only valid SNOMED, ICD-9 and ICD-10 values will be accepted by the APIs.
  • If athenaNet does not have a default mapping between a SNOMED code and ICD codes, then no default ICD code will be associated with this diagnosis.
Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others