The suppliers represent external sources and they are involved in inbound external transfers. You can register the suppliers and their products in the Serialized Logistics application.

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 EPCIS 1.1 file received from the supplier (MAH). The EPCIS 1.1 file contains the trade items and containers that are ready for logistics (for example, shipping).

Note: To access this page, the "Administrator" role is required.

List of Procedures

Creating a Supplier
Searching for a Supplier
Creating the Products of a Supplier
Uploading an EPCIS 1.1 File (3PL-MAH Setup)
Updating a Supplier
Deleting a Supplier

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.

Field	Description
Supplier name	Enter the supplier name.
City	Enter the city where the supplier is located.
Street	Enter the street. The form offers three rows (levels) for the street data.
State	Enter the state.
ZIP code	Enter the postal code.
Select country	Select the country. Start entering the country name to filter on the countries.
Supplier tag	Enter 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 email	Enter the email address of the supplier. This setting is relevant when you act as a 3PL for this supplier and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Act as 3PL for this supplier	If you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Supplier SGLN	Enter 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.

3. Click Save Supplier.

Next Steps

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

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

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

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.

Field	Description
Select product code schema	Select the product code schema. GTIN CUSTOM
Product code	Enter 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 name	Enter the product name. Free-form text field.
Unit of measurement	Enter the unit of measurement, for example, liter, kilogram, or units.
Minimum shelf life at delivery	Provide the minimum shelf life at delivery in months by entering the number or by using the arrows on the right.
GS1 company prefix	Enter the GS1 company prefix part of the product. This setting is relevant when you act as a 3PL for this supplier and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Supplier is MAH	Select 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 and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).

In the following example, we are providing the details of a product that has 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 1.1 file containing the trade items and containers. For more information, see Uploading an EPCIS 1.1 File (3PL-MAH Setup).

Back to the list of procedures

Uploading an EPCIS 1.1 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 EPCIS 1.1 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 1.1 file.

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

If the product is not existing, the application creates it and links it to the supplier first. The supplier is automatically flagged as the MAH of the product and the company prefix is also stored.

Before You Begin

Make sure that the supplier is registered; you act as 3PL for this supplier and you have provided the supplier SGLN.

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 1.1 button in the top-right corner of the Update supplier panel.

Example:

4. Select the EPCIS 1.1 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.

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

Status	Description	Action	Example
Error (Exclamation mark icon)	The file was uploaded with errors.	Expand the log and perform the following: Investigate the error message. Check the snapshot of the containers, trade items, and hierarchy defined in the file. Identify the discrepancies. Use the Download EPCIS file button to download the EPCIS 1.1 file. If you can correct the error by uploading a new file, create a new EPCIS 1.1 file by reusing the original one and focus on the items that can be corrected. 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. Upload the new EPCIS 1.1 file.
Success (Checkmark icon)	The file was uploaded without any error.	Expand the log and perform the following: Check the snapshot of the containers, trade items, and hierarchy defined in the file. Use the Download EPCIS file button to download the EPCIS 1.1 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.

Field	Description
Supplier name	Enter the supplier name.
City	Enter the city where the supplier is located.
Street	Enter the street. The form offers three rows (levels) for the street data.
State	Enter the state.
ZIP code	Enter the postal code.
Select country	Select the country. Start entering the country name to filter on the countries.
Supplier tag	Enter 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 email	Enter the email address of the supplier. This setting is relevant when you act as a 3PL for this supplier and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Act as 3PL for this supplier	If you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Supplier SGLN	Enter 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.

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.

Field	Description
Select product code schema	Select the product code schema. GTIN CUSTOM
Product code	Enter 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 name	Enter the product name. Free-form text field.
Unit of measurement	Enter the unit of measurement, for example, liter, kilogram, or units.
Minimum shelf life at delivery	Provide the minimum shelf life at delivery in months by entering the number or by using the arrows on the right.
GS1 company prefix	Enter the GS1 company prefix part of the product. This setting is relevant when you act as a 3PL for this supplier and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).
Supplier is MAH	Select 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 and you need to send EPCIS 1.2 files containing the transfer details to the supplier (MAH).

Example:

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: