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.


List of Procedures


Creating a Client


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.


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.


Note: If you want to create a client for the Indonesian market and you have a connection to BPOM, instead of manually creating the client, 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.


FieldAction
Client nameEnter the client name.
Client IDEnter a unique client ID. The unique ID enables the application to identify the client.
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 relates to the business location or owning party 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 transfer details in an EPCIS 1.2 file.
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 on 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.
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


If the client has delivery addresses (facility/storage locations) besides the business address (business location), provide the delivery addresses of the client. For more information, see Updating a Client.


You can establish a partnership with the client in Movilitas.Cloud.


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.


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.
  • 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 MAH 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. The application displays the master data of the 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 shipment to the client is reported to Tatmeen, so the EPCIS file should be sent to the client by email.
  • The client is not a partner in Movilitas.Cloud.



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

  • The client is located in Belgium.
  • The client is a partner in Movilitas.Cloud and it is in "Partner" mode, meaning that the current tenant that sent the invitation pays the invoices.



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 client is not a partner in Movilitas.Cloud.



4. If applicable, select the Delivery addresses tab to view the delivery addresses of the client.


In the following example, we are checking the previously selected "Movilitas Client". There is one delivery address for "Movilitas Client". The application displays the delivery address ID, the city, the street, and the actions (add, edit, and delete).


After clicking on the edit icon, the application displays further address details, for example, the country or the SGLN.



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 locations).


Providing a delivery address is required when one or both of the following is true:

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


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.


Note: The BPOM 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. You may need to reorganize the address data after the import.


FieldAction
Client nameEnter the client name.
Client IDEnter a unique client ID. The unique ID enables the application to identify the client.
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 relates to the business location or owning party 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 transfer details in an EPCIS 1.2 file.
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 on 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.
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.
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 on 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 relates to the facility/storage location where the shipments are sent.


The delivery address SGLN is required when you send the shipping event to the client in a TraceLink XML file.


Example:

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