Customer Sharing

گاہک کی شیئرنگ

Customer Sharing

RentOyee supports a secure inter-business customer network. If a customer is already registered with another RentOyee business, you can import their verified profile instead of re-entering their information from scratch.

How Customer Sharing Works

  • Every customer is uniquely identified by their CNIC number across the platform
  • When you enter a CNIC that exists in another business, you receive an "already in network" notification
  • You can import the shared profile — name, CNIC, and verification status transfer over
  • Each business maintains its own independent booking and payment records for that customer
  • Sensitive documents (CNIC scans) are stored per-business on the secure private disk

CNIC Issue Date Verification (Security)

Before linking a shared customer, the system requires you to enter the customer's CNIC issue date to confirm identity. This prevents accidental or fraudulent linking of wrong customer profiles.

  • If the issue date matches the stored record → the request proceeds normally.
  • If the issue date differs from the stored record → the system runs a 3-step flow:
    1. You are prompted for the new CNIC expiry date.
    2. You are then asked to upload a CNIC front photo and a CNIC back photo.
    3. All fields (issue date, expiry date, photos) are submitted together via secure multipart upload and saved on the customer record.
  • If no issue date is stored yet, the submitted date is saved automatically.
Problem/Solution:

Problem: User enters wrong CNIC → system links wrong customer.
Solution: CNIC issue date acts as a secondary verification factor. When the date differs, updated photos are also required — ensuring the CNIC on record stays current.

Route

POST /customers/{customer}/request-sharing (route name: customers.request-sharing)

Required Fields

  • customer_id — The customer to link (required)
  • cnic_issue_date — CNIC issue date in YYYY-MM-DD format (required)
  • cnic_expiry_date — CNIC expiry date (required only when issue date changed)
  • cnic_front_photo — Image file, max 5 MB (required when issue date changed)
  • cnic_back_photo — Image file, max 5 MB (required when issue date changed)

Note: When photos are included, the request must be sent as multipart/form-data (not JSON). The JavaScript automatically switches to FormData when submitting photos.

How to Import a Shared Customer

1Add New Customer

Go to Customers → Add Customer and enter the customer's CNIC number.

2Network Match Found

If the CNIC is already in the network, a notification appears: "Customer found in RentOyee network".

3Enter CNIC Issue Date

A verification dialog asks for the customer's CNIC issue date. Enter the date printed on the front of the CNIC card.

4Update if Changed (New Expiry Date)

If the system detects the issue date changed, you will be asked for the new expiry date in a second dialog.

5Upload Updated CNIC Photos

After entering the expiry date, a third dialog asks you to upload a clear photo of the CNIC front and back. Both photos are required and stored securely on the private disk.

6Request Sent & Customer Linked

Once submitted, the CNIC record is updated and the sharing request proceeds (consent-based or auto-approved depending on your business settings).

Privacy Note:

Customer sharing is governed by RentOyee's privacy policy. CNIC photos are stored on a secure private disk with HMAC-hashed paths — they are never publicly accessible and never shared between businesses.

گاہک کی شیئرنگ

RentOyee کاروباروں کے درمیان محفوظ گاہک نیٹ ورک کی سہولت دیتا ہے۔ اگر کوئی گاہک کسی دوسرے RentOyee کاروبار میں رجسٹرڈ ہے تو آپ ان کا تصدیق شدہ پروفائل درآمد کر سکتے ہیں۔

گاہک شیئرنگ کیسے کام کرتی ہے

  • ہر گاہک کو ان کے CNIC نمبر سے منفرد شناخت کی جاتی ہے
  • جب آپ ایسا CNIC درج کریں جو نیٹ ورک میں موجود ہو تو اطلاع ملتی ہے
  • آپ تصدیق شدہ پروفائل درآمد کر سکتے ہیں
  • ہر کاروبار اپنی بکنگ اور ادائیگی کے ریکارڈ خود رکھتا ہے
  • CNIC تصاویر ہر کاروبار کی نجی ڈسک پر محفوظ طریقے سے الگ محفوظ ہوتی ہیں

CNIC جاری کرنے کی تاریخ کی تصدیق (سیکیورٹی)

گاہک کو لنک کرنے سے پہلے، سسٹم آپ سے گاہک کی CNIC جاری کرنے کی تاریخ مانگتا ہے تاکہ شناخت کی تصدیق ہو سکے۔

  • اگر تاریخ مل جائے — درخواست عام طریقے سے آگے بڑھتی ہے۔
  • اگر تاریخ مختلف ہو — سسٹم 3 مراحل میں کام کرتا ہے:
    1. نئی CNIC میعاد ختم ہونے کی تاریخ مانگی جاتی ہے۔
    2. پھر CNIC کا سامنے کی تصویر اور پچھلی تصویر اپلوڈ کرنے کو کہا جاتا ہے۔
    3. سب فیلڈز (تاریخیں اور تصاویر) ایک ساتھ محفوظ طریقے سے بھیجے جاتے ہیں اور گاہک کے ریکارڈ میں محفوظ ہو جاتے ہیں۔
  • اگر کوئی تاریخ محفوظ نہ ہو تو دی گئی تاریخ خودکار محفوظ ہو جاتی ہے۔
مسئلہ/حل:

مسئلہ: غلط CNIC درج کریں تو غلط گاہک لنک ہو جائے۔
حل: CNIC جاری تاریخ ثانوی تصدیقی عنصر ہے۔ تاریخ بدلنے پر نئی تصاویر بھی لازمی ہیں — اس سے ریکارڈ میں موجود CNIC ہمیشہ تازہ رہتا ہے۔

ضروری فیلڈز

  • customer_id — گاہک کی شناخت (لازمی)
  • cnic_issue_date — CNIC جاری تاریخ YYYY-MM-DD فارمیٹ میں (لازمی)
  • cnic_expiry_date — CNIC میعاد ختم تاریخ (صرف اس وقت لازمی جب تاریخ بدلی ہو)
  • cnic_front_photo — تصویر فائل، زیادہ سے زیادہ 5 MB (جب تاریخ بدلی ہو)
  • cnic_back_photo — تصویر فائل، زیادہ سے زیادہ 5 MB (جب تاریخ بدلی ہو)

گاہک شیئر کرنے کا طریقہ

1نیا گاہک شامل کریں

Customers → Add Customer پر جائیں اور CNIC نمبر درج کریں۔

2نیٹ ورک میں ملا

اگر CNIC نیٹ ورک میں ہے تو اطلاع ملتی ہے۔

3CNIC جاری تاریخ درج کریں

تصدیقی ڈائلاگ میں گاہک کی CNIC جاری کرنے کی تاریخ درج کریں (جو CNIC کارڈ کے سامنے چھپی ہو)۔

4نئی میعاد تاریخ درج کریں (اگر تاریخ بدلی ہو)

دوسرے ڈائلاگ میں نئی CNIC میعاد ختم تاریخ درج کریں۔

5CNIC تصاویر اپلوڈ کریں

تیسرے ڈائلاگ میں CNIC کے سامنے اور پچھلے حصے کی واضح تصویریں اپلوڈ کریں۔ دونوں لازمی ہیں اور نجی ڈسک پر محفوظ ہو جاتی ہیں۔

6درخواست بھیجی گئی

CNIC ریکارڈ اپڈیٹ ہو جاتا ہے اور شیئرنگ کی درخواست آگے بڑھتی ہے۔

رازداری:

CNIC تصاویر HMAC-hashed راستوں والی نجی ڈسک پر محفوظ ہوتی ہیں — یہ کبھی عوامی نہیں ہوتیں اور کاروباروں کے درمیان شیئر نہیں ہوتیں۔