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.
You can upload an Electronic Product Code Information Services (EPCIS) file received from the supplier. The EPCIS file contains the trade items and containers that are ready for logistics, for example, unpacking, reaggregation, or shipping.

List of Procedures

Creating a Supplier (Master Data)
Registering the Shipping Addresses of a Supplier
Creating the Products of a Supplier
Establishing a Partnership with a Supplier in Movilitas.Cloud
Removing the Partnership with a Supplier in Movilitas.Cloud
Searching for a Supplier
Verifying the EPCIS File Received in Partnership or through a Collaboration Channel
Uploading an EPCIS File
Updating a Supplier (Master Data and Shipping Address)
Editing the Products of a Supplier
Unassigning a Product from the Supplier
Deleting a Supplier

Creating a Supplier (Master Data)

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.

Example:

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 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 want to send EPCIS 1.2 files containing the transfer details to the supplier (Marketing Authorization Holder - MAH).
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".
Collaboration channel - inbound EPCIS	If an SAP ICH channel or a TraceLink Partner channel is configured to receive EPCIS from the supplier, select the channel you want to associate with the supplier.
Act as 3PL for this supplier	If you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Tatmeen (UAE) channel	If 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 a Tatmeen regulatory channel is configured for the tenant.
Collaboration Channel - outbound EPCIS message on behalf of MAH	If you act as a 3PL for this supplier and you want to send EPCIS shipping messages to SAP ICH on behalf of the supplier (MAH), select the previously configured SAP ICH channel. The field is available when the Act as 3PL for this supplier checkbox is selected and an SAP ICH channel is configured for the tenant.

3. Click Save Supplier.

Next Steps

Register the shipping address(es) of the supplier. For more information, see Registering the Shipping Address of a Supplier.

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

Upload an EPCIS file containing the trade items and containers from the supplier. For more information, see Uploading an EPCIS File.

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

Registering the Shipping Addresses of a Supplier

The shipping address holds the ship-from information.

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 Shipping Address tab.

In the following example, the selected supplier does not have any shipping address yet:

4. To add a shipping address, click Add Shipping Address. The application displays the Create shipping 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.

Field	Description
Shipping address ID	Enter a unique shipping address ID.
Shipping address name	Enter the name of the shipping address, for example, the company name.
City	Enter the city.
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 the countries.
Shipping address SGLN	Enter 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 called the ship-from location that sends the shipment.

Example:

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

Example:

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 example, the selected supplier does not have any product yet:

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 want 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.
Supplier is designated Wholesaler	Select the checkbox if the supplier is a designated (contracted) wholesaler of this product. Only applicable when an Arvato regulatory channel is set for the tenant to connect to a National system (NMVS) to perform FMD actions. After selecting the checkbox, Movilitas.Cloud collects the product master data from the National system through the corresponding Arvato regulatory channel. The application offers the designated wholesaler(s) in the Select designated wholesaler drop-down with an auto-selected value. Other cases: If there is no designated wholesaler data in the National system, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: No defined designated wholesalers. If the entered product is not existing in the National system, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: The product code is unknown. If the tenant does not have an Arvato regulatory channel, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: No data. Missing NMVS regulatory channel for the tenant.
Select designated wholesaler	Select the designated wholesaler in the drop-down list. The application offers an auto-selected value that you can change when there are multiple choices. The selected value is remembered.

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:

In the following example, the supplier of the entered product is a designated wholesaler:

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.

If the supplier is not flagged as a designated wholesaler, the product is created and added to the list. You can add a new product by repeating the above procedure.
If the supplier is flagged as a designated wholesaler and the supplier master data can be overwritten with the data from the National system, the application asks you to confirm overwriting:

When selecting Yes, the supplier master data (name and address fields) are overwritten, as applicable. The product is created and added to the list. You can add a new product by repeating the above procedure.
When selecting No, the supplier master data (name and address fields) are left intact but the product is created and added to the list. You can add a new product by repeating the above procedure.

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.

Case	What 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.

Case

What 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:

Indicators	Description	Example
Partnership status indicator next to the supplier 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":

Indicators

Description

Example

