Patent Publication Number: US-10789661-B2

Title: Computer system and computer implemented method for real-time drug interaction checker

Description:
CROSS-REFERENCE TO RELATED APPLICATIONS 
     This application is a continuation of U.S. patent application Ser. No. 13/299,330, filed on Nov. 17, 2011; said application claims priority to U.S. Provisional Patent Application No. 61/414,670, filed Nov. 17, 2010, the entirety of said applications are hereby incorporated herewith. 
    
    
     FIELD OF THE INVENTION 
     The present invention generally relates to systems and methods for performing real-time checks for interactions of drugs, particularly the interactions between consumer products available without a prescription and current prescription medications. 
     BACKGROUND OF THE INVENTION 
     Generally, drug utilization review (“DUR”), on consumer purchases of non-prescription (“OTC”), products is not required or necessary on either the OTC purchasing side or the prescription dispensing side. There are a number of reasons including: (1) it is unclear who is actually using the OTC product, (2) most state laws require a “reasonable effort” to collect patient information (including OTC use); a DUR is not typically performed in the industry. 
     The growth and expansion of the internet and e-commerce has led to increased consumer purchases of OTC products from a computer rather than in a public setting with accessibility to a live pharmacist. When available in a public setting, a pharmacist can perform a review of the adequateness of an OTC product, and provide an alternative recommendation when a proposed OCT purchase would lead to a potential drug-drug or drug-disease interaction. 
     Accordingly, we have determined that there exists a need in the art for a computer system and computer implemented method to perform real-time drug interaction screening at the point of sale. 
     SUMMARY OF THE INVENTION 
     In some embodiments, the present invention may provide a solution to the lack of accessibility to the pharmacist when the consumer makes a web-based OTC purchase. In certain embodiments, “patient level” DUR is included (using combined RX and OTC product history), and that system and process will have the ability to identify who the individual patient for whom a particular purchase is made (i.e., the person with the household). 
     In certain embodiments, OTC purchase information may be placed on a patient&#39;s profile. This may be done at the patient level (i.e., we will know whether the OTC purchase is made for a particular individual). OTC information may be available to pharmacists with access to the patient&#39;s profile, and could be utilized in performing DUR when the pharmacist dispenses a prescription drug to the patient in the same manner DUR would be performed against (1) other prescription medications dispensed by the pharmacy, (2) prescription medications dispensed by another pharmacy within the pharmacy network, (3) self-reported prescription medications, (4) self-reported OTC products, and (5) diseases or chronic conditions. 
     In certain embodiments, a proposed OTC purchase is checked against a patient profile, a potentially serious interaction is identified, and an alternative OTC product is recommended. 
     In certain other embodiments, where the purchaser cannot be obtained, i.e., the purchaser may or may not be the patient. For OTC purchases, DUR would not be performed and the purchases would not be stored. In these transactions, the invention would provide a drug interaction checker tool for patients to perform their own DUR. In certain preferred embodiments, the drug interaction checker tool would have the capability to add OTC and/or prescription drugs one at a time. In certain more preferred embodiments, the user/patient interface would include a persistent link to the drug interaction checker tool throughout the site and independent from the purchase/order flows. 
     In certain other embodiments, where the purchaser cannot be obtained, i.e., the purchaser may or may not be the patient. For checking potential prescription purchases, the user interface would provide a drug interaction checker having the ability to add products one at a time. 
     In accordance with the above embodiments, the invention further provides a system and method where a family level addition listing all OTC purchases corresponding to a family can be checked. 
     In certain other embodiments of the present invention, the system and method will comprise DUR executed by a pharmacist specializing in a specific disease states selected from the group consisting of diabetes, cardiovascular disease, gastro-intestinal disorders, psychological/neurological conditions, hematology/oncology, and pulmonary conditions. In certain embodiments the invention allows for the ability for the user/purchaser to select products for the user or a member of the user&#39;s family that are included within the user&#39;s health plan. In certain preferred embodiments, the health plan comprises a drug benefit plan. In accordance with the above aspects of the invention, the process and system provides alerts to the user of potential drug-drug or drug-disease interactions. In certain preferred embodiments, the alerts are selected from the group consisting of severe drug-drug interactions, drug-drug interactions, drug-disease interactions, drug-disease interactions inferred by the patient&#39;s prescription history, and therapeutic duplication. In certain preferred embodiments, DUR leading to severe drug-drug interactions would not allow the user/purchase to complete the purchase of the OTC. In certain other preferred embodiments, DUR leading to a drug-drug interaction would allow the user/purchaser to complete the transaction while providing a warning of the interaction. In preferred aspects, patient information will be provided and/or the system will ensure clearly who the end/user patient is. In certain other embodiments, the user/purchaser will be provided the option of indicating the OTC is intended for household use and not for a particular patient. 
     In certain embodiments, OTC purchase information may be placed on a patient&#39;s profile and the user/purchaser will have the ability to indicate whether the prescription is for acute or chronic use. A skilled practitioner in the art would appreciate that this distinction is dependent on the particular product and the condition or symptom it is being used for. In certain preferred embodiments, acute refers to one time use and chronic refers to continuous or ongoing use. In certain embodiments, where the user/purchaser indicates that a product is for acute use, the system and process of the invention would provide a one-time snapshot DUR with user/purchaser acknowledgment. In certain other embodiments, the invention also provides the user/purchaser to add information into the user-initiated drug interaction checker including prescription history information and items selected for on-line purchase. In certain preferred embodiments, these are accomplished by buttons labeled ‘load history’ and ‘add items in cart’. 
     In accordance with the above embodiments, where the user/purchaser indicates that a product is for chronic use, the system and process of the present invention would provide for a full DUR, the information on the OTC purchase would be saved in the patient profile and would be considered for future OTC and prescription dispenses. In certain preferred embodiments, these are accomplished by links labeled ‘load history’ and ‘add items in cart’. 
     In accordance with the above embodiments, the system and process of the present invention would provide alerts of severe drug-drug interactions, drug-drug interactions and drug-disease interactions. In certain embodiments, the system and process would offer the ability to correct the patient if an incorrect patient was entered. In other embodiments where the alert is not severe, the user/purchaser would receive a message with a warning and permit the sale of the selected DUR message. In certain other embodiments, interactions are classified as severe interactions. One of skill in the art would appreciate that classification of severe is determined by clinical factors such as a more substantial likelihood of harm and/or a heightened severity of harm to the patient. In certain preferred embodiments where the message identifies a severe interaction, the system and method would not permit the completion of the selected OTC product. In certain other preferred embodiments of the present invention, the system and method would offer the user/purchaser to correct the patient information if incorrectly entered. In certain preferred embodiments, the messaging provides an option to speak with a specially trained pharmacist by dialing a phone number. In certain other embodiments the user/purchaser&#39;s phone call is received by an interactive voice response (“IVR”), system to navigate through inquiries with OTC product DUR inquires. 
     In accordance with the above embodiments, where the use of the OTC product is characterized as chronic use for the identified patient, the invention is further directed to systems and methods where OTC purchases are stored in a patient profile and considered during DUR by the pharmacy maintaining the profile or a pharmacy in the pharmacy network corresponding to the patient&#39;s health plan. In certain preferred embodiments, the OTC purchases are stored in the claims database of the patient&#39;s profile to enable DUR to consider these OTC products during subsequent transactions. 
     In accordance with the above embodiments, the invention further provides for systems and methods where the graphical user interface allows for access to the patient&#39;s prescription profile including a dispensing history while using the pharmacy associated With the health plan, e.g. prescription drug plan (“PDP”), and while using a pharmacy that submits claims for reimbursement to the PDP manager. In certain preferred embodiments, the graphical user interface provides one or more entry points into a platform that allows for shopping and purchase of OTC products. In certain other preferred embodiments, the platform is derived from a commercially available commerce platform, e.g., WebSphere Commerce, available from IBM Corp., Armonk, N.Y. 
     In accordance with the above embodiments, the invention provides warnings classified as major, moderate or minor. Major means the interaction may be life-threatening. In certain other embodiments, a major alert would direct the user/purchaser to call the patient&#39;s doctor immediately to discuss whether the patient should be taking the interacting medications together. Moderate means the interaction may make a condition worse. The patient&#39;s doctor may need to change the therapy. In certain other embodiments, a moderate alert would direct the user/purchaser to contact the patient&#39;s doctor or pharmacist about using the interacting products together. Minor means the interaction may increase the side effects of each drug. The patient can usually continue taking both drugs. In certain other embodiments, a minor alert would direct the user/purchaser to report any unusual or bothersome side effects to the patient&#39;s doctor. 
     In one aspect of the invention, the drug interaction checker system comprises one or more non-transitory computer storage media having stored thereon, computer executable instructions that, when executed, facilitate a process for determining drug interactions, the process comprising the following steps performed in sequential, non-sequential and sequence independent order: (i) identifying from a list of one or more OTC products selected for purchase during a shopping session utilizing an web-based commerce platform, products that could potentially interact with a prescription or OTC product of a patient, (ii) obtaining electronic authorization for the drug interaction checker to access information about the patient&#39;s prescription history, (iii) determining via responses to questions presented to the user/purchaser whether the patient will be using the one or more OTC products for one-time use or ongoing basis, (iv) comparing the combination of the one or more OTC products and the information available from the patient&#39;s prescription history against a list of possible drug interactions stored in a database, (v) identifying interactions and/or (vi) alerting the user the user/purchaser of those interactions. 
     In some embodiments of the invention, computer executable instructions further comprise a capability to: offer the user to change the initially identified patient to a second patient, obtain authorization to share prescription and health information with the drug interaction checker, and perform, for example, one or more of (iii)-(vi). 
     In some embodiments of the invention, computer executable instructions further comprise a capability to indicate that the selected one or more products will be for household use. 
     In some embodiments of the invention, when an indication of household use is provided, the computer executable instructions further comprise a capability for obtaining an authorization to share prescription history and health information for one or more patients of the household and performing one or more of (iii)-(vi) for each patient where authorization is provided. 
     In some embodiments of the invention, when a serious or major interaction has been determined, the computer executable instructions further comprise a capability to advise the user one or more of that (a) the product is not recommended for purchase for the identified patient, (b) will prevent completion of the purchase of the selected interacting product, (c) the user may discuss the interaction alert with a pharmacist via telephone or other communication method (d) providing a user acknowledgement of the interaction and allowing the transaction to proceed, and/or (e) combinations thereof. 
     In some embodiments of the invention, computer executable instructions further comprise a capability to alert the user to one or more interactions selected from one or more of: drug-drug interaction, severe drug-drug interaction, drug-disease interaction wherein the disease is reported by the user, drug-inferred disease interaction, drug-allergy interaction, drug-food interaction, drug-environment interaction and/or drug-lifestyle interaction. 
     In some embodiments of the invention, when an interaction has been identified, the computer executable instructions further comprise a capability to suggest alternative safer OTC products. In some embodiments of the invention, interaction alerts are provided as messaging at the interaction pair level. 
     In some embodiments of the invention, a DUR user interface is capable of providing more detailed patient condition information. In some embodiments of the invention, access is available to the user through a mobile device operating on a system selected from the group consisting of PC, MAC, ANDROID and Blackberry. 
     In some embodiments of the invention, computer executable instructions further comprise a capability to store the DUR transaction information including alerts triggered when interactions are identified, messages, history comprising information selected from the group consisting of alerts triggered, messages, alternative product suggestions, drug pairs and dates of alerts. In some embodiments of the invention, a capability is provided to electronically transfer prescription history into the drug interaction checker. 
     In some embodiments of the invention, a capability is provided for the user to provide information pertaining to the patient for use in the interaction checker selected from the group consisting of: prescription history, self reported OTC products, diseases, food and alcohol consumption, vitamin consumption, environment, and lifestyle. In some embodiments of the invention, a capability is provided to monitor expiration dating of prescription and OTC products and send alerts when the product shelf-life has expired. 
     In some embodiments of the invention, a capability is provided to delete information pertaining to a patient. In some embodiments of the invention, a capability is provided for the user to electronically scan a image corresponding to an OTC product or a prescription label, and/or a capability to convert the scanned image into electronic data corresponding to the drug associated with the label. In some embodiments of the invention, a capability is provided for storage of the drug information in the patient&#39;s drug history and to perform real-time DUR. 
     In some embodiments of the invention, a computer implemented method of drug interaction checking, comprising at least one of the sequential, non-sequential or sequence independent steps of electronically receiving by a computer a selection from a computer user device used by a customer of at least one over the counter (OTC) product for purchase by the customer, and identifying by the computer the at least one OTC product selected for purchase by the customer during, products that could potentially interact with at least one of a patient condition, prescription and another OTC product of a patient. 
     In some embodiments of the invention, the computer implemented method, executed by a computer, receives electronic authorization to access information about a prescription history, medical profile and other health condition of the patient, and determines via responses to questions presented to the customer whether the patient will be using the at least one OTC product for one-time episodic use or on an ongoing basis. 
     In some embodiments of the invention, the computer implemented method, executed by a computer, compares a combination of the at least one OTC product and the information available from the patient&#39;s prescription and medical history against a list of possible drug interactions stored in one or more rules databases, identifies drug interactions responsive to said comparing, and alerts at least one of the customer and the patient of the drug interactions responsive to said identifying the drug interactions. 
     In some embodiments of the invention, the computer implemented method, executed by a computer, further comprises obtaining an authorization to share prescription history and health information for one or more patients of a household. In some embodiments of the invention, the computer implemented method, executed by a computer, determines a serious or major interaction, alerts the customer that the selected product is not recommended for purchase for the identified patient, prevents completion of the purchase of the selected interacting product and/or provides the customer acknowledgement of the interaction and allowing the transaction to proceed. 
     In some embodiments of the invention, the computer implemented method, executed by a computer, alerts the user to one or more interactions selected from at least one of: drug-drug interaction, severe drug-drug interaction, drug-disease interaction wherein the disease is reported by the user, drug-inferred disease interaction, drug-allergy interaction, drug-food interaction, drug-environment interaction and/or drug-lifestyle interaction. 
     In some embodiments of the invention, the computer implemented method, executed by a computer, transmits to the customer an alternative safer OTC product. In some embodiments of the invention, the computer implemented method, executed by a computer, receives from the customer information pertaining to the patient for use in the interaction checker including at least one of: prescription history, self reported OTC products, diseases, food and alcohol consumption, vitamin consumption, environment, and lifestyle. In some embodiments of the invention, the computer implemented method, executed by a computer, monitors expiration date of prescription and OTC products purchased and sending alerts when the product shelf-life has expired. 
    
    
     
       BRIEF DESCRIPTION OF THE DRAWINGS 
       Additional embodiments of the invention, its nature and various advantages, will be more apparent upon consideration of the following detailed description, taken in conjunction with the accompanying drawings, in which like reference characters refer to like parts throughout, and which include the following: 
         FIG. 1  is an illustration of pre-authenticated token delivery according to some embodiments of the invention. 
         FIG. 2  is an illustration of data flow overview according to some embodiments of the invention. 
         FIG. 3  is an illustration of the drug interaction checker process: identifying Drug Utilization Review items in the cart according to some embodiments of the invention. 
         FIG. 4  is an illustration of the drug interaction checker process: information sharing authorization according to some embodiments of the invention. 
         FIG. 5  is an illustration of the drug interaction checker process: determining product use according to some embodiments of the invention. 
         FIG. 6  is an illustration of the drug interaction checker process: determining product use according to some embodiments of the invention. 
         FIG. 7  is an illustration of the drug interaction checker process: results page messages (red warning example) according to some embodiments of the invention. 
         FIG. 8  is an illustration of the drug interaction checker process: results page messages (yellow notification example) according to some embodiments of the invention. 
         FIG. 9  is an illustration of the drug interaction checker process: checkout according to some embodiments of the invention. 
         FIG. 10  is an illustration of the drug interaction checker process: no Drug Utilization Review items in the cart according to some embodiments of the invention. 
         FIG. 11  is an illustration of the drug interaction checker process: No Drug Utilization Review items in the cart messaging according to some embodiments of the invention. 
         FIG. 12  is an illustration of the drug interaction checker: updating information sharing preference according to some embodiments of the invention. 
         FIG. 13  is an illustration of the Product Mapper Service according to some embodiments of the invention. 
         FIG. 14  is an illustration of the Drug Utilization Review Product Alerts Service according to some embodiments of the invention. 
         FIG. 15  is an illustration of the drug safety check with Health Insurance Portability and Accountability Act Authorization according to some embodiments of the invention. 
         FIG. 16  is an illustration of the business rules according to some embodiments of the invention. 
     
    
    
     DETAILED DESCRIPTION OF PREFERRED EMBODIMENTS OF THE INVENTION 
     Before explaining at least one embodiment of the invention in detail, it is to be understood that the invention is not limited in its application to the details of construction and to the arrangements of the components set forth in the following description or illustrated in the drawings. The invention is capable of other embodiments and of being practiced and carried out in various ways. Also, it is to be understood that the phraseology and terminology employed herein are for the purpose of description and should not be regarded as limiting. 
     As such, those skilled in the art will appreciate that the conception, upon which this disclosure is based, may readily be utilized as a basis for the designing of other structures, methods and systems for carrying out the several purposes of the present invention. It is important, therefore, that the invention be regarded as including equivalent constructions to those described herein insofar as they do not depart from the spirit and scope of the present invention. For example, the specific sequence of the described process maybe altered so that certain processes are conducted in parallel or independent, with other processes, to the extent that the processes are not dependent upon each other. Thus, the specific order of steps described herein is not to be considered implying a specific sequence of steps to perform the process. In alternative embodiments, one or more process steps may be implemented by a user assisted process and/or manually. Other alterations or modifications of the above processes are also contemplated. For example, further insubstantial approximations of the process and/or algorithms are also considered within the scope of the processes described herein. 
     In addition, features illustrated or described as part of one embodiment can be used on other embodiments to yield a still further embodiment. Additionally, certain features may be interchanged with similar devices or features not mentioned yet which perform the same or similar functions. It is therefore intended that such modifications and variations are included within the totality of the present invention. 
     The present invention relates to a computer system and computer implemented method for real-time drug interaction screening for users buying OTC drugs through the internet where they would not have direct access to a pharmacist to discuss the potential interactions information specific to a patient. 
     Patient Information Used to Check Against a Drug Selection 
     In certain embodiments, patient information is available from a prescription history or profile maintained by the pharmacy where the patient orders prescription medications. In the case of certain pharmacy benefits managers (“PBM”), with a dispensing pharmacy service, the prescription records can be obtained from multiple sources. A PBM could also possess and access claim data for all dispenses from its own dispensing pharmacy service as well as all claim data for prescriptions filled by other pharmacies, e.g., community pharmacies that submit claims to the PBM for dispensing. 
     In certain embodiments, the PBM may also access medical claims data from the patient&#39;s health plan. Typically this data is accompanied by diagnosis codes which could be used to identify a patient&#39;s disease state. Additionally, lab values and other diagnostic information could be used to determine the suitability of certain drug therapies based on a patient&#39;s unique genetic and metabolic characteristics. Details of such processes are described in commonly assigned U.S. Pat. Nos. 7,711,583 and 7,124,031, the disclosures of which are hereby incorporated by reference in their entireties. 
     In certain embodiments the information is self reported by the patient. There may be instances where a patient chooses to obtain prescription medication via a pharmacy or a transaction that is not associated with the PBM pharmacy service or a reimbursement. In these cases, the invention includes capability for the user to search and select drugs currently being utilized. Additionally, where OTC products are purchased outside of the PBM network, those products could also be added to a patient&#39;s profile maintained by the PBM. In other examples, the patient has no affiliation with the PBM and loads his drug, disease and other pertinent information into a patient profile in order for the drug interaction checker to perform DUR on a potential purchase. 
     In other embodiments, patient information including drug, food and excipient allergies, supplements and vitamins, food, alcohol, environment and lifestyle are included in the patient profile for consideration during a DUR. 
     In other embodiments, the drug interaction checker allows for point of use, and one by one loading of drugs or other pertinent patient information for DUR screening. 
     In still other embodiments, information is obtained with a DUR interface capability allowing the system to clarify reported patient conditions. In some cases, patients report a drug allergy where the experience was actually a known side effect. One common example is a reported codeine allergy when the patient experienced stomach discomfort, not an allergic reaction. Listing a codeine allergy may prevent a patient from receiving a similar drug that has a much lower incidence of stomach irritation due to the nature of the active ingredient, route of administration or delivery formulation. 
     DUR Rules for Checking Against Patient Drug and Other Pertinent Information 
     A person having ordinary skill in the art such as a licensed pharmacist would readily appreciate the clinical information concerning interactions of drugs with all of the aforementioned patient specific information. In certain preferred embodiments of the invention, the drug interaction rules and alerts are obtained from commercially available databases such as First DataBank, San Francisco, Calif. In certain more preferred embodiments of the invention, the alerts are modified to be more readily understood by non-clinical users. In still other preferred embodiments, the rules and alerts comprise a combination of commercially available information, customization obtained from medical literature, official compendia, and manufacturer labeling. In certain preferred embodiments different rule collections are stored in different databases and can be accessed by the system individually or in combination in a given DUR checking process. 
     In certain other embodiments of the invention, the DUR rules are capable of distinguishing between a one-time fill of a prescription drug and a cumulative use. In certain cases, the risk of interaction increases with cumulative use because the plasma concentrations can rise over continuous use. In other examples, enzymes involved in drug activation or elimination can be increased or decreased by certain drug therapies with cumulative use. 
     In certain preferred embodiments, the information needed to perform the drug interaction checker is continuously available and upgraded. An example of such object data grid is described in commonly assigned U.S. patent application Ser. No. 13/296,825 filed on Nov. 15, 2011, the disclosure of which is hereby incorporated by reference in its entirety. 
     Identifying Potentially Interacting Products 
     While it will be readily understood by a person of ordinary skill, certain OTC products can potentially lead to drug interactions. However, in certain embodiments of the invention, certain products available through the web-based commerce platform have no potential for drug interaction. Typical products would include those devoid any pharmacological agent such as surgical tape or cotton swabs. In these cases, the system and process of the invention comprises capability to exclude these products from a DUR check while identifying products that are intended to come in contact with the body, typically via oral ingestion, and contain a pharmacologically active agent. 
     Authorization to Share Patient Drug History and Other Information 
     In certain embodiments of the invention the system and process is capable of obtaining an authorization to share prescription drug information, as well as all other pertinent patient information described herein. In certain preferred embodiments, the authorization complies with any and all state and federal privacy requirements prior to the information being submitted to the drug interaction checker. 
     Acute or Chronic Designation. 
     The designation by the user of a selected OTC product as acute or chronic would be readily understood by a person having ordinary skill in the art to have a readily understood timeframe based on the drug and condition for being treated. Acute use is one time or single episodic use for a condition that subsides in a short time, typically about 1-14 days, more preferably about 1-5 days. For the purposes of the present invention, chronic use is meant to include use for a duration. longer than acute use. In certain embodiments, about 5 days to about 2 years, or more preferably about 2 weeks to about 12 months. 
     In certain preferred embodiments, a chronic designation would be added to the patient&#39;s drug profile for consideration in subsequent DUR screens. In other preferred embodiments, OTC products intended for acute use are not saved in the patient&#39;s drug history. 
     Drug Interaction Screening/Identification/Alerting 
     Drug interaction screening would allow the one′ or more products to be compared against all relevant drug data. Where the rules identify an interaction and associated severity level, an alert is communicated to the user. 
     In certain preferred embodiments where an identified interaction is severe, the invention comprises the capability to advise the user (a) the product is not recommended for purchase for the identified patient, (b) will prevent completion of the purchase of the selected interacting product, (c) the user may discuss the interaction alert with a pharmacist via telephone or other communication method (d) providing a user acknowledgement of the interaction and allowing the transaction to proceed, or (e) combinations thereof. 
     Suggestion of Alternative Safer Options 
     In certain preferred embodiments of the invention, the system and process has the capability to suggest a safer product than the OTC product selected by the user. One of ordinary skill in the art will readily appreciate such alternatives, and would generally include those that don&#39;t interact with the given element or elements specific to the patient&#39;s information leading to the interaction. By way of example, a patient may be allergic to aspirin. Where the patient information is devoid of elements leading to an interaction with acetaminophen, the system would suggest a switch from aspirin to acetaminophen. Other permutations of interactions and safer suggestions would be readily known to those having ordinary skill the pharmaceutical arts or access to such information in regular pharmacy practice settings. 
     Drug Safety Check shall be performed during the checkout process on the Store site:
         Drugstore to submit a request to the Medco/Rules Service   Medco/Rules Service to execute the Drug Safety Check   Medco to send results back to Drugstore   Drugstore to display (if any) alerts/warning messages to the user       

     Three high level services will be invoked by the DrugStore System when a user checks out some products on the Store&#39;s site. 
     1) UPC/NDC Mapper Service 
     2) Drug Safety Check Service 
     3) Logging Service 
     An additional service is exposed to renew the LTPA Session Token when the user navigates across DrugStore&#39;s site—since the initial token is only valid for 30 minutes, this ‘Heartbeat’ service can keep the session alive so that the user can successfully navigate back to Medco&#39;s site as needed.
         KeepSession Service       

     Initial LTPA Token Delivery 
     The request for data is initiated by a user using an internet application and requesting for data, which is then received by the DrugStore&#39;s server. The DrugStore server receives the request and then decides if it needs information from Medco, and then initiates an XML Request to a predefined Medco Web Service Endpoint. The authentication and authorization is done by means of an LTPA (Lightweight Third-Party Authentication) token that is issued by the Medco&#39;s System and which is included in the SAML Packet during the initial SSO Cross-over from Medco.com to DrugStore.com. 
     In the first step as illustrated in  FIG. 1 , during the transfer from Medco&#39;s site to the DrugStore site via SSO, the LTPA token is included in the SAML packet along the other existing data. The DrugStore application is then responsible for passing the LTPA Token in all requests from then on. 
     As illustrated in  FIG. 2 , after receiving the token, DrugStore can call Medco&#39;s services for additional information to fulfill the user&#39;s activity on the DrugStore.com site as required. The LTPA Token is required for each request (Set in a specific HTTP Header given in the implementation section) 
     Each successful request then renews the token and a new token is sent back, DrugStore must ensure that the new token is then used in all subsequent requests to prevent session timeout. 
     A mapper service maps given UPCs to their corresponding NDCs. This does not return the alert messages, but rather just returns all the NDCs for the products that are “DURable”. This service will be invoked only for the first time when the Drug Safety Check Indicator is null in the user&#39;s profile at DrugStore. The user will be prompted by the DrugStore&#39;s website for this information and all consequent calls would be based on it. The user will also be provided with an option of updating the Indicator on DrugStore&#39;s website. 
     If there are changes to the items in the shopping cart of the user and if DrugStore has already had the UPCs mapped to their NDCs, then DrugStore should send Medco the corresponding NDCs that were previously returned to avoid unnecessary duplicate calls that may need to be done by Medco&#39;s systems in order to map the UPCs to their corresponding NDCs again. The logical process flows are illustrated in  FIGS. 12-13 . 
     Request: 
     The request is an XML Body POST sending the UPC numbers. 
                                     Field Name   Length   Description                                            Request       Root node       TestMode   1   Test Mode functionality, If “Y”, returns a               canned XML Response       Format   4   Always “xml” - Indicates the format of the               response, Default is “json”, should be               always present in this setup.       Channel   3   Used for defaulting values needed by               Medco&#39;s internal systems based on the               caller, Should be “CI-IP” in this case       UPC   12   The standard 12-digit UPC number with       occurs n times       prefix and check-digit. The 10-digit UPC               (without Prefix and check-digit) for which a               corresponding NDC must be mapped by               Medcci, Occurs 0 to n times (Upper Limit               50)                    
Sample XML Request:
 
                                            &lt;?xml version=“1.0” encoding=“UTF-8”?&gt;           &lt;Request&gt;                         &lt;Format&gt;xmk/Format&gt;           &lt;Channel&gt;CHP&lt;/Channel&gt;           &lt;UPC&gt;123456789011&lt;/UPC&gt;           &lt;UPC&gt;123456789012&lt;/UPC&gt;           &lt;UPC&gt;123456789013&lt;/UPC&gt;                         &lt;/Request&gt;                        
Response:
 
The Response is an XML Response that is returned, along with an updated LTPA Token which can be stored internally by DrugStore.
 
The updated token is in a “Set-Cookie” HTTP Response Header having the corresponding value for the key “LtpaToken2”, the value alone can be extracted and used for all consequent requests to Medco&#39;s System.
 
Ex: Set-Cookie: LtpaToken2=&lt;new_token_value&gt;; other=params
 
                                     Field Name   Length   Description                                            Response       Root node       StatusCode   4   Status Code of the Current Transaction               “0000” - Success               “0002” - No DURable NDCs found for               all the UPCs               “9999” - Corresponds to System Error               message               “1900” - Session Timeout/LTPA               Token error               (DrugStore should prompt user to re-               login)       StatusMessage       Status Message of the Current Transaction               “Success” - If StatusCode is “0000”               “No DURable NDCs were found” - If               StatusCode is “0002”               Status Message will be dynamic and               corresponds to the failure - StatusCode               “9999”               This Node is not available if there is a               Token Timeout       Token       Present on Token timeout, Can be ignored -               currently blank, comes from the Main               Proxy service       RoutingUrl       Present on Token timeout, Can be ignored -               currently blank, comes from the Main               Proxy service       RoutingParams       Present on Token timeout, Can be ignored -               currently blank, comes from the Main               Proxy service       ErrorMessage       Present on Token timeout, Can be ignored -               currently blank, comes from the Main               Proxy service,       Product occurs       Wrapper Node for UPC to NBC Maps       n times       (Under Response)       UPC   12   The UPC that was in the original Request as a               key (Under Product)       NDC   11   The NDC for the corresponding UPCs (Under               Product)               Blank if no corresponding NDC is found               for a given UPC               Ex: &lt;NDC/&gt;                    
