Movilitas.Cloud application provides the TraceLink Partner channel to establish a connection to TraceLink.


For SFTP connections, the users can manage the incoming transactions (=from TraceLink) and the outgoing transactions (=towards TraceLink).


In the scenario when Movilitas.Cloud - including the Serialized Manufacturing application - acts as a gateway between SAP ATTP and TraceLink systems for serialization purposes, Movilitas.Cloud automatically uploads the files to TraceLink and automatically downloads the response files from TraceLink:

  • If a transaction fails, you can get a notification from Movilitas.Cloud and take the necessary actions.
  • You can view the status and other details of the outgoing transactions.
  • You can manually upload a file to TraceLink and you can monitor the processing of the file.
  • For an incoming transaction where the automatic download failed, you can view and copy the content of the file by accessing the related TraceLink folder directly from Movilitas.Cloud.


List of Procedures


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



Configuring a TraceLink Channel


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 new TraceLink channel or modify an existing one. Follow one of the procedures described in the table below.


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

To search for a TraceLink channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select TraceLink Partner as the source.
  • Select Business channel as the type.
4.2
Select Business 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.3
Enter a name for the channel and select TraceLink Partner as the source.N/A
4.4Click 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 TraceLink channel:



5. Provide the settings for the TraceLink channel as explained in the table below:


ParameterAction
Support e-mailEnter the email address that Movilitas.Cloud can use to send notifications about errors. The email will contain the name of the TraceLink channel with a link to the channel page where the error occurred.
Company identifierEnter the TraceLink company identifier of your company. Identifies the sender company in the outbound TraceLink files.
Select type of connectionSelect the type of connection:
  • HTTP
  • SFTP


The rest of the connection settings changes depending on the selected type of connection.

Select environmentFor SFTP connection, select the environment:
  • Test
  • Production
SFTP usernameFor SFTP connection, enter the username.
SFTP passwordFor SFTP connection, enter the password.
HTTP HostFor HTTP connection, enter the host URL.
HTTP PortFor HTTP connection, enter the port.
HTTP UsernameFor HTTP connection, enter the username.
HTTP PasswordFor HTTP connection, enter the password.


Example:


 

6. Click Save Settings.


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


Next Steps


Configure the relevant application with the TraceLink channel.


Back to the list of procedures


Managing Files That Were Not Downloaded Automatically from TraceLink (Inbox)


The Inbox tab points to the Outbox folder of TraceLink. After selecting a transaction type, you can check the files that are still in the TraceLink folder for one of the following reasons:

  • For the SOM_SHIPMENT_EVENT transaction type, Movilitas.Cloud does not support automatic download and you need to manually take the file.
  • For the SNX_RESPONSE transaction type, there was an error and the file was not downloaded automatically from TraceLink, therefore, the file is not processed. For example, the response file was not placed in the TraceLink folder related to the transaction type on time (timeout issue). Another example is that the response file does not contain the expected content, but an error message.


You can view the details and copy the content to the clipboard to save the content into a file.


Note: For the SNX_RESPONSE transaction type, the normal business logic is that Movilitas.Cloud automatically downloads and processes the response file, and then deletes the file in TraceLink. These successfully processed files are not listed on this page.


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. To search for a TraceLink channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select TraceLink Partner as the source.
  • Select Business channel as the type.


5. 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 and the TraceLink SFTP Transactions panel. By default, the Inbox tab is selected on the panel.


6. Under the Inbox tab, select the transaction type. The transaction type follows the folder name used in TraceLink.


Transaction TypeDescription
SNX_RESPONSEA file for this transaction contains serial numbers or SSCCs as a response to the corresponding SNX_REQUEST transaction.

Automatic download and processing are supported. Therefore, the files listed for this transaction type were not downloaded automatically due to an error.
SOM_SHIPMENT_EVENTA shipment file containing the list of items produced by a manufacturer.

You need to manually check the file content. Automatic download and processing are not supported.


After selecting the transaction type, the application displays the list of files that are still in the TraceLink folder waiting for taking them:

  • For each file, you can see the file name, the file size, and the date of the last modification.
  • Each file can be expanded for the content.


In the following example, we selected the SNX_RESPONSE transaction type to view the files that were not downloaded automatically due to an error:


 

7. Click Refresh on the top-right corner to see the latest files.


8. Expand a file for the details by clicking the > (Expand) icon on the left.


The application displays the content of the XML file.


In the following example, we are expanding one of the files (SNX_RESPONSE):



Note: For an SNX_RESPONSE transaction, you can check the request ID and look for the corresponding SNX_REQUEST transaction under the Outbox tab.


To have the XML content, click on the Copy the XML to the clipboard icon and save the content into a file.


Example:




Back to the list of procedures



Monitoring Outgoing SFTP Transactions (Outbox)


The Outbox tab points to the Inbox folder of TraceLink. After selecting a transaction type, you can monitor the status of transactions, detect any issue that occurred while uploading the files, and investigate the transaction details. You can copy the content of the XML to the clipboard to save the content into a file.


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. To search for a TraceLink channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select TraceLink Partner as the source.
  • Select Business channel as the type.


5. 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 and the TraceLink SFTP Transactions panel. By default, the Inbox tab is selected on the panel.


