Movilitas.Cloud enables manufacturers and distributors to connect to the National Agency of Drug and Food Control in Indonesia (Badan Pengawas Obat dan Makanan - BPOM). After the connection is established, they can import shipping locations, report data to BPOM, monitor BPOM logs and external returns, and resend failed messages.


Currently, the BPOM channel can be used in the following applications:

  • Serialized Manufacturing
  • Serialized Logistics


List of Procedures


For more information on the general channel actions, see Managing Channels for a Tenant (Overview).


Configuring a BPOM Channel


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.



4. Depending on your setup, create a BPOM channel or modify an existing one. Follow one of the procedures described in the table below.


#Create a ChannelModify an Existing Channel
4.1Click the + icon (Create channel). The application displays the Create channel dialog.To search for a BPOM channel, use the search field and the filters:
  • Enter the channel name in the search field.
  • Select the status.
  • Select BPOM as the source.
  • Select Regulatory channel as the type.
4.2Select Regulatory channel as the type and click Create.

The application displays the Create Channel page with an empty form to give the basic parameters of the channel.		To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel.

The application displays the Edit Channel page and you can see the BPOM Connection Settings form.
4.3Enter a name for the channel and select BPOM as the source.N/A
4.4Click Create Channel.

The application displays the Edit Channel page and you can see the BPOM Connection Settings form.		N/A


Example when creating a BPOM channel:



5. Enter your BPOM credentials and a support email address as explained in the table below.


ParameterAction
UsernameEnter the BPOM username.
Password

Enter the BPOM password.

Support e-mailEnter the email address where Movilitas.Cloud can send notifications about errors on the channel. The email will contain the name of the BPOM channel with a link to the channel page where the request failed.


6. Click Save Settings.


7. Check the connection status at the top of the BPOM Connection Settings form. Click on the status to refresh it.


Once the connection is established, you can check the BPOM logs and the BPOM returns, and import the BPOM shipping locations.


8. (Optional) If needed, change the name of the channel and click Save Channel.


Next Steps


Import the BPOM shipping locations to the Serialized Logistics application. Configure the Serialized Manufacturing and Serialized Logistics application with the BPOM channel.


Back to the list of procedures



Viewing BPOM Logs and Resending Failed Messages


You can view all the messages sent to and coming from BPOM. You can also resend failed requests to BPOM. Each resending action creates a new log in the list and the resent messages are highlighted separately.


To ease finding the right log, you can filter specific logs based on their status and action types, as described in the table below.


FilterDescription
StatusYou can filter the logs based on their status:
  • All (Default) - Displays all the actions.
  • Successful - Displays only the actions that were successfully processed. 
  • Failed - Displays only the actions that failed in BPOM.
Action type

You can filter the logs based on their action type, and you can select multiple action types. By default, all the action types are displayed except for the ones related to authentication.


Movilitas.Cloud logs the following actions:

  • Aggregate - Action related to aggregation. A trade item or a container (SSCC) is packed into a container (SSCC).
  • Authenticate - Action related to authentication.
  • Get Locations - Action related to fetching the shipping locations (destinations) from BPOM.
  • Register Parents - Action related to the registration of containers (SSCCs).
  • Register Trade Items - Action related to the registration of packs (cartons).
  • Report Receipt - Action related to a receipt of items.
  • Report Shipment - Action related to shipped items.
  • Get Pendings - Action related to fetching the pending returns from BPOM.



Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Find the BPOM channel. Use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select BPOM as the source.
  • Select Regulatory channel as the type.


5. To view the BPOM channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the BPOM connection settings, the BPOM logs, the BPOM returns, and the Import shipping locations panel header in a collapsed view, by default.


Example:



6. Check the connection status and make sure that the connection to the BPOM system is established.


7.  In the BPOM logs section, review the logs. The application displays the action related to the log, the status of the action, and the date and time when the action was executed. 

  • Filter on the logs by selecting the status and the action types in the corresponding drop-down.
  • Reset the filters by clicking Reset filters.
  • Sort the logs in ascending or descending order based on Status or Sent Datetime.
  • Click on the Refresh icon in the top-right corner to refresh the list.