Sample XML Response:
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
               
                   
                 &lt;Response&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;StatusCode&gt;0000&lt;/StatusCode&gt; 
               
               
                   
                 &lt;StatusMessage&gt;Success&lt;/StatusMessage&gt; 
               
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;UPC&gt;123456789011&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;01234567890&lt;/NDC&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Product&gt; 
               
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;UPC&gt;123456789012&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;01234567891&lt;/NDC&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;UPC&gt;123456789013&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC/&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Response&gt; 
               
               
                   
                   
               
            
           
         
       
     
     The Drug Safety Check Service is a service that will return all the alert messages for a given product based on its interactions with other drugs that are already prescribed or are present in the member&#39;s profile. These alert messages facilitate DrugStore to display alert messages to the user so that they may chose to continue or abort their purchase depending on the severity of the messages. 
     Request: 
     The request is an XML Body POST sending the NDC numbers and UPC numbers that are to be checked for the interactions with other drugs. If DrugStore had previously mapped come UPCs to their NDCs in the current session, they should ideally send Medco the NDCs to avoid a duplicate lookup again. 
                                     Field Name   Length   Description                                            Request       Root node       TestMode   1   Test Mode functionality, If “Y”, returns a               canned XML Response       Format   4   Always “xml” - Indicates the format of the               response, Default is “json”, should be               always present in this setup.       Channel   3   Used for defaulting values needed by               Medco&#39;s internal systems based on the               caller, Should be “CHP” in this case       UPC   12   The standard 12-digit UPC number with       occurs n times       prefix and check-digit. The 10-digit UPC               (without Prefix and check-digit) for which a               corresponding NDC must be mapped by               Medco, Occurs 0 to n times (Upper Limit               50)       NDC   11   The NDC if available already, this will be       occurs n times       used to perform the Drug Safety Check.               Occurs 0 to n times (Upper Limit 50)                    
