The clients represent external destinations and they are involved in outbound external transfers.


In the Serialized Logistics application:

  • You can register and manage your clients.
  • You can establish a partnership with a client in Movilitas.Cloud.


When connecting to BPOM, all the shipping locations saved as clients on the BPOM channel settings page are automatically imported into the Serialized Logistics application. You may need to reorganize the address data after the import.


When sending an IDOC Delvry to Movilitas.Cloud from SAP ICH or uploading an IDOC Delvry on the SAP ICH channel, the client master data and the delivery address are automatically created in the Serialized Logistics application. However, you still need to provide the SGLN (location data) manually.


List of Procedures


Creating a Client (Master Data)


To create a client, you need to provide the master data of the client. The master data includes the client name, the client ID, and the business address (business location). If the client has one or more delivery addresses (facility/storage locations), you can provide further addresses after creating the client.


Automatic Client Creation


The Serialized Logistics application offers automatic client creation in the following cases meaning that you do not need to manually create them from scratch:


CaseDescriptionAny Manual Action after Automatic Client Creation?
Connection to BPOM (Indonesia)You can save the client on the BPOM channel settings page and automatically import it to the Serialized Logistics application. For more information, see Configuring a BPOM Channel, Managing Logs, Viewing BPOM Returns, and Importing Shipping Locations.Yes. You may need to reorganize the address data after the import. Go to Updating a Client.
IDOC Delvry from SAP ICHAfter sending an IDOC Delvry to Movilitas.Cloud from SAP ICH or uploading an IDOC Delvry on the SAP ICH channel, the client master data and the delivery address are automatically created in the Serialized Logistics application.

As a prerequisite, you need to configure an SAP ICH channel including the GLN values of the participants and you also need to configure SAP ICH to have the Movilitas.Cloud endpoint where the IDOC Delvry is sent. For more information, see Configuring and Monitoring an SAP ICH Channel.
Yes. You need to provide the SGLN (location data), both for the client master data and for the delivery address. Go to Updating a Client.
Manually uploaded IDOC


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients and the Create client form.


Note: When viewing the details of a client, you can open the Create client form by clicking Create.


Example:



2. On the Master data tab, fill in the form as described below. The required fields are marked with an asterisk (*) in the form.


FieldAction
Client nameEnter the client name.
Client IDEnter a unique client ID. The unique ID enables the application to identify the client.
Client does not have a GLNIf the client does not have a Global Location Number (GLN), select this checkbox. As a result, the Client SGLN field disappears.
Client SGLN

Enter the location number of the client in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>. 


For example, "1234567.00012.0".


This SGLN is the business, owning party, or sold-to location.


The client SGLN is required in the following cases:

  • You send the shipping event to the client in a TraceLink XML file.
  • You send the shipment details in an EPCIS 1.2 file.


If you need help, click on the conversion button (Help me to define the SGLN) on the right.



The application displays a pop-up. Provide the following data and click Convert:

  • Client location in the GLN format (13 digits).
  • Company prefix length (6 to 12 digits).
  • Extension digit that is 0 by default.


Example:



The provided GLN value is converted to the SGLN format and the field is populated.


Example:



CityEnter the city where the client is located.
StreetEnter the street. The form offers three rows (levels) for the street data.
StateEnter the state.
ZIP codeEnter the postal code.
Select countrySelect the country. Start entering the country name to filter the countries.

For locations imported through a BPOM channel, the field is automatically set to Indonesia and the field is read-only.
BPOM id

Unless already filled in during the shipping location import, enter the BPOM ID of the client. Only applicable when the selected country is Indonesia.

  • For imported locations, the field is read-only.
  • For locations created on-demand, the field is editable.

Note: Make sure that you are using the BPOM ID that is assigned to that location by BPOM. The BPOM ID is important for the sender who wants to ship items to this location because the destination BPOM ID is sent to BPOM during the report.

Registration typeEnter the registration type as specified in the generic report that is sent from SAP ATTP to Movilitas.Cloud. Only applicable when the selected country is Kazakhstan and the generic report from SAP ATTP is an import request to Kazakhstan.

Note: When receiving the generic report from SAP ATTP for the first time, the client is auto-created, meaning that the field is auto-filled with the value in the generic report from SAP ATTP.
Registration numberEnter the registration number as specified in the generic report that is sent from SAP ATTP to Movilitas.Cloud. Only applicable when the selected country is Kazakhstan and the generic report from SAP ATTP is an import request to Kazakhstan.