Partnership status indicator next to the supplier 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. You can find screenshot examples in this procedure.
Check the shipping addresses on the Shipping address tab. For screenshot examples, see Registering the Shipping Addresses of a Supplier.
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. For screenshot examples, see Creating the Products of a Supplier, Editing the Products of a Supplier, and Unassigning a Product from the Supplier.
Check the EPCIS file uploads on the Uploads tab. A log is created for each upload.
- It is possible to download the EPCIS file and the application displays:
  - A snapshot of the containers, trade items, and hierarchy as defined in the file.
  - The Advanced Shipping Notification.
- The tab also collects the EPCIS files received from SAP ICH.
- The tab also collects the EPCIS files received from TraceLink.
- The tab also collects the EPCIS files received in partnership.
- For more information, see Verifying the EPCIS File Received in Partnership or Through a Collaboration Channel and Uploading an EPCIS File.

In the following example, we are searching for supplier "Demo Supplier". The application displays the supplier master data:

Name and address (city, street, ZIP code, and country).
Supplier tag --> There are API calls from external systems to Movilitas.Cloud where the supplier is identified by this tag.
The supplier SGLN (location) is provided.
The supplier is not a partner in Movilitas.Cloud.
Other fields are left blank (not applicable).

In the following example, the tenant acts as a 3PL for the supplier. The application displays the supplier master data:

Name and address (city and country).
The Supplier email field is populated because the tenant sends EPCIS 1.1 files to the supplier by email. Applicable when the shipment is sent to Bahrain.
The supplier SGLN (location) is provided.
The supplier does not send any EPCIS from SAP ICH so the Collaboration channel - inbound EPCIS field is left blank. The tenant manually uploads EPCIS files received from the supplier.
The Act as 3PL for this supplier checkbox is selected.
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. The application displays the supplier master data:

Name and address (city and country).
The supplier SGLN (location) is provided.
The supplier does not send any EPCIS from SAP ICH so the Collaboration channel - inbound EPCIS field is left blank. The tenant manually uploads EPCIS files received from the supplier.
The Act as 3PL for this supplier checkbox is selected.
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 application displays the supplier master data:

The supplier is in "Partner" mode, meaning that the tenant that sent the invitation pays the invoices.
Address fields are populated.
Other fields are left blank (not applicable).

In the following example, the tenant acts as a 3PL for the supplier. The application displays the supplier master data:

Name and address (city and country).
The supplier SGLN (location) is provided.
The supplier sends EPCIS files from SAP ICH, so a previously configured SAP ICH channel is associated with the supplier in the Collaboration channel - inbound EPCIS field.
The Act as 3PL for this supplier checkbox is selected.
The tenant sends EPCIS messages to SAP ICH on behalf of the supplier (MAH), so a previously configured SAP ICH channel is associated with the supplier in the Collaboration Channel- outbound EPCIS message on behalf of MAH field.
The supplier is not a partner in Movilitas.Cloud.

Back to the list of procedures

Verifying the EPCIS File Received in Partnership or through a Collaboration Channel

The supplier can provide the input to you in an Electronic Product Code Information Services (EPCIS) file. The file describes the items that are shipped to your company together with the Advanced Shipping Notification (shipping event). By receiving the file, the items and the shipping event are registered in the Serialized Logistics application.

You can receive the file in one of the following ways:

(USA market only) In partnership with the supplier. In this case, the supplier uses Movilitas.Cloud to ship the items to your company. Once the transfer is created on the supplier's side, the EPCIS is automatically generated, placed, and processed in your view.
From SAP ICH through the SAP ICH channel that is associated with the supplier as the collaboration channel for inbound EPCIS.
From TraceLink through the TraceLink Partner channel that is associated with the supplier as the collaboration channel inbound EPCIS.
Outside Movilitas.Cloud. In that case, you can manually upload the EPCIS file on the supplier. For more information, see Uploading an EPCIS File.

After the file is received, the items are ready for warehouse activities (reaggregation and shipping).

It is possible to receive previously shipped items again in a file. If the received items are in a hierarchy that is different from the known one due to repackaging, the application automatically performs unpacking and registers the items with the new hierarchy.