Sample XML Request:
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
               
                   
                 &lt;Request&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Format&gt;xml&lt;/Format&gt; 
               
               
                   
                 &lt;Channel&gt;CHP&lt;/Channel&gt; 
               
               
                   
                 &lt;UPC&gt;123456789015&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;52421145645&lt;/NDC&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Request&gt; 
               
               
                   
                   
               
            
           
         
       
     
     Response: 
     The Response is an XML Response that is returned, along with an updated LTPA Token which can be stored internally by DrugStore. 
     The updated token is in a “Set-Cookie” HTTP Response Header having the corresponding value for the key “LtpaToken2”, the value alone can be extracted and used for all consequent requests to Medco&#39;s System. 
     Ex: Set-Cookie: LtpaToken2=&lt;new_token_value&gt;;other=params 
                                     Field Name   Length   Description                                            Response       Root node       StatusCode   4   Status Code of the Current Transaction               “0000” - Success               “0002” - No DURable NDCs were found               “1900” - Session Timeout/LTPA Token               error (DrugStore should prompt user, to               re-login)               “3000” - Blob cannot be retrieved (Very               rare error - If this occurs, re-logging in               should fix it, take same action as 1900)               “9999” - Corresponds to System Error               message       StatusMessage   50   Status Message of the Current Transaction               “Success” - If StatusCode is “0000”               “No DURable NDCs were found” - If               StatusCode is “0002”               “Blob cannot be retrieved” - If StatusCode               is “3000”               Status Message will be dynamic and               corresponds to the failure - StatusCode               “9999”               This Node is not available if there is a               Token Timeout       Token       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       RoutingUrl       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       RoutingParams       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       ErrorMessage       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       Product       One node for each matching DURable NDC,       (occurs n)       under Response       UPC   12   UPC for the matching Product (under               Product) If available in the request       NDC   11   NDC for the matching Product (under               Product)       Name   25   The Name of the Drug (under Product)       Alert       Wrapper node for Alert Information, (under       (Occurs n)       Product)       ConflictCde   2   Conflict Code of the Interacting Product               (under Alert)       CategoryCde   3   Category Code of the Interacting Product               (under Alert)       SeverityCde   1   Severity Code of the Interacting Product               (under Alert)       InteractingDrug   25   The Drug whose constituents consist of this               NDC (under Alert)       WarningLevelInd   1   The Red/Yellow Indicator that this message               should display in (under Alert)               0 for None               1 for Yellow               2 for Red       Message       Wrapper Node for the actual alert Message,               (under Alert)       Text   750   The actual text of the error message, (under               Message)                    