Note: When receiving the generic report from SAP ATTP for the first time, the client is auto-created, meaning that the field is auto-filled with the value in the generic report from SAP ATTP.
Email to send EPCIS Tatmeen fileEnter the email address where Movilitas.Cloud can send the EPCIS file that was reported to Tatmeen after shipping the order (import permit) to the client.

The field is only available when the country of the client is the United Arab Emirates.

To send the EPCIS Tatmeen file by email, the following conditions must be fulfilled:
  • The tenant acts as a 3PL for the supplier of the products.
  • A Tatmeen regulatory channel is configured and associated with the supplier.
  • A shipping action to the client is performed in the mobile application.
SFTP channelSelect a previously configured SFTP channel to send the EPCIS Tatmeen file to the SFTP server. The EPCIS file is reported to Tatmeen and is sent to the SFTP server after shipping the order (import permit) to the client.

The field is only available when the country of the client is the United Arab Emirates.

To send the EPCIS Tatmeen file to an SFTP server, the following conditions must be fulfilled:
  • The tenant acts as a 3PL for the supplier of the products.
  • A Tatmeen regulatory channel is configured and associated with the supplier.
  • An SFTP channel is configured and associated with the client.
  • A shipping action to the client is performed in the mobile application.


To stop sending files to an SFTP server, clear the field by clicking on the X button.

File pathOnce an SFTP channel is selected, set the file path on the SFTP server. Follow the help text under the field and do not add "/" at the beginning of the file path.

If the file path is not given, the file is saved in the roots folder.

The field is only available after an SFTP channel is selected.
Tracelink collaboration channelSelect a previously configured TraceLink Partner channel. This setting is required when your company reports the shipping event to the client in TraceLink.

The field is only available when your tenant has a TraceLink Partner channel in Movilitas.Cloud.
Tracelink company identifierEnter the TraceLink company identifier of the client. This setting is required when your company reports the shipping event to the client in TraceLink.

The field is only available when your tenant has a TraceLink Partner channel in Movilitas.Cloud.


3. Click Save. The client is added to the list.


Next Steps


Register the delivery address(es) of the client. For more information, see Registering the Delivery Addresses of a Client.


You can establish a partnership with the client in Movilitas.Cloud. For more information, see Establishing a Partnership with a Client in Movilitas.Cloud.


Back to the list of procedures



Registering the Delivery Addresses of a Client


The delivery address holds the facility/storage/ship-to location information.


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Find and select the client in the list you want to update.


3. On the Update client form, select the Delivery addresses tab.


In the following example, the selected client does not have any delivery address yet:



4. To add a delivery address, click Add Delivery Address. The application displays the Create delivery address pop-up with a form.


 

5. Fill in the form as described below. The required fields are marked with an asterisk (*) in the form.


FieldAction
Delivery address IDEnter a unique delivery address ID.
Delivery address nameEnter the name of the delivery address.
CityEnter the city.
StreetEnter the street. The form offers three rows (levels) for the street data.
StateEnter the state.
ZIP codeEnter the postal code.
Select countrySelect the country. Start entering the country name to filter the countries.

Required when a TraceLink collaboration channel is set for the client.
Delivery address SGLNEnter the location number of the facility in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>. 


For example, "1234567.00012.0".


This SGLN is the facility, storage, or ship-to location where the shipments are sent.


The delivery address SGLN is required in the following cases:

  • You send the shipping event to the client in a TraceLink XML file.
  • You send an EPCIS shipment file.


If you need help, click on the conversion button (Help me to define the SGLN) on the right.



The application displays a pop-up. Provide the following data and click Convert:

  • Client delivery address location in the GLN format (13 digits).
  • Company prefix length (6 to 12 digits).
  • Extension digit that is 0 by default.


Example:



The provided GLN value is converted to the SGLN format and the field is populated.


Example:



6. Click Save. The shipping address is added to the list.


Example:



Back to the list of procedures



Establishing a Partnership with a Client in Movilitas.Cloud


By establishing a partnership in Movilitas.Cloud, the supplier and the client are integrated within Movilitas.Cloud with their customized views and functions. The partnership enables the supplier and the client to exchange data in an efficient, controlled, and secure manner.


