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


By default, the SFTP connection is automated, meaning that communication does not need human intervention. However, the users can monitor and manage the incoming transactions (=from TraceLink) and the outgoing transactions (=towards TraceLink).


Scenario 1


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, Movilitas.Cloud sends a notification to the email address specified on the channel.
  • 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.


Scenario 2


The MAH uses Movilitas.Cloud - including the Serialized Manufacturing application - to receive shipment files from a CMO and commission the items to the market.

  • Movilitas.Cloud checks for new files in TraceLink every morning. If there is a new file, the application downloads and processes it automatically. 
  • The user does not need to wait for the automatic action and can pre-emptively download and process the files manually.
  • The processed items are listed under the Serialized Manufacturing application --> Commissioning tab.
  • If processing the file fails, Movilitas.Cloud sends a notification to the email address specified on the channel.


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 has not executed the daily automatic action yet.
    • You want to check if there is any pending file. You do not have to wait for the automated action but you can pre-emptively process the file and then delete the file in TraceLink.
    • To view the content of the file, you can download the file to your local computer without any processing.
  • 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 download the file to your local computer without any processing. If the response file contains the requested serials but the file was placed on TraceLink too late, you can use this file in your serialization activities outside Movilitas.Cloud.


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.

The files listed for this transaction type were not downloaded automatically due to an error. In the normal case, these files are automatically downloaded and processed.
SOM_SHIPMENT_EVENTA shipment file containing the items produced by a manufacturer (commissioning and aggregation events).

Movilitas.Cloud automatically downloads and processes the files every morning. However, you do not have to wait for the automated action but you can pre-emptively download and process the file.

The output of the processed files is listed under the Serialized Manufacturing --> Commissioning tab.

Note: As a prerequisite, the Serialized Manufacturing application must be properly configured in advance:
  • The product must be registered.
  • The CMO must be registered, including SGLN and the assigned TraceLink Partner channel.


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. To see the latest files, click the Refresh icon next to the Transaction type drop-down on the right.
  • Download the file by clicking on the Download XML button.
  • For the SOM_SHIPMENT_EVENT transaction, you can manually process the file by clicking Process.
  • For the SOM_SHIPMENT_EVENT transaction, the application also displays a log of the downloaded and processed files in the Processed Files section. The Processed Files section contains the automatically and manually processed files also. To see the recently processed files, click the Refresh icon in the top-right corner of the Processed Files section.


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



In the following example, we selected the SOM_SHIPMENT_EVENT transaction type to view the pending files and to view the processed files.




WHEN YOU WANT TO MANUALLY PROCESS A SOM_SHIPMENT_EVENT FILE, CONTINUE WITH THE NEXT STEPS.

OTHERWISE, END OF PROCEDURE.


7. Click Process next to the file. 


A log is created in the Processed Files section.


8. In the Processed Files section, verify that the file was successfully processed.


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


StatusDescription
Finished (Green)The file is successfully downloaded and processed. The output of the processed file is listed under the Serialized Manufacturing --> Commissioning tab.
PendingDownloading and processing the file is in progress. Wait for the operation to be completed.
Error (Red)An error occurred while downloading and processing the file. The operation failed. You need to investigate the issue.


9. Click the > (Expand) icon on the left:

  • View the processed items. For each product, the items are organized per batch.
  • For a failed operation, investigate the error. Each item that has an error is listed together with the error message.
  • To have the XML content, click on the Copy the XML to the clipboard icon and save the content into a file.


EXAMPLE 1


The transaction was successful. For the product, the items are organized per batch.



EXAMPLE 2


The transaction failed. Each item that has an error is listed with the details.





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 download the request XML and the response XML (if any).


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.
SOM_SALES_SHIPMENTUsed for Sales Shipment files. The file describes the shipping event of a commissioning request.


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. To see the latest transactions, click the Refresh icon next to the search field on the right.


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.


9. Click the > (Expand) icon on the left to see the details of the transaction and to download the XML files:

  • 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 Download button.



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:

  • Transaction details
  • Request XML
  • Last raw response

The Last raw response contains the requested items. To have the content of the XML, click on the Download button.




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.


Note: Uploading a file for SOM_SALES_SHIPMENT transaction is not supported.


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.



Note: Uploading a file for SOM_SALES_SHIPMENT transaction is not supported.


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