Sample Response XML:
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
               
                   
                 &lt;Response&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;StatusCode&gt;0000&lt;/StatusCode&gt; 
               
               
                   
                 &lt;StatusMessage&gt;Success&lt;/StatusMessage&gt; 
               
               
                   
                 &lt;Product&gt; 
               
               
                   
                 &lt;UPC&gt;123456789015&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;72432910778&lt;/NDC&gt; 
               
               
                   
                 &lt;Name&gt;&lt;[CDATA[POTASSIUM CHLORIDE]]&gt;&lt;/Name&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;/ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;DD3 &lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;3&lt;/SeverityCde&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;InteractingDrug&gt;&lt;[CDATA[ENALAPRIL]]&gt;&lt;/InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;WarningLevelInd&gt;l&lt;WarningLevelInd&gt; 
               
               
                   
                 &lt;Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Text&gt;&lt;/[CDATA[This over the counter (OTC) 
               
            
           
           
               
            
               
                 medication may adversely interact with a prescription medication ENALAPRIL that you are also 
               
               
                 taking. These potential interactions should be reviewed by your doctor before making changes in 
               
               
                 therapy.]]&gt;&lt;/Text&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;DD3&lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;3&lt;/SeverityCde&gt; 
               
               
                   
                 &lt;1nteractingDrug&gt;&lt;![CDATA[DIOVAN]]&gt;&lt;/InteractingDrug&gt; 
               
               
                   
                 &lt;WarningLevelInd&gt;1&lt;/WarningLevelInd&gt; 
               
               
                   
                 &lt;Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Text&gt;&lt;/[CDATA[This over the counter (OTC) 
               
            
           
           
               
            
               
                 medication may adversely interact with a prescription medication DIOVAN that you are also 
               
               
                 taking. These potential interactions should be reviewed by your doctor before making changes in 
               
               
                 therapy.]}&gt;&lt;Text&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;NDC&gt;52421145645&lt;/NDC&gt; 
               
               
                   
                 &lt;Name&gt;&lt;[CDATA[EPIPEN JR]]&gt;&lt;Name&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;SDD&lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;l&lt;SeverityCde&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;InteractingDrug&gt;&lt;![CDATA[NORMODYNE]]&gt;&lt;/InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;WarningLevelInd&gt;2&lt;/WarningLevelInd&gt; 
               
               
                   
                 &lt;Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Text&gt;&lt;![CDATA[This over the counter (OTC) 
               
            
           
           
               
            
               
                 medication may adversely interact with a prescription medication NORMODYNE that you are 
               
               
                 also taking. These potential interactions should be reviewed by your doctor before making 
               
               
                 changes in therapy.]]&gt;&lt;/Text&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Message&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
               
                   
                 &lt;/Response&gt; 
               
               
                   
                   
               
            
           
         
       
     
     A Logging Service is optionally provided that can be used to update a member&#39;s profile based on what the member has checked out if it has any interactions with other Drugs. This is primarily for Self Reported OTC logging and CCF (used for Customer Service Tracking) on Medco&#39;s end and updates the Member&#39;s profile. 
     This Service will be invoked every time irrespective of whether the Drug Safety Check was called when the Order is confirmed or checked out at the DrugStore Online Store. 
     Request: 
     The request is an XML Body POST having the necessary fields as documented below. 
                                     Field Name   Length   Description                                            Request       Root node       TestMode   1   Test Mode functionality, If “Y”, returns a               canned XML Response       Format   4   Always “xml” - Indicates the format of the               response, Default is “json”, should be always               present in this setup.       Channel   3   Used for defaulting to values needed by               Medco&#39;s internal systems based on the caller,               Should be “CHP” in this case       Order -       Parent node under Request       Occurs 1       ConfirmationNbr       Confirmation number       Sessionld   30   BV Sessionld       DURInd   2   DUR Indicator about the order (With DUR               or Without DUR)               0 - Without DUR               1 - With DUR               99 - DUR call Failed       Product -       Product Wrapper node under Order       Occurs n       SelfInd   1   Product for Self Indicator       RegularBasisInd   1   Product taken on Regular Basis Indicator       UPC   12   UPC for the matching Product (under               Product) The standard 12-digit UPC number               with prefix and check-digit.       NDC   11   NDC for the matching Product (under               Product)       Alert       Wrapper node for Alert Information, (under       (Occurs n)       Product)       ConflictCde   2   Conflict Code of the Interacting Product               (under Alert)       CategoryCde   3   Category Code of the Interacting Product               (under Alert)       SeverityCde   1   Severity Code of the Interacting Product               (under Alert)       InteractingDrug   25   The Drug whose constituents consist of this               NBC (under Alert)       WarningLevelInd   1   The Red/Yellow Indicator that this message               should display in (under Alert)               0 for None               1 for Yellow               2 for Red                    