You can invite a client to be a partner in Movilitas.Cloud by providing the contact email address.

  • If the client does not have a tenant in Movilitas.Cloud, the client registers a tenant. Depending on the payment model, the client becomes a full-paying customer in Movilitas.Cloud or the supplier that sent the invitation pays the invoices and the client is in "Partner" mode. Then, the client accepts the invitation and gets access to the Serialized Logistics application in a customized view.
  • If the client already has a tenant in Movilitas.Cloud, the client reviews the partner request, accepts the invitation, and gets access to the Serialized Logistics application in a customized view.


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Find and select the client to view its details. The application displays the master data of the client on the Update client panel and the empty Invite partner panel.


Example:



3. On the Invite partner panel, enter the contact email address.


Example:



4. Click Invite Partner.


CaseWhat does happen?Action
The contact email address is not known in the system.

The application sends a registration email to the address.


The client has to register a tenant in Movilitas.Cloud and then accept the partner request.


Until the partner request is accepted, the request is in pending status.


Example:



Track the status of the partner request on the Tenant Dashboard, under the Partner management tab.


You can cancel the request by clicking on the cancel icon on the right.

The contact email address belongs to one tenant in Movilitas.Cloud.

The application sends a partner review request email to the address.


Note: The email address must belong to a user with the “Administrator” role so that the partnership can be established.


Until the partner request is accepted, the request is in pending status.


Example:



Track the status of the partner request on the Tenant Dashboard, under the Partner management tab.


You can cancel the request by clicking on the cancel icon on the right.


The contact email address belongs to multiple tenants in Movilitas.Cloud.The application displays the Multiple partner options window to select a tenant from the list.

1. Select a tenant and click Confirm.

  • After the tenant is selected, the application sends a partner review request email to the address. Note: The email address must belong to a user with the “Administrator” role so that the partnership can be established.
  • Until the partner request is accepted, the request is in pending status.
  • You can cancel the request by clicking on the cancel icon on the right.


2. Track the status of the partner request on the Tenant Dashboard, under the Partner management tab.


You can cancel the request by clicking on the cancel icon on the right.


Once the partner request is accepted, the partnership is live. The application displays the active partnership as follows:


IndicatorsDescriptionExample
Partnership status indicator next to the client name in the list

The status indicator displays the payment model in place:

  • Movilitas.Cloud customer (full-paying customer) in orange.
  • Partner in red.


If there is no partnership status indicator, that means a partnership is not established with the client in Movilitas.Cloud.

Invite partner panel
  • Status - Active partner.
  • Name of the tenant.
  • Payment model - Movilitas.Cloud customer (full-paying customer) versus Partner.

The following example illustrates tenant "Partner Client" with payment model "Partner":


Back to the list of procedures



Removing the Partnership with a Client in Movilitas.Cloud


You can remove the partnership with a client in Movilitas.Cloud. After the partnership is removed, the integration between the supplier and the client is degraded. The data exchange between the supplier and the client in Movilitas.Cloud is canceled.

 

Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Find and select the client to view its details. The application displays the master data of the client on the Update client panel and the active partner on the Invite partner panel.


3. On the Invite partner panel, click on the delete icon (Remove partner) on the right.



The application asks you to confirm the action.




4. In the confirmation window, click Yes.

  • The application removes the partnership with the client.
  • The data exchange between the supplier and the client in Movilitas.Cloud is canceled.
  • The client still has the tenant in Movilitas.Cloud but the configuration is not updated from the supplier anymore.


Back to the list of procedures



Searching for a Client


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Enter the client name in the search field.

  • The list of the clients is filtered based on the search criteria.
  • You can reset the filter by clicking on the Reset filters icon.


3. Select the client to view its details.

  • Check the client master data on the Master data tab. You can find screenshot examples in this procedure.
  • Check the delivery addresses on the Delivery addresses tab. For screenshot examples, see Registering the Delivery Addresses of a Client.


In the following example, we are searching for the client "Apotek Dummy":

  • The client is located in Indonesia and is imported through the BPOM channel as stated under the client name on the left.
  • The full client address is imported into the Street field which may need reorganization.
  • The client has a BPOM id that was also imported through the BPOM channel.
  • The client is not a partner in Movilitas.Cloud.



