Message Header Elements

message header elements element codes comment to mandatory this field will contain the ncpdpid of the pharmacy or the spi (surescripts prescriber id) of the prescriber note all response messages and free standing messages should be sent to the same sender that initiated the original message @qualifier conditional business rule if the to field is sent, then the qualifier must also be sent values d = prescriber id (used for spi) p = pharmacy ncpdpid from mandatory this field will contain the ncpdpid of the pharmacy or the spi (surescripts prescriber id) of the prescriber @qualifier conditional business rule if the from field is sent, then the qualifier must also be sent values d = prescriber id (used for spi) p = pharmacy ncpdpid messageid mandatory s 205 the sender shall ensure the combination of the from and messageid elements, for all messages including error, is unique for at least 18 months surescripts recommends an unformatted globally unique identifier (guid) relatestomessageid conditional send the relatestomessageid when the most recent and relevant message in the workflow contains a messageid if a newrx is sent following a benefitresponse message, populate the relatestomessageid with the messageid from the response message see message linkage docid\ t j0gupe16bjjbyq3fnbg section for more details senttime mandatory date of the transmission please see utc time format docid\ kcbky6vq3n8ayeackfccv section security conditional usernametoken conditional for mailboxing, usernametoken is used please refer to the surescripts mailboxing guide for more information sender conditional tertiaryidentification conditional surescripts populates the account id associated with the sender receiver conditional tertiaryidentification conditional surescripts populates the account id associated with the receiver messageindicatorflag conditional business rule indicates to the receiver that they are not receiving the original message, but rather a copy for a specific purpose messages sent with messageindicatorflag must be sent to a receiver on ncpdp script version v2023011 or later this field is not backwards compatible and will be rejected by surescripts if sent to a recipient on script v2017071 values informational – copy of the message exchange for informational purposes datasynchronization – exchange data between entities retractionwithdrawal – retraction of the original request digitalsignature conditional if used, either send values under actual digital signature or the digitalsignatureindicator value @version mandatory version 1 1 should be used (actual digital signature) conditional repeats 1 2 digestmethod mandatory values sha 1 sha 256 digestvalue mandatory signaturevalue mandatory x509data mandatory digitalsignatureindicator conditional indicates if the prescription has been digitally signed values true false note surescripts recommends only sending this when the value is “true ” prescriberordergroup conditional rxreferenceordergroup conditional