Sample XML Request:
 
     
       
         
           
               
             
               
                   
               
             
            
               
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Request&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Format&gt;xml&lt;/Format&gt; 
               
               
                   
                 &lt;Channel&gt;CHP&lt;/Channel&gt; 
               
               
                   
                 &lt;Order&gt; 
               
            
           
           
               
            
               
                 &lt;ConfirmationNbr&gt;123455655544&lt;/ConfirmationNbr&gt; 
               
               
                 &lt;Session1d&gt;@@@@2028102284.1220626361@@@@&lt;/SessionId&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;DURInd&gt;1&lt;/DURInd&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;SelfInd&gt;1&lt;/SelfInd&gt; 
               
               
                   
                 &lt;RegularBasisInd&gt;l&lt;/RegularBasisInd&gt; 
               
               
                   
                 &lt;UPC&gt;123456789011&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;01234567890&lt;/NDC&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;/ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;DD3&lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;3&lt;/SeverityCde&gt; 
               
               
                   
                 &lt;InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/[CDATA[ENALAPRIL]]&gt; 
               
               
                   
                 &lt;InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;WarningLevelInd&gt;l&lt;/WarningLevelInd&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;/ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;DD3&lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;3&lt;/SeverityCde&gt; 
               
               
                   
                 &lt;InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;![CDATA[DIOVAN]]&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/InteractingDrug&gt; 
               
               
                   
                 &lt;WarningLevelInd&gt;1&lt;/WarningLevelInd&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
               
                   
                 &lt;Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;SelfInd&gt;l&lt;/Selfind&gt; 
               
               
                   
                 &lt;RegularBasisInd&gt;l&lt;/RegularBasisInd&gt; 
               
               
                   
                 &lt;UPC&gt;123456789012&lt;/UPC&gt; 
               
               
                   
                 &lt;NDC&gt;01234567891&lt;/NDC&gt; 
               
               
                   
                 &lt;Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;ConflictCde&gt;DD&lt;/ConflictCde&gt; 
               
               
                   
                 &lt;CategoryCde&gt;DD1&lt;/CategoryCde&gt; 
               
               
                   
                 &lt;SeverityCde&gt;2&lt;/SeverityCde&gt; 
               
               
                   
                 &lt;InteractingDrug&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/[CDATA[NORMODYNE]]&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;InteractingDrug&gt; 
               
               
                   
                 &lt;WarningLevelInd&gt;2&lt;/WarningLevelInd&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Alert&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Product&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Order&gt; 
               
            
           
           
               
            
               
                 &lt;/Request&gt; 
               
               
                   
               
            
           
         
       
     
     Response: 
     The Response is an XML Response that is returned, along with an updated LTPA Token which can be stored internally by DrugStore. 
     The updated token is in a “Set-Cookie” HTTP Response Header having the corresponding value for the key “LtpaToken2”, the value alone can be extracted and used for all consequent requests to Medco&#39;s System. 
     Ex. Set-Cookie: LtpaToken2=&lt;new_token_value&gt;; other=params 
                                     Field Name   Length   Description                                            Response       Root node       StatusCode   4   Status Code of the Current Transaction               “0000” - Success               “0001” - CCF Successful but Profile               Update Failed               “0002” - Profile Update Successful but               CCF Failed               “0003” - Both CCF and Profile Update               Failed               “1900” - Session Timeout/LTPA Token               error               “9999” - Corresponds to System Error               message               “3000” - Blob cannot be retrieved (Very               rare error)       StatusMessage   50   Status Message of the Current Transaction               “Success” - If StatusCode is “0000”               “CCF Successful but Profile Update               Failed” - If StatusCode is “0001”               “Profile Update Successful but CCF               Failed” - If StatusCode is “0002”               “Both CCF and Profile Update Failed” - If               StatusCode is “0003”               “Blob cannot be retrieved” - If StatusCode               is “3000”               Status Message will be dynamic and               corresponds to the failure - StatusCode               “9999”               This Node is not available if there is a               Token Timeout                    
