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 Channel | Modify an Existing Channel |
---|---|---|
4.1 | Click 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:
|
4.2 | Select 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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings. |
4.3 | Enter 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/Parameter | Action |
---|---|
Connection type | Select the type of connection to Tatmeen.
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 ID | Enter your sign-on ID in Tatmeen. |
Password | Enter your password belonging to your sign-on ID in Tatmeen. |
Support e-mail | Enter the email address where Movilitas.Cloud can send notifications about warnings/failures/errors on the channel. |
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 waits for 30 seconds and then sends the message status query to Tatmeen for 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 warning, 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 on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Tatmeen (UAE) settings and Documents.
Example:
6. To view the messages, select 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, an SGTIN is entered in the search field and then the search result is expanded (truncated screenshot):
For the messages, the following parameters and functions are displayed:
Parameter/Function | Description |
---|---|
> (Expand) icon | You can view the details of the message. |
Status | Status of the message:
|
Request type | The following request types are displayed on the Messages tab:
|
Sent Datetime | The timestamp when the message was sent to Tatmeen. |
Sender GLN | The GLN of the sending entity. |
Receiver GLN | The GLN of the receiving entity. This refers to the client that received the shipment. However, the receiver GLN in the EPCIS refers to Tatmeen. |
Comments | An optional description providing further details in one of the following cases:
|
Resend button | If 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 button | The application displays this button to send the message status query to Tatmeen in the following cases:
|
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 on the channel name or 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