The suppliers represent external sources and they are involved in inbound external transfers.


In the Serialized Logistics application:

  • You can register the suppliers and their products.
  • You can establish a partnership with a supplier in Movilitas.Cloud.
  • If you perform third-party logistics (3PL) on behalf of the supplier that is the Marketing Authorization Holder (MAH) of the product, you can upload an Electronic Product Code Information Services (EPCIS) file received from the supplier (MAH). The EPCIS file contains the trade items and containers that are ready for logistics (for example, unpacking, aggregation, or shipping).


List of Procedures


Creating a Supplier


You can create a supplier by providing its master data.


Procedure


1. In the Serialized Logistics application, select Site management --> Suppliers tab. The application displays the list of suppliers and the Master data form on the Create supplier panel.


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



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


FieldDescription
Supplier nameEnter the supplier name.
CityEnter the city where the supplier 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.
Supplier tagEnter the supplier tag. The tag identifies the supplier when sending a request over the Serialized Logistics V2 API.

TIP: If you want to use multiple words, connect them with a hyphen (-) or an underscore (_), for example, "demo-supplier-online-help".
Supplier emailEnter the email address of the supplier. This setting is relevant when you act as a 3PL for this supplier and you want to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Act as 3PL for this supplierIf you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Supplier SGLNEnter the location number of the supplier in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>.


For example, "1234567.00012.0".


Applicable when the Act as 3PL for this supplier checkbox is selected.
Tatmeen (UAE) channelIf the supplier imports products into the United Arab Emirates (UAE) market and you act as a 3PL for this supplier, select the previously configured Tatmeen regulatory channel that is associated with the supplier.

The field is available when the Act as 3PL for this supplier checkbox is selected and there is a Tatmeen regulatory channel configured for the tenant.
Collaboration channelIf you want to send EPCIS shipping messages to the SAP ICH system of the supplier, select the previously configured SAP ICH channel.

The field is available when the Act as 3PL for this supplier checkbox is selected and there is an SAP ICH channel configured for the tenant.


3. Click Save Supplier.


Next Steps


Create the products supplied by the supplier. For more information, see Creating the Products of a Supplier.


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


Back to the list of procedures



Creating the Products of a Supplier


Procedure


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


2. Find and select the supplier.


3. On the Update supplier panel, select the Products tab.


In the following examples, there is no product created for the selected supplier.


Example 1: "Demo Supplier (Online Help)":



Example 2: "MAH providing EPCIS 1.1". The supplier will be the MAH of the products.



4. Click Create Product. The application displays the Create product window with a form.



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


FieldDescription
Select product code schemaSelect the product code schema.
  • GTIN
  • CUSTOM
Product codeEnter the product code. You can provide a GTIN or a custom value depending on the selected schema. The entered product code must be unique for the tenant.
Product nameEnter the product name. Free-form text field.
Unit of measurementEnter the unit of measurement, for example, liter, kilogram, or units.
Minimum shelf life at deliveryProvide the minimum shelf life at delivery in months by entering the number or by using the arrows on the right.
GS1 company prefixEnter the GS1 company prefix part of the product. This setting is relevant when you act as a 3PL for this supplier and you want to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Supplier is MAHSelect the checkbox if the supplier is the Marketing Authorization Holder (MAH) of this product. This setting is relevant when you act as a 3PL for this supplier.


In the following example, we are providing the details of a product that has a custom product code:



In the following example, the supplier of the entered product is the MAH:



Note: If the entered product code with the specified schema is existing in the database, the already known fields are pre-filled and read-only in the Create product form. You can still edit the product code schema, the product code, and the empty fields.


6. Click Save.


7. Repeat the steps above to create all the products.


Next Steps


If you act as a 3PL for the supplier that is the MAH of the product, upload an EPCIS file containing the trade items and containers. For more information, see Uploading an EPCIS File (3PL-MAH Setup).


Back to the list of procedures



Establishing a Partnership with a Supplier 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 supplier to be a partner in Movilitas.Cloud by providing the contact email address.

  • If the supplier does not have a tenant in Movilitas.Cloud, the supplier registers a tenant. Depending on the payment model, the supplier becomes a full-paying customer in Movilitas.Cloud or the client that sent the invitation pays the invoices and the supplier is in "Partner" mode. Then, the supplier accepts the invitation and gets access to the Serialized Logistics application in a customized view.
  • If the supplier already has a tenant in Movilitas.Cloud, the supplier 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 --> Suppliers tab. The application displays the list of suppliers.