Sample Response XML:
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
               
                   
                 &lt;Response&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;StatusCode&gt;0000&lt;/StatusCode&gt; 
               
               
                   
                 &lt;StatusMessage&gt;Success&lt;/StatusMessage&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Response&gt; 
               
               
                   
                   
               
            
           
         
       
     
     A KeepSession Service is a service that allows an LTPA Session token to be renewed without any other backend action done by Medco. The sole purpose of this service is to renew a valid LTPA token and return a new token that is valid for an additional 30 minutes from the time it is generated. If the incoming token is invalid, a timeout xml message is returned. 
     Request: 
     The request is an XML Body POST having any well-formed XML, But since the Request/Format node should be “xml” to get an XML Response, it should be used here (instead of just any xml), without which the Medco Service would default to JSON. 
                                                 Field Name   Length   Description                          Request       Root node           Format   3   Hardcoded as “xml” - Under Request                        
Sample XML Request:
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;?xml version=“1.0” encoding=“UTF-8”?&gt; 
               
               
                   
                 &lt;Request&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;Format&gt;xml&lt;/Format&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Request&gt; 
               
               
                   
                   
               
            
           
         
       
     
     Response: 
     The Response is an XML Response that is returned, along with an updated LTPA Token which can be stored internally by DrugStore to be reused in subsequent Medco Requests. 
     The updated token is in a “Set-Cookie” HTTP Response Header having the corresponding value for the key “LtpaToken2”, the value alone can be extracted and used for all consequent requests to Medco&#39;s System. 
     Ex: Set-Cookie: LtpaToken2=&lt;new_token_value&gt;; other=params 
     Response 
                                     Field Name   Length   Description                  Response       Root node       StatusCode   4   Status Code of the Current Transaction               “0000” - Successfully renewed token, No               StatusMessage is provided to keep the size of               the response small.               “1900” - Session Timeout/LTPA Token error       Token       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       RoutingUrl.       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       RoutingParams       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service       ErrorMessage       Present on Token timeout, Can be ignored -               currently blank, comes from the Main Proxy               service                    
