Phone Number Already Exists in Breeze FSM – Troubleshooting Guide

β€œPhone number already exists” during Party Creation

πŸ“Œ Feature Name:
Duplicate Mobile Number Validation in Party Creation

πŸ–ΌοΈ Reference Screenshot: (Add screenshot here)


πŸ“ Description

This error appears when a user attempts to create a new party (shop/customer) with a mobile number that is already registered in the Breeze FSM system β€” regardless of who created it.
The system blocks duplicate entries to ensure clean, accurate, and trackable party data.


⚠️ Error Message Displayed:

"Phone number already exists"


βœ… Reasons Why This Happens

  1. Mobile number already used for another party

    • Breeze FSM does not allow two parties with the same mobile number, even if created by different users or under different distributors.

  2. Maintaining unique & genuine data

    • Duplicate numbers cause confusion in visit history, order tracking, and collections.

  3. Preventing accidental duplication

    • Alerts the user that the number is already in use.

  4. Accurate reporting & tracking

    • Unique phone numbers ensure sales, orders, and collections are assigned correctly.

  5. Preventing misuse

    • Stops the same number from being used across multiple shops to bypass system checks.


πŸ› οΈ Recommended Actions

Step 1: Search if the party already exists

  • Open the app β†’ Go to Parties

  • Use the search option and enter the mobile number

  • If found, reuse the existing party record

Step 2: Double-check typing

  • Ensure the number is entered correctly

Step 3: Different shop, same number

  • Contact Admin/Backend Team for review & approval

Step 4: Use alternate number

  • If available, enter another valid phone number


πŸ“Œ Important Notes

  • Mobile number in Breeze FSM is a unique identifier (like Aadhar/PAN).

  • Duplicate entries can cause operational and tracking errors.

  • Always search before creating a new record.