Skip to main content

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.

NOTE

If you encounter an error with the OTP code, refer to the Error Handling section for information.

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.