Sample Response XML:
 
The updated LTPA token is present in a Set-Cookie HTTP Response Header
 
Successful Response
 
                                            &lt;?xml version=“1.0” encoding=“UTF-8”?&gt;           &lt;Response&gt;                         &lt;StatusCode&gt;0000&lt;/StatusCode&gt;                         &lt;/Response&gt;                        
If Timeout (Ask User to Login)
 
     
       
         
           
               
               
             
               
                   
                   
               
             
            
               
                   
                 &lt;Response&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;StatusCode&gt;1900&lt;/StatusCode&gt; 
               
               
                   
                 &lt;Token/&gt; 
               
               
                   
                 &lt;RoutingUrl/&gt; 
               
               
                   
                 &lt;RoutingParams/&gt; 
               
               
                   
                 &lt;ErrorMessage/&gt; 
               
            
           
           
               
               
            
               
                   
                 &lt;/Response&gt; 
               
               
                   
                   
               
            
           
         
       
     
     Drugstore to ping the KeepSession service call before the valid LTPA Token expires i.e. 30 minutes. This will ensure the LTPA Token is always valid, never expires, and prevents the service call timeouts. Use the renewed/updated LTPA Token every time to pass in the service calls. 
     While the foregoing description and drawings represent the preferred embodiments of the present invention, it will be understood that various additions, modifications, combinations and/or substitutions may be made therein without departing from the spirit and scope of the present invention as defined in the accompanying claims. In particular, it will be clear to those skilled in the art that the present invention may be embodied in other specific forms, structures, arrangements, proportions, and with other elements, materials, and components, without departing from the spirit or essential characteristics thereof. One skilled in the art will appreciate that the invention may be used with many modifications of structure, arrangement, proportions, materials, and components and otherwise, used in the practice of the invention, which are particularly adapted to specific environments and operative requirements without departing from the principles of the present invention. In addition, features described herein may be used singularly or in combination with other features. The presently disclosed embodiments are therefore to be considered in all respects as illustrative and not restrictive, the scope of the invention being indicated by the appended claims, and not limited to the foregoing description.