OTP (One Time Password) Process

The OTP (One Time Password) process secures Click & Collect orders by verifying that only the rightful customer can collect their package. This tutorial provides a detailed, step-by-step guide to managing the OTP process for Click & Collect orders within the Instore and OMS systems.

Prerequisites​

1. Enable OTP Feature:

   • Ensure that the OTP feature is enabled in your system. Check that the IS_OTP_ENABLED value in the ApplicationSettings is set to true for OTP functionality to be active. Please refer to the Application Settings document.

Click & Collect Process​

Step 1: Verify Package Details​

1. Confirm Order Type:

   • Access the package table and verify the package’s details.

   • Check the Delivery From Store column. It should be marked as Yes.

   • Check the Delivery Type column. It should be set to In_store.

     
2. Package Status:

   • Ensure that the package status is Ready For Customer.

Step 2: Initiate Package Collection​

1. Locate the Package:

   • The store employee should find the package with the status Ready For Customer in the system.

2. Click & Collect Pack Item Button:

   • To deliver the package to the customer; begin the verification process with the "Delivered" button for the package in the "Ready for Customer Pickup" status.

Step 3: OTP Verification​

1. Check OTP Feature Status:

   • Determine if the is_enabled_otp setting is active.

   • If is_enabled_otp is active:

     1. The SelfServisPackageDelivery command will trigger a modal window.

     2. Enter the SMS verification code received from the customer into this modal for validation.

     3. After successful verification:

        • A success message will be displayed on the screen.

        • The package status will be automatically updated to Delivered.

   • If is_enabled_otp is not active:

     1. The SelfServisPackageDelivery command will execute without sms verification code.

     2. The package status will be updated to Delivered without requiring a verification code.

Step 4: Manage Click & Collect Orders in Omnitron​

1. Order Creation:

   • Ensure that a Click & Collect order is created in the Omnitron application.

2. Package Management:

   • A package is generated in the stock location of the order.

   • Initially, the package status is set to Waiting.

Essential Package Statuses and Settings for Instore​

To move the package through various states, execute the following commands:

1. Complete Packaging Without Shipment​

• Command Name: Complete Packaging Without Shipment

• Source State: Waiting

• Destination State: Packed All Items

• Command Code: COMPLETE_PACKAGING_WITHOUT_SHIPMENT

• Visibility: OMS WEB, INSTORE

• Configuration: {}

Procedure:

• Execute this command to change the package status from Waiting to Packed All Items.

2. Ready For Customer Pickup​

• Command Name: Ready For Customer Pickup

• Source State: Packed All Items

• Destination State: Ready for Customer Pickup

• Command Code: READY_FOR_PICKUP

• Visibility: OMS WEB, INSTORE

• Configuration: {}

Procedure:

• Execute this command to generate an OTP for the package. The OTP is sent to the Extension application via the PackageReadyForCustomerPickupWhispererEvent event.

• The OTP is then included in the SMS sent to the customer.

• The package status will be updated to Ready for Customer Pickup.

  

3. Self Service Package Delivery​

• Command Name: Self Service Package Delivery

• Source State: Ready for Customer Pickup

• Destination State: Delivered

• Command Code: SELF_SERVICE_PACKAGE_DELIVERY_COMMAND

• Visibility: OMS WEB, INSTORE

• Configuration: {}

Procedure:

• When the customer arrives to pick up the package, the store staff locates the package in the OMS/Instore application.

• Execute this command and request the OTP from the customer.

• Enter the provided OTP. If it matches the OTP generated for the package, the package status will be updated to Delivered, completing the process.

• If the OTP is incorrect, an error message will be displayed, and the package status will remain as Ready for Customer Pickup.

Error Handling​

Incorrect OTP​

• Issue: If the OTP provided by the customer does not match the generated OTP, an error message will be displayed.

• Resolution: The package status will remain as Ready for Customer Pickup, and the customer will need to retry with the correct OTP.