A stakeholder in the USA market can receive a TI trace request for a product from a state authority through the Pulse portal. If the trace request is received by email in Movilitas.Cloud, the stakeholder can download the JSON file of the trace request in the Reports & Analysis application. As per the DSCSA requirements, the stakeholder must provide the product master data and the details of the product flow related to that stakeholder. The stakeholder can collect these data in the Reports & Analysis application and then add the response on the Pulse portal or construct the JSON file of the trace response and send the response back to the requester.


If the stakeholder wants to place a TI trace request in an external system, the stakeholder can download the JSON file of the trace request or send the JSON file of the trace request by email in the Reports & Analysis application. The trace request is initiated from Movilitas Mobile in the DSCSA Product Verification & Tracing application or received by email in Movilitas.Cloud. Then, the stakeholder can use the JSON in the external trace management system to submit the trace request.


List of Procedures


Executing a Trace Request On-Demand


By entering the product code (GTIN) and serial, the application returns the product master data and visualizes the product flow in the system. You can verify the data and use the data to create the response to the trace request on the Pulse portal.


Procedure


1. In the Reports & Analysis application, select DSCSA --> Trace Request


The application displays a page with two sections:

  • Fields to enter the product GTIN and the serial number.
  • List of trace requests performed in the DSCSA Product Verification & Tracing application ready for download (JSON).


The following example illustrates the case when the page is opened. Trace requests are not available to download:



2. Enter the GTIN and the serial number.


3. Click Trace. The application displays the following:

  • Product master data
  • Inbound transaction details
  • Outbound transaction details
  • Product flow as supplier details --> warehouse details --> client details.


Example:



Back to the list of procedures



Downloading the JSON File of a Trace Request


You can download the JSON file of a trace request. The trace request can come from two sources:

  • The trace request is initiated from Movilitas Mobile in the DSCSA Product Verification & Tracing application.
  • The trace request is received by email at TI_request@movilitas.cloud with the JSON file of the trace request as an attachment.


Procedure


1. In the Reports & Analysis application, select DSCSA --> Trace Request


The application displays a page with two sections:

  • Fields to enter the product GTIN and the serial number.
  • List of trace requests.


The following example illustrates the case when the page is opened. The trace requests are listed in a paginated view:



2. Find the trace request you want to download by checking the trace request ID, the date and time of creation, and the organization.


Example:



3. Click on the download icon (Download JSON) next to the trace request in the Action column.


4. Save the JSON file to your local computer.


5. Open the file and verify its content.

  • If the request is initiated from Movilitas.Cloud, the JSON file contains the application configuration data and the data given in the DSCSA Product Verification & Tracing application.
  • If the request is received by email in Movilitas.Cloud, the content is controlled by the sending system.


The structure of the JSON file is independent of the source and complies with the Partnership for DSCSA Governance (PDG) requirements.


The following table describes how the data is populated when initiating the request from Movilitas.Cloud:


DataDescription
Request IDAuto-generated UUID.
Request timestampDate and time of the trace request in UTC format.
Contact information
  • The requesting organization name - The tenant in Movilitas.Cloud.
  • The contact method - The email address or phone number as given in the Verification Request Contact Information settings of the operator in the DSCSA Product Verification & Tracing application. Otherwise, the email address of the operator.
Callback addressA fixed endpoint in Movilitas.Cloud to receive the response.
Requester GLN

The GLN value that is provided in the DSCSA Product Verification & Tracing application under the Settings tab.

Request parametersThe data entered by the user in Movilitas Mobile in the DSCSA Product Verification & Tracing application:
  • Response type
  • Investigation reason
  • Investigation circumstances
  • 3911 incident number
  • Recall depth (if given)
  • Recall request level (if given)
RequestsThe requests are organized into line items. Each line item holds the product data as scanned or entered in Movilitas Mobile in the DSCSA Product Verification & Tracing application:
  • Line item number
  • Product ID (GTIN)
  • Serial number or batch (lot)


JSON example:


{
  "tiRequestSet": {
    "tiRequestAuditReferences": {
      "tiRequestID": "cb15f73a-bb6b-4b77-9ad3-e25df4bfcc40",
      "tiRequestTimestamp": "2023-10-09T21:48:51.000Z"
    },
    "tiRequestingPartyInformation": {
      "contactInformation": {
        "organizationName": "Engineering Industries Excellence",
        "contactMethod": "admin@movilitas.cloud"
      },
      "callbackAddress": {
        "apiCallbackAddress": "pts-environment.movilitas.cloud/response"
      },
      "requesterGLN": "2996133448223"
    },
    "tiRequestParameters": {
      "responseTypeRequested": "Transaction Information",
      "investigationReasonAttestation": "Compliance Audit",
      "investigationCircumstances": "This is a test to complete a compliance audit",
      "3911IncidentNumber": "3911-1009-01",
      "recallDepth": "Wholesale Distributor"
    },
    "tiRequests": [
      {
        "requestLineNumber": 2,
        "productID": "00338300905276",
        "serialNumberOrLotNumber": "JU8NNNSJ02R7ZL"
      },
      {
        "requestLineNumber": 1,
        "productID": "00338300555778",
        "serialNumberOrLotNumber": "MVCSN3048"
      }
    ]
  }
}


Next Steps


Perform one of the following (as applicable):

  • Place the trace request (JSON) in the external system that is used for trace management
  • Construct the trace response (JSON) for the trace request and send the response to the requester (outside Movilitas.Cloud).


Back to the list of procedures



Sending the JSON File of a Trace Request by Email


You can send the JSON file of a trace request by email. The trace request can come from two sources:

  • The trace request is initiated from Movilitas Mobile in the DSCSA Product Verification & Tracing application.
  • The trace request is received by email at TI_request@movilitas.cloud with the JSON file of the trace request as an attachment.


Procedure


1. In the Reports & Analysis application, select DSCSA --> Trace Request


The application displays a page with two sections:

  • Fields to enter the product GTIN and the serial number.
  • List of trace requests.


The following example illustrates the case when the page is opened. The trace requests are listed in a paginated view:



2. Find the trace request you want to send by checking the trace request ID, the date and time of creation, and the organization.


The application also shows the date and time of the most recent email sending (if any).


Example:



3. Click on the send icon (Email Trace request as attachment) next to the trace request in the Action column.


The application displays a pop-up to enter the email address.


4. Enter the email address.


Example:



5. Click Send.


The application sends the JSON file of the trace request to the specified email address as an attachment. The application records the timestamp in the Email datetime column.


Next Steps


Place the trace request (JSON) in the external system that is used for trace management.


Back to the list of procedures