In the following example, we are searching for the client "Dubai Client":

  • The client is located in the United Arab Emirates.
  • The client SGLN is provided because the shipment is reported to Tatmeen.
  • The EPCIS file is sent to the client by email because the Email to send EPCIS Tatmeen file field is filled in.
  • The EPCIS file is also sent to an SFTP server through the selected SFTP channel. The file is uploaded to the SFTP location as given in the file path. 
  • The client is not a partner in Movilitas.Cloud.



In the following example, we are searching for the client "Partner Client":

  • The tenant established a partnership with the client in Movilitas.Cloud.
  • The client is in "Partner" mode. The tenant that sent the invitation pays the invoices.
  • The client is located in Belgium.
  • The client SGLN is provided.



In the following example, we are searching for the client "Movilitas Client":

  • The client is located in Belgium.
  • The client receives the shipping event in TraceLink. The SGLN field and the TraceLink fields are set. The delivery address must also be set as described in Updating a Client.
  • The client is not a partner in Movilitas.Cloud.



In the following example, we are searching for the client "Pharmacy Client USA":

  • The client is located in the USA.
  • The client does not have a GLN so the Client does not have a GLN checkbox is selected.
  • The client is not a partner in Movilitas.Cloud.



Back to the list of procedures



Updating a Client


When updating a client, you can modify the master data including the business address (business location) and you can also manage the delivery addresses (facility/storage/ship-to locations).


Providing a delivery address is required when at least one of the following is applicable:

  • The shipments are sent to a location different from the business address (business location).
  • A TraceLink collaboration channel is selected and a TraceLink company identifier is provided in the client master data.


After an automatic client creation, you may need to perform some manual action. The following table summarizes these cases.


CaseDescriptionAction
Connection to BPOM (Indonesia)The BPOM (Indonesia) shipping locations specified as clients on the BPOM channel settings page are automatically imported and are available in the list. The configuration form is prefilled with the existing data and the application displays the text Imported through BPOM channel under the client name in the list.(Optional) Reorganize the address data after the import.
IDOC Delvry from SAP ICHAfter sending an IDOC Delvry to Movilitas.Cloud from SAP ICH or uploading an IDOC Delvry on the SAP ICH channel, the client master data and the delivery address are automatically created in the Serialized Logistics application.(Required) Provide the SGLN (location data), both for the client master data and for the delivery address.
Manually uploaded IDOC


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Find and select the client in the list you want to update.


3. On the Master data tab in the Update client form, modify the master data as needed.


FieldAction
Client nameEnter the client name.
Client IDEnter a unique client ID. The unique ID enables the application to identify the client.
Client does not have a GLNIf the client does not have a Global Location Number (GLN), select this checkbox. As a result, the Client SGLN field disappears.
Client SGLN

Enter the location number of the client in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>. 


For example, "1234567.00012.0".


This SGLN is the business, owning party, or sold-to location.


The client SGLN is required in the following cases:

  • You send the shipping event to the client in a TraceLink XML file.
  • You send shipment details in an EPCIS 1.2 file.


If you need help, click on the conversion button (Help me to define the SGLN) on the right.


The application displays a pop-up. Provide the following data and click Convert:

  • Client location in the GLN format (13 digits).
  • Company prefix length (6 to 12 digits).
  • Extension digit that is 0 by default.


The provided GLN value is converted to the SGLN format and the field is populated.

CityEnter the city where the client is located.
StreetEnter the street. The form offers three rows (levels) for the street data.
StateEnter the state.
ZIP codeEnter the postal code.
Select countrySelect the country. Start entering the country name to filter the countries.

For locations imported through a BPOM channel, the field is automatically set to Indonesia and the field is read-only.
BPOM id

Unless already filled in during the shipping location import, enter the BPOM ID of the client. Only applicable when the selected country is Indonesia.

  • For imported locations, the field is read-only.
  • For locations created on-demand, the field is editable.

Note: Make sure that you are using the BPOM ID that is assigned to that location by BPOM. The BPOM ID is important for the sender who wants to ship items to this location because the destination BPOM ID is sent to BPOM during the report.

Registration typeEnter the registration type as specified in the generic report that is sent from SAP ATTP to Movilitas.Cloud. Only applicable when the selected country is Kazakhstan and the generic report from SAP ATTP is an import request to Kazakhstan.