2. Find and select the supplier to view its details. The application displays the master data of the supplier on the Update supplier 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 Supplier" with payment model "Partner":


Back to the list of procedures



Removing the Partnership with a Supplier in Movilitas.Cloud


You can remove the partnership with a supplier 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 --> Suppliers tab. The application displays the list of suppliers.


2. Find and select the supplier to view its details. The application displays the master data of the supplier on the Update supplier 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 supplier.
  • The data exchange between the supplier and the client in Movilitas.Cloud is canceled.
  • The supplier still has the tenant in Movilitas.Cloud but the configuration is not updated from the client anymore.


Back to the list of procedures



Searching for a Supplier


Procedure


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


2. Enter the supplier name in the search field.

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


3. Select the supplier to view its details.

  • Check the supplier master data on the Master data tab.
  • Check the products from the supplier on the Products tab. The application displays the list of products with product code, product name, unit of measurement, and minimum shelf life at delivery.


In the following example, we are searching for supplier "Demo Supplier (Online Help)" and are viewing the master data:

  • Address
  • Supplier tag --> There are API calls from external systems to Movilitas.Cloud where the supplier is identified by this tag.
  • The supplier is not a partner in Movilitas.Cloud.



In the following example, the tenant acts as a 3PL for the supplier, and the following applies:

  • The Supplier email field is populated because the tenant sends EPCIS 1.2 files to the supplier by email. Applicable when the shipment is sent to Bahrain.
  • The supplier does not import any product to the UAE, so the Tatmeen (UAE) channel field is left blank.
  • The supplier is not a partner in Movilitas.Cloud.



In the following example, the tenant acts as a 3PL for the supplier, and the following applies:

  • The supplier imports products to the UAE, so a previously configured Tatmeen (UAE) regulatory channel is associated with the supplier.
  • The Supplier email field is left blank because the tenant does not send EPCIS 1.2 files to the supplier by email.
  • The supplier is not a partner in Movilitas.Cloud.



In the following example, the tenant established a partnership with the supplier in Movilitas.Cloud:

  • The supplier is in "Partner" mode, meaning that the tenant that sent the invitation pays the invoices.



In the following example, the tenant acts as a 3PL for the supplier, and the following applies:

  • The supplier reports EPCIS events to the SAP ICH system of the supplier, so a previously configured SAP ICH channel is associated with the supplier in the Collaboration channel field.
  • The supplier is not a partner in Movilitas.Cloud.



Back to the list of procedures



Uploading an EPCIS File (3PL-MAH Setup)


If you perform third-party logistics (3PL) on behalf of the supplier, the supplier can provide the input to you in an Electronic Product Code Information Services (EPCIS) file. In this setup, the supplier is the Marketing Authorization Holder (MAH) of the product. You can register the trade items and containers in the Serialized Logistics application by uploading the EPCIS file.


After the upload, the items are ready for warehouse activities (aggregation and shipping).


Supported EPCIS versions:

  • EPCIS 1.1
  • EPCIS 1.2


Uploading the EPCIS file triggers automated actions as follows:

  • If the product is not existing:
    • The application creates the product and links it to the supplier. You can verify it under the Products tab on the Update supplier panel.
    • The supplier is flagged as the MAH of the product.
    • When the file content makes it possible, the company prefix of the product is stored. You can verify it under the Products tab on the Update supplier panel.
  • (US only) If the destination in the shipping event of the EPCIS file is registered as a warehouse and the country is the United States:
    • The National Drug Code (NDC) is determined and stored next to the Global Trade Item Number (GTIN) in the database.
    • The product master data (product name) is requested from openFDA and stored (U.S. Department of Health and Human Services Food and Drug Administration).


Before You Begin


Make sure the supplier is registered, you act as 3PL for this supplier, and you have provided the supplier SGLN (that is the sender in the file).


Procedure


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


2. Find and select the supplier.


3. Click on the Upload EPCIS button in the top-right corner of the Update supplier panel.


Example:



4. Select the EPCIS file from your computer. The application displays a confirmation window.



5. Click Yes. The application displays a green toast message at the bottom of the screen to confirm that the EPCIS file has been uploaded.