8. Expand a log for further details by clicking the > (Expand) icon on the left.


The application displays further information, including the details of the request and the details of the response, respectively.


In the following example, we are filtering all successful logs having the action type Register Trade Items. Then, we are expanding an action for the details:



9. For failed messages, investigate the issue, find a resolution, and resend.


 A few examples of when you can resend a failed message:

  • The connection to BPOM was down while sending the original request, but the connection is up and running again.
  • The configuration in BPOM is aligned to accept the request that failed before.


Before resending, consider the following:

  • Each resending generates a new log in the list.
  • If the resending fails, you can resend the newly created log/message only. This means you can resend the same log/message only once.
  • To identify the content of the message and all the logs belonging to the same request, expand the corresponding logs one by one.


The following table summarizes how the different resending cases are displayed in the BPOM logs.


CaseDescriptionAction
Resending for the first time. Original message that failed.To resend, click Resend.
An original message that failed but it has been resent.

Not possible to resend the original message again.		From this view, we do not know if the resending is successful. To verify this, check the newly created log belonging to this request.
A resent message that failed and is waiting for resending.To resend, click Resend.
A resent message that failed, and then it was resent again.

Not possible to resend this message again.		From this view, we do not know if the resending is successful. To verify this, check the newly created log belonging to this request.
A message that was successful. Resending action is not needed.No further action.



Back to the list of procedures



Viewing BPOM Returns (External Returns)


You can view the pending returns belonging to your account (channel).


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Find the BPOM channel. Use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select BPOM as the source.
  • Select Regulatory channel as the type.


5. To view the BPOM channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the BPOM connection settings, the BPOM logs, the BPOM returns, and the Import shipping locations panel header in a collapsed view, by default.


Example:



6. Check the connection status and make sure that the connection to the BPOM system is established.


7.  In the BPOM returns section, review the returned items waiting for receipt. The application displays the barcode, the batch, and the NIE license information.

  • Filter on the returns by entering the NIE license, the batch, or both. Enter the full value to make the search effective.
  • Reset the filters by clicking Reset filters.
  • Click on the Refresh icon in the top-right corner to refresh the list.


In the following example, we are filtering on returns of a product (NIE) with a specific batch as the product has multiple batches in the system:

 



Back to the list of procedures



Importing BPOM Shipping Locations


You can specify if the shipping location is a warehouse or a client and import it to the Serialized Logistics application. You can also decide not to import a location.

  • Warehouses represent internal departments.
  • Clients represent external destinations.


Before You Begin


Make sure that the Serialized Logistics application is enabled (activated).


Procedure


1. Go to Movilitas.Cloud Console --> My tenants.

2. Select the tenant or click Open tenant next to it.

3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.

4. Find the BPOM channel. Use the search field and the filters:

  • Enter the channel name in the search field.
  • Select the status.
  • Select BPOM as the source.
  • Select Regulatory channel as the type.


5. To view the BPOM channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the BPOM connection settings, the BPOM logs, the BPOM returns, and the Import shipping locations panel header in a collapsed view, by default.


6. Check the connection status and make sure that the connection to the BPOM system is established.


7. To load the shipping locations allowed for the BPOM account, click on the Import shipping locations panel header. The Import shipping locations panel is expanded and you can see the list of shipping locations.


Note: To view the log about getting the locations, click the Refresh icon on the top-right corner of the BPOM logs section.


8. Define the location type for each item:

  • When selecting Warehouse, the list of warehouses will be updated in the Serialized Logistics application.
  • When selecting Client, the list of clients will be updated in the Serialized Logistics application.
  • When selecting Do not import, the location will not be imported in the Serialized Logistics application.

In the following example, we set "Warehouse" as the location type for all the locations:




9. Click Save Locations. The shipping locations are imported to the Serialized Logistics application based on the settings. For more information, open the Serialized Logistics application --> Site management tab, and check Warehouses or Clients.


Back to the list of procedures