Note: When receiving the generic report from SAP ATTP for the first time, the client is auto-created, meaning that the field is auto-filled with the value in the generic report from SAP ATTP.
Registration numberEnter the registration number as specified in the generic report that is sent from SAP ATTP to Movilitas.Cloud. Only applicable when the selected country is Kazakhstan and the generic report from SAP ATTP is an import request to Kazakhstan.

Note: When receiving the generic report from SAP ATTP for the first time, the client is auto-created, meaning that the field is auto-filled with the value in the generic report from SAP ATTP.
E-mail to send EPCIS Tatmeen fileEnter the email address where Movilitas.Cloud can send the EPCIS file that was reported to Tatmeen after shipping the order (import permit) to the client.

The field is only available when the country of the client is the United Arab Emirates.

To send the EPCIS Tatmeen file by email, the following conditions must be fulfilled:
  • The tenant acts as a 3PL for the supplier of the products.
  • A Tatmeen regulatory channel is configured and associated with the supplier.
  • A shipping action to the client is performed in the mobile application.
SFTP channelSelect a previously configured SFTP channel to send the EPCIS Tatmeen file to the SFTP server. The EPCIS file is reported to Tatmeen and is sent to the SFTP server after shipping the order (import permit) to the client.

The field is only available when the country of the client is the United Arab Emirates.

To send the EPCIS Tatmeen file to an SFTP server, the following conditions must be fulfilled:
  • The tenant acts as a 3PL for the supplier of the products.
  • A Tatmeen regulatory channel is configured and associated with the supplier.
  • An SFTP channel is configured and associated with the client.
  • A shipping action to the client is performed in the mobile application.


To stop sending files to an SFTP server, clear the field by clicking on the X button.

File pathOnce an SFTP channel is selected, set the file path on the SFTP server. Follow the help text under the field and do not add "/" at the beginning of the file path.

If the file path is not given, the file is saved in the roots folder.

The field is only available after an SFTP channel is selected.
Tracelink collaboration channelSelect a previously configured TraceLink Partner channel. This setting is required when the tenant (your company) reports the shipping event to the client in TraceLink.

The field is only available when your tenant has a TraceLink Partner channel in Movilitas.Cloud.
Tracelink company identifierEnter the TraceLink company identifier of the client. This setting is required when the tenant (your company) reports the shipping event to the client in TraceLink.

The field is only available when your tenant has a TraceLink Partner channel in Movilitas.Cloud.


4. Click Save.


5. If applicable, select the Delivery addresses tab and manage the delivery addresses.


Operation on Delivery AddressDescription
AddClick Add Delivery Address, fill in the form as described below, and click Save. The required fields are marked with an asterisk (*) in the form.

FieldDescription
Delivery address IDEnter a unique delivery address ID.
Delivery address nameEnter the name of the delivery address, for example, the company name.
CityEnter the city.
StreetEnter the street. The form offers three rows (levels) for the street data.
StateEnter the state.
ZIP codeEnter the postal code.
Select countrySelect the country. Start entering the country name to filter the countries.

Required when a TraceLink collaboration channel is set for the client.
Delivery address SGLNEnter the location number of the facility in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>. 


For example, "1234567.00012.0".


This SGLN is the facility, storage, or ship-to location where the shipments are sent.


The delivery address SGLN is required in the following cases:

  • You send the shipping event to the client in a TraceLink XML file.
  • You send an EPCIS shipment file.


If you need help, click on the conversion button (Help me to define the SGLN) on the right.


The application displays a pop-up. Provide the following data and click Convert:

  • Client delivery address location in the GLN format (13 digits).
  • Company prefix length (6 to 12 digits).
  • Extension digit that is 0 by default.


The provided GLN value is converted to the SGLN format and the field is populated.


EditClick on the edit icon, modify the fields in the opened form as described above, and click Save.

Delete

Click on the delete icon.


Note: The application does not request confirmation but it immediately removes the delivery address from the list.



Back to the list of procedures



Deleting a Client


Procedure


1. In the Serialized Logistics application, select Site management --> Clients tab. The application displays the list of clients.


2. Find the client in the list you want to delete.


Example:



3. Click the delete icon and confirm the deletion by clicking Yes.


Back to the list of procedures