Supported EPCIS versions:

EPCIS 1.1
EPCIS 1.2

Receiving 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 Marketing Authorization Holder (MAH) of the product.
- The company prefix of the product is stored. You can verify it under the Products tab on the Update supplier panel.
(USA market 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 that the following are configured:

SAP ICH channel - when receiving the EPCIS from SAP ICH.
TraceLink Partner channel - when receiving the EPCIS from TraceLink.
The supplier (sender) and the warehouse (receiver), including the location data (SGLN) and the collaboration channel for inbound EPCIS (SAP ICH or TraceLink Partner, when applicable).
Partnership with the supplier - when receiving the EPCIS in partnership with the 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. Click on the Uploads tab. The application displays a log of the received files with status in a paginated view.

Example - From SAP ICH:

Example - From TraceLink:

4. Find the file based on upload time and file name.

For EPCIS files from SAP ICH, the file name shows the origin and the date and timestamp in the following scheme: EPCIS_From_SAP_ICH_<YYYY_MM_DDTHH:MM:SS.sssZ>.xml.
For EPCIS files from TraceLink, the file name shows the TraceLink transaction type and the date and timestamp in the following scheme: PT_SOMINT_SALES_SHIPMENT_YYYYMMDDHHMMSSsss.xml. Note: If the TraceLink file is uploaded on the TraceLink Partner channel, only the file name is shown in the log.
(USA market only) For EPCIS files received in partnership, the file name shows the market, the purchase order ID, and the date and timestamp in the following scheme: Epcis_united_states_<purchase_order_id>_YYYY-MM-DDTHH:MM:SS.sssZ.xml.

5. Expand the log and verify that the file was successfully processed. The application displays the same types of information independently of the file source.

Expanding a successfully processed file that was received in partnership:

Expanding a log that contains an error. The error is displayed. The file is received from SAP ICH:

Expanding a log that contains a lot of errors. Instead of displaying the errors, the application displays the Download Errors file button to increase readability. The file is received from SAP ICH:

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

Status	Description	Action
Success (Checkmark icon)	The file was received without any errors.	Expand the log and perform the following: Check the snapshot of the containers, trade items, and hierarchy. Check the Advanced Shipping Notification (shipping event): Purchase order ID(s) Despatch advice - for example, delivery ID(s) 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. The errors are either displayed (a few errors) or collected in a file (a lot of errors) that can be downloaded.	Expand the log and perform the following: Investigate the error message. If there is a large list of errors, the application collects the errors in a file and displays the Download Errors file button instead of displaying the errors. In this case, download the file and investigate its content. Check the snapshot of the containers, trade items, and hierarchy. Identify the discrepancies. Check the Advanced Shipping Notification (shipping event): Purchase order ID(s) Despatch advice - for example, delivery ID(s) Use the Download EPCIS file button to download the EPCIS file. 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. Upload the new EPCIS file. For more information, see Uploading an EPCIS File.

Back to the list of procedures

Uploading an EPCIS File

The supplier can provide the input to you in an Electronic Product Code Information Services (EPCIS) file. The file describes the items that are shipped to your company together with the Advanced Shipping Notification (shipping event). By uploading the EPCIS file, the items and the shipping event are registered in the Serialized Logistics application.

After the upload, the items are ready for warehouse activities (reaggregation 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 Marketing Authorization Holder (MAH) of the product.
- The company prefix of the product is stored. You can verify it under the Products tab on the Update supplier panel.
(USA market 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 that the supplier (sender) and the warehouse (receiver) are configured, including the location data (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 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 in a paginated view.

Example:

Expanding a successful upload:

Expanding an upload that contains an error. The error is displayed:

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

Status	Description	Action
Success (Checkmark icon)	The file was uploaded without any errors.	Expand the log and perform the following: Check the snapshot of the containers, trade items, and hierarchy. Check the Advanced Shipping Notification (shipping event): Purchase order ID(s) Despatch advice - for example, delivery ID(s) 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. The errors are either displayed (a few errors) or collected in a file (a lot of errors) that can be downloaded.	Expand the log and perform the following: Investigate the error message. If there is a large list of errors, the application collects the errors in a file and displays the Download Errors file button instead of displaying the errors. In this case, download the file and investigate its content. Check the snapshot of the containers, trade items, and hierarchy. Identify the discrepancies. Check the Advanced Shipping Notification (shipping event): Purchase order ID(s) Despatch advice - for example, delivery ID(s) Use the Download EPCIS file button to download the EPCIS file. 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. Upload the new EPCIS file.

Back to the list of procedures

Updating a Supplier (Master Data and Shipping Address)

When updating a supplier, you can modify the master data including the business address (business location) and you can also manage the shipping addresses (ship-from locations). Updating the products of the supplier is described in Editing 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. In the Master data form on the Update supplier panel, modify the fields as needed.

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 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 want to send EPCIS 1.2 files containing the transfer details to the supplier (Marketing Authorization Holder - MAH).
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".
Collaboration channel - inbound EPCIS	If an SAP ICH channel or a TraceLink Partner channel is configured to receive EPCIS from the supplier, select the channel you want to associate with the supplier.
Act as 3PL for this supplier	If you perform third-party logistics (3PL) on behalf of the supplier, select this checkbox.
Tatmeen (UAE) channel	If 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 a Tatmeen regulatory channel is configured for the tenant.
Collaboration Channel - outbound EPCIS message on behalf of MAH	If you act as a 3PL for this supplier and you want to send EPCIS shipping messages to SAP ICH on behalf of the supplier (MAH), select the previously configured SAP ICH channel. The field is available when the Act as 3PL for this supplier checkbox is selected and an SAP ICH channel is configured for the tenant.

4. Click Save Supplier.

5. If applicable, select the Shipping address tab and manage the shipping addresses.

Operation on Shipping Address

Description

Add

Click Add Shipping Address, fill in the form as described below, and click Save. The required fields are marked with an asterisk (*) in the form.

Field	Description
Shipping address ID	Enter a unique shipping address ID.
Shipping address name	Enter the name of the shipping address, for example, the company name.
City	Enter the city.
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 the countries.
Shipping address SGLN	Enter 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 called the ship-from location that sends the shipment.

Edit

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

Example:

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

Editing 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. 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:

4. Edit a product by clicking the edit icon in the Action column.

Note: The already known fields are pre-filled and read-only in the Update product form. You cannot edit the fields that are critical in terms of database consistency and were provided before. You can still edit the active fields, the checkboxes, and the Select designated wholesaler drop-down (when applicable).

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 want 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.
Supplier is designated Wholesaler	Select the checkbox if the supplier is a designated (contracted) wholesaler of this product. Only applicable when an Arvato regulatory channel is set for the tenant to connect to a National system (NMVS) to perform FMD actions. After selecting the checkbox, Movilitas.Cloud collects the product master data from the National system through the corresponding Arvato regulatory channel. The application offers the designated wholesaler(s) in the Select designated wholesaler drop-down with an auto-selected value. Other cases: If there is no designated wholesaler data in the National system, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: No defined designated wholesalers. If the entered product is not existing in the National system, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: The product code is unknown. If the tenant does not have an Arvato regulatory channel, the application clears the Supplier is designated Wholesaler checkbox and displays the following message: No data. Missing NMVS regulatory channel for the tenant.
Select designated wholesaler	Select the designated wholesaler in the drop-down list. The application offers an auto-selected value that you can change when there are multiple choices. The selected value is remembered.

The following example illustrates the case when updating the company prefix of the product and the supplier is the MAH of the product:

The following example illustrates the case when providing the product name, the units of measurement and the company prefix while the supplier of the product is the designated wholesaler:

5. Click Save. One of the following is applicable:

If the supplier is not flagged as a designated wholesaler, the product is updated.
If the supplier is flagged as a designated wholesaler and the supplier master data can be overwritten with the data from the National system, the application asks you to confirm overwriting:

When selecting Yes, the supplier master data (name and address fields) are overwritten, as applicable. The product is updated.
When selecting No, the supplier master data (name and address fields) are left intact but the product is updated.

Back to the list of procedures

Unassigning a Product from the 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. 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:

4. 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: