Fire Order

Fire Order is triggered after an order has been created with orderNotificationType set to HOLD. The process ensures that orders are correctly fired to the POS system and updates the integration partner accordingly.


Fire Order Workflow Steps:

  1. Start of Fire Order

The workflow begins after an order has been created as initial step and then placed/updated status on HOLD.

  1. Integration Partner Submits Fire Order

The integration partner triggers the fire order process by submitting a request to move the order from HOLD to active processing.

  1. Khumbu Checks if Order Exists with Status "HOLD"
    1. The system verifies whether the order exists and is currently in the HOLD state.
    2. Decision Point:
      Yes: If the order exists with the correct status, the fire order process proceeds.
      No: If the order does not exist or is not on HOLD, the request fails with an error message.
  2. Order Failure with Error Message

If the order does not exist or is not in the correct status, an error message is generated, and the process ends.

  1. Start Fire Order Processing

If the order exists in the HOLD status, Khumbu initiates the fire order process.

  1. Send Request to POS System for Order Creation

The order details are sent to the POS (Point of Sale) system for processing.

  1. Fire Order Success?
    1. The POS system responds with the success or failure of the order creation.
    2. Decision Point:
      Yes: The order is successfully processed.
      No: The order fails to be created in the POS system.
    3. Order Successful: If the fire order is successfully processed, it is marked as completed.
    4. Order Failure: If the fire order fails at the POS system level, an error is logged, and the integration partner is informed.
  2. Update Integration Partner with Order Status on Webhook

The integration partner is notified of the order status (success or failure) via webhook.

  1. End of Fire Order Processing
    The workflow concludes after the integration partner is updated.

Key Features

  1. Validation Check:
    The Fire Order workflow consists of two main steps, ensuring controlled order creation and fire order execution. Ensures only valid orders in HOLD status proceed to fire order processing.
  2. POS System Integration:
    Sends fire order requests directly to the POS system for order execution.
  3. Webhook Notifications:
    Keeps integration partners updated on order status in real time.
  4. Error Handling:
    Provides clear error messages when an order does not exist or fails to process.