6. Select the Uploads tab in the Update supplier panel and verify that the upload was successful.


The application displays a log of the uploaded files with status.


Example:



The following table summarizes the log types and the corresponding actions:


StatusDescriptionActionExample
Success (Checkmark icon)The file was uploaded without any errors.Expand the log and perform the following:
  1. Check the snapshot of the containers, trade items, and hierarchy defined in the file.
  2. Use the Download EPCIS file button to download the EPCIS file.
Error (Exclamation mark icon)The file was uploaded with error.

The application creates the items in the system that do not have issues and displays the items that cause the error.
Expand the log and perform the following:
  1. Investigate the error message.
  2. Check the snapshot of the containers, trade items, and hierarchy defined in the file. Identify the discrepancies.
  3. Use the Download EPCIS file button to download the EPCIS file.
  4. If you can correct the error by uploading a new file, create a new EPCIS file by reusing the original one. Include the items in the file that needs correction. Note: Not all errors can be corrected by uploading a new file. For example, if the item is already commissioned (not in Active status), you cannot overwrite it.
  5. Upload the new EPCIS file.


Back to the list of procedures



Updating a Supplier


Procedure


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


2. Find and select the supplier.


3. In the Master data form on the Update supplier panel, modify the fields as needed, and click Save Supplier.


FieldDescription
Supplier nameEnter the supplier name.
CityEnter the city where the supplier 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.
Supplier tagEnter the supplier tag. The tag identifies the supplier when sending a request over the Serialized Logistics V2 API.

TIP: If you want to use multiple words, connect them with a hyphen (-) or an underscore (_), for example, "demo-supplier-online-help".
Supplier emailEnter the email address of the supplier. This setting is relevant when you act as a 3PL for this supplier and you want to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Act as 3PL for this supplierIf you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Supplier SGLNEnter the location number of the supplier in the SGLN format: <GS1 company prefix>.<location reference>.<extension or "0" when no extension>.


For example, "1234567.00012.0".


Applicable when the Act as 3PL for this supplier checkbox is selected.
Tatmeen (UAE) channelIf the supplier imports products into the United Arab Emirates (UAE) market and you act as a 3PL for this supplier, select the previously configured Tatmeen regulatory channel that is associated with the supplier.

Available when the Act as 3PL for this supplier checkbox is selected and there is a Tatmeen regulatory channel configured for the tenant.
Collaboration channelIf you want to send EPCIS shipping messages to the SAP ICH system of the supplier, select the previously configured SAP ICH channel.

The field is available when the Act as 3PL for this supplier checkbox is selected and there is an SAP ICH channel configured for the tenant.


4. On the Update supplier panel, select the Products tab. The application displays the list of products from the supplier.


You can sort the table in ascending or descending order based on the product code or product name.


Example 1:



Example 2:



5. Create a new product by clicking Create Product. Fill in the form and click Save.


FieldDescription
Select product code schemaSelect the product code schema.
  • GTIN
  • CUSTOM
Product codeEnter the product code. You can provide a custom value as the application supports custom product code schema. The entered product code must be unique for the tenant.
Product nameEnter the product name. Free-form text field.
Unit of measurementEnter the unit of measurement, for example, liter, kilogram, or units.
Minimum shelf life at deliveryProvide the minimum shelf life at delivery in months by entering the number or by using the arrows on the right.
GS1 company prefixEnter the GS1 company prefix part of the product. This setting is relevant when you act as a 3PL for this supplier and you want to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Supplier is MAHSelect the checkbox if the supplier is the Marketing Authorization Holder (MAH) of this product. This setting is relevant when you act as a 3PL for this supplier.


Example:



Note: If the entered product code with the specified schema is existing in the database, the already known fields are pre-filled and read-only in the Create product form. You can still edit the product code schema, the product code, and the empty fields.


6. Edit a product by clicking the edit icon in the Action column. Update the fields in the Update product form and click Save.


Note: You cannot edit the fields that are critical in terms of database consistency and were provided before.


Example:



7. Unassign a product from the supplier by clicking Unassign product from supplier in the Action column.


The application immediately executes the action without requesting confirmation. By performing this action, you only remove the link between the supplier and the product code, but the product remains in the database.


Example:




Back to the list of procedures



Deleting a Supplier


Procedure


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


2. Find the supplier 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