When sending a National Scoped ID in PID-19 (SSN) you receive "AuthorityUuid" missing error

Issue: When using the SanteDB dCDR via the HL7 ADT feed, new patients are not registered, rather you receive a NACK indicating a missing argument/parameter for AuthorityUUID
Applies To:
  • SanteDB dCDR Gateway Kelowna (Version 2.0.22+)
  • SanteDB iCDR + SanteMPI (Version 2.0.22+)
Symptoms:
  • Upon sending a registration using PID-19, you receive a NACK as illustrated below
MSH|^~\&|SENDER|LOCAL|MPI_SERVER|NATIONAL_DC|20200806100518|XXXXX|ADT^A04^ADT_A01|117631e6-8866-4d67-be10-4ed64e55b52b|P|2.3.1|||AL
EVN||202008061005+0630
PID|||XXXYYY^^^AUTHORITY^PT||SMITH^JOHN^^^^^U||1978|M|||||||||||403-304-302
NK1|1|^U Hla Shwe|FTH
PV1||I
MSH|^~\&|MPI_SERVER|NATIONAL_DC|SENDER|LOCAL|20200806100051||ACK^A04^ACK|cc103f57-4602-4590-83c8-741c9c834ee9||2.3.1
MSA|AE|117631e6-8866-4d67-be10-4ed64e55b52b|General Error|||207^Insert SanteDB.Core.Model.Collection.Bundle
ERR|^^^&Insert SanteDB.Core.Model.Collection.Bundle||207|E
ERR|^^^&Exception has been thrown by the target of an invocation.||207|E
ERR|^^^&Requires a value\X000d\Parameter name: AuthorityUuid||207|E
Cause: This rejection is caused because the ssnAuthority has not been configured for the dCDR or iCDR.
Solutions:
If correcting the iCDR:
  1. 1.
    Open the file C:\Program Files\SanteSuite\SanteDB\Server\SanteDB.config.xml
  2. 2.
    Locate the section HL7Configuration
  3. 3.
    Add the <ssnAuthority> element (below) with the appropriate configuration of what identifier is being carried in the PID-19 field.
  4. 4.
    Save the file
  5. 5.
    Restart the SanteDB Host Process
If correcting the dCDR:
  1. 1.
    Open the file C:\WINDOWS\SYSWOW64\config\systemprofile\AppData\roaming\santedb\dcg-default\santedb.config
  2. 2.
    Locate the section HL7Configuration
  3. 3.
    Add the <ssnAuthority> element (below) with the appropriate configuration of what identifier is being carried in the PID-19 field.
  4. 4.
    Save the file
  5. 5.
    Restart the SanteDB Host Process
An appropriate ssnAuthority configuration is illustrated below:
<ssnAuthority>
<domainName xmlns="http://santedb.org/model">SOME_AUTHORITY_NAME</domainName>
</ssnAuthority>