Tatmeen is the regulatory system that supports the track and trace legislation to the pharmaceutical industry in the United Arab Emirates (UAE) market.


List of Procedures


For more information on the general channel actions, see Managing Channels for a Tenant (Overview).


Configuring a Tatmeen (UAE) Channel


Before You Begin


Make sure that a technical user is onboarded in Tatmeen and owns the credentials:

  • API key
  • Sign-on ID
  • Password


The Marketing Authorization Holder (MAH) can onboard the technical user in Tatmeen for you.


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.



4. Depending on your setup, create a Tatmeen (UAE) channel or modify an existing one. Follow one of the procedures described in the table below.


#Create a ChannelModify an Existing Channel
4.1Click the + icon (Create channel). The application displays the Create channel dialog.

To search for a Tatmeen (UAE) channel, use the search criteria field and the filters:

  • Enter the channel name in the search criteria field.
  • Select the status.
  • Select Tatmeen (UAE) as the source.
  • Select Regulatory channel as the type.
4.2Select Regulatory channel as the type and click Create.

The application displays the Create Channel page with an empty form to give the basic parameters of the channel.
To view the channel information, click the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page with the current channel settings.
4.3Enter a name for the channel and select Tatmeen (UAE) as the source.N/A
4.4

Click Create Channel.


The application informs you about the additional costs. After confirming the creation, the application displays the Edit Channel page with a form where you can provide the connection details for the channel.

N/A


Example when creating a Tatmeen (UAE) channel:



5. Provide the Tatmeen (UAE) channel settings as explained in the table below.


Function/ParameterAction
Connection typeSelect the type of connection to Tatmeen.
  • Manufacturers (MAH)
  • Logistics
  • Dispensers


When you act as a 3PL for a MAH and you send manufacturing reports to Tatmeen on behalf of the MAH, select Manufacturers (MAH).

API key

Enter the API key obtained from Tatmeen. This key identifies the API connection to Tatmeen.

Sign-on IDEnter your sign-on ID in Tatmeen.
PasswordEnter your password belonging to your sign-on ID in Tatmeen.
Support e-mailEnter the email address that Movilitas.Cloud can use to send notifications about errors.


6. Click Save Settings


7. (Optional) If needed, change the name of the channel and click Save Channel.


Back to the list of procedures



Managing Tatmeen Messages


You can view the messages sent to Tatmeen from Movilitas.Cloud with their status:

  • If the application cannot send the message to Tatmeen due to an issue at Tatmeen, you can resend the message to Tatmeen.
  • If Tatmeen does not accept the message, there is an error.
  • If Tatmeen accepts the message, the application sends the message status query to Tatmeen to get the processing result. If the initial message status query is not successful, you can resend the query to Tatmeen.
  • If Tatmeen accepts the message, processes it, and the message status query is positive (no error), then the message is successful.


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Find the Tatmeen (UAE) channel. Use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select Tatmeen (UAE) as the source.
  • Select Regulatory channel as the type.


5. To view the Tatmeen (UAE) channel information, click the edit icon (Edit channel) next to the channel. The application displays the Tatmeen (UAE) settings and Documents.


Example:



6. To view the messages, click the Messages tab.


By using the search field you can easily find the message you need. You can enter specific data from the file, for example, a serial number or a batch (LOT) number, and the list of messages is filtered based on the search criteria.


In the following example, the messages are filtered based on SGTIN and the search result is expanded:



For the messages, the following parameters and functions are displayed:


Parameter/FunctionDescription
> (Expand) icon

You can view the details of the message.

Status

Status of the message:

  • Success (Checkmark icon) - Tatmeen accepted the message, processed it, and the result of the message status query is positive (no error).
  • Accepted (Yellow exclamation mark) - Tatmeen accepted the message but the message status query is not successful. The processing is in progress or is completed. The message status query can fail due to an issue at Tatmeen (Tatmeen is not reachable) or can give one or more errors.
  • Failed (Red exclamation mark) - It was not possible to send the message to Tatmeen due to an issue at Tatmeen.
  • Error (Red exclamation mark) - Tatmeen did not accept the message and sent back an error.
Request type

The following request types are displayed on the Messages tab:

  • Send EPCIS
Sent DatetimeThe timestamp when the message was sent to Tatmeen.
Sender GLNThe GLN of the sending entity.
Receiver GLNThe GLN of the receiving entity. This is Tatmeen.
Comments

An optional message providing further details in one of the following cases:

  • The message status is Error.
  • The message status is Accepted but the message status query is not successful. The user can resend the message status query.
Resend buttonIf sending the message fails due to an issue at Tatmeen, for example, Tatmeen is down, the application displays this button to resend the message.
Check status buttonIf the message status query is not successful, you can resend the message status query to Tatmeen by clicking on the button.


Back to the list of procedures



Sending Documents Manually


You may want to send a file to Tatmeen manually. For example, the message failed in Tatmeen and you want to resend the correct message. You can enter the XML content and send it manually.

 

IMPORTANT: Before sending the document, make sure that the description contains a unique instance identifier.


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Find the Tatmeen (UAE) channel. Use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select Tatmeen (UAE) as the source.
  • Select Regulatory channel as the type.


5. To view the Tatmeen (UAE) channel information, click the edit icon (Edit channel) next to the channel. The application displays the Tatmeen (UAE) settings and Documents.


Example:



6.  On the Documents panel, select the Send document manually tab. The application displays an empty field where you can enter XML content.


Example:



7. Enter the XML content (EPCIS) in the field. 


IMPORTANT: Make sure that the description contains a unique instance identifier.


The application has a built-in validator to detect invalid content.


Example:



8. Click Send Document Manually. The message is sent to Tatmeen and a log is created under the Messages tab.


Next Steps


Select the Messages tab and verify that the message is successfully processed in Tatmeen.


Back to the list of procedures