6. Select the Outbox tab and then select the transaction type. The transaction type follows the folder name used in TraceLink.


Transaction TypeDescription
SNX_REQUESTUsed for Serial Number Request files. The file can contain requests for pack serial numbers or for SSCCs.
SNX_DISPOSITION_ASSIGNEDUsed for Commissioning Request files. The file can contain stand-alone packs and containers (SSCCs) including the aggregation details.


After selecting the transaction type, the application displays the list of files that have been uploaded to the applicable TraceLink folder:

  • For each transaction, you can see the status, request ID, date and time of sending, sender, receiver, and comments.
  • Each transaction can be expanded for further details.


In the following example, we are viewing the SNX_REQUEST transactions:



The status of the transaction can be one of the following:


StatusDescription
Finished (Green)The transaction was successful. The file is successfully uploaded to the applicable folder in TraceLink.
PendingThe processing of the transaction is pending. Uploading the file to TraceLink is in progress. Wait for the transaction to be completed.
Error (Red)An error occurred while uploading the file to TraceLink. The transaction failed. You need to investigate the issue.


7. Click Refresh on the top-right corner to see the latest transactions.


8. Search for a transaction by entering the request ID, the sender ID, or the receiver ID in the search field. The list of transactions is filtered based on the search criteria.


Note: The searching is performed in the XML of the transaction.


9. Click the > (Expand) icon on the left to see the details of the transaction and to copy the content to the clipboard:

  • Request XML
  • Last raw response (only for successful transactions)


EXAMPLE 1


We are searching for the transaction with request ID "20220309170337023". The transaction failed. We are expanding it to see the details of the request. There is no response:



To have the content of the XML, click on the Copy the XML to the clipboard icon and save the content into a file.



EXAMPLE 2


In the following example, we are searching for the transaction with request ID "20220323110355422". The transaction is successful. After expanding the transaction, the following are displayed:

  • Request XML
  • Last raw response

The Last raw response contains the requested items.



To have the content of the request or the last raw response, click on the Copy the XML to the clipboard icon and save the content into a file.


Example:



Next Steps


For failed transactions, investigate the issue and find the root cause. If needed, you can manually upload the file to TraceLink.


Back to the list of procedures


Uploading a File to TraceLink through SFTP (Outbox)


The Outbox tab points to the Inbox folder of TraceLink. After selecting a transaction type, you can import an XML file from your local computer to Movilitas.Cloud and then you can upload the file to TraceLink. The transaction type specifies which TraceLink folder to use for the upload. Only XML files are allowed and content validation is performed in the background.


In the normal case, Movilitas.Cloud automatically uploads the file to TraceLink. You need to manually upload a file because of an error, for example, the automatic upload of the file failed. Investigate the issue before uploading a file manually.


Before You Begin


For the SNX_REQUEST transaction, make sure that the XML file you want to upload contains a unique request ID in the description:

  • The request ID must be different from the one in the original XML file that failed.
  • It is not possible to upload an XML file that contains an already used request ID.
  • Uploading an XML file that does not contain a request ID will fail.
  • For the request ID, the allowed data type is "string". Movilitas.Cloud generates request ID based on timestamp, in the format of YYYYMMDDHHMMSSsss, where Y - Year, M - Month, D - Day, H - Hour, M - Minute, S - Second, s - Millisecond.


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. To search for a TraceLink channel, use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select TraceLink Partner as the source.
  • Select Business channel as the type.


5. 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 and the TraceLink SFTP Transactions panel. By default, the Inbox tab is selected on the panel.


6. Select the Outbox tab and then select the transaction type. The transaction type follows the folder name used in TraceLink.


Transaction TypeDescription
SNX_REQUESTUsed for Serial Number Request files. The file can contain requests for pack serial numbers or for SSCCs.
SNX_DISPOSITION_ASSIGNEDUsed for Commissioning Request files. The file can contain stand-alone packs and containers (SSCCs) including the aggregation details.


After selecting the transaction type, the application displays the list of files that have been uploaded to the applicable TraceLink folder:

  • For each transaction, you can see the status, request ID, date and time of sending, sender, receiver, and comments.
  • Each transaction can be expanded for further details.


In the following example, we selected SNX_REQUEST:



7. Click Select File for Import and select the file you want to upload. After selecting the file, the Upload File button becomes active.


IMPORTANT: For the SNX_REQUEST transaction, make sure that the XML file you want to upload contains a unique request ID in the description:

  • The request ID must be different from the one in the original XML file that failed.
  • It is not possible to upload an XML file that contains an already used request ID.
  • Uploading an XML file that does not contain a request ID will fail.
  • For the request ID, the allowed data type is "string". Movilitas.Cloud generates request ID based on timestamp, in the format of YYYYMMDDHHMMSSsss, where Y - Year, M - Month, D - Day, H - Hour, M - Minute, S - Second, s - Millisecond.


8. Click Upload File: <FILENAME>. Movilitas.Cloud puts the file to the applicable folder under the Inbox folder in TraceLink.



9. Monitor the processing of the file and make sure that the transaction is successfully processed.


If the transaction fails, you need to investigate the issue again and understand the root cause. If the problem can be resolved by repeating the upload operation, reupload the file.


Back to the list of procedures