Data Sync Issues – Complete Troubleshooting Guide

Overview

Data synchronization in Hana POS ensures real-time consistency across multiple systems, including:

• POS system (Hana POS)
• Website / online orders
• Payment gateways
• Driver / delivery applications

? Sync ensures that actions performed in one system are accurately reflected across all others.

Why This Matters (Support Context)

Data sync issues can create confusion and operational risk, as users may see incomplete or outdated information.

? Key Insight:
Most sync issues are caused by:

• Temporary processing delays
• Network interruptions
• Session or browser refresh issues
• Backend processing queues

? These are typically temporary and self-resolving, not system defects.

Common Symptoms Reported by Florists

Florists may report:

• “Order is not showing in POS”
• “Order status is not updating”
• “Changes are not reflecting”
• “Payment is done but not updated”
• “Website and POS data don’t match”

Root Cause Categories

1. Temporary Sync Delay (Most Common)

• System processing time
• Queue-based updates

2. Network Interruption

• Unstable internet connection
• Interrupted communication between systems

3. Session / Browser Issues

• Stale session data
• Page not refreshed

4. Backend Processing Delay

• High system load
• Delayed API responses

5. Cross-System Dependency

• Website, payment, or driver system not fully updated
• Source system delay

Step-by-Step Troubleshooting Process

⚠️ Always identify what type of data is not syncing before proceeding.

Step 1: Identify Sync Type (Critical First Step)

Ask:

“What exactly is not syncing — orders, payments, or status updates?”

? Why this matters:

• Determines which system dependency to check
• Helps isolate the issue quickly

Step 2: Refresh the System

• Refresh the page
• Reopen the order or module

? Why this works:
Many sync issues are due to stale UI data.

Step 3: Re-login to Hana POS

• Log out
• Log back in

? Why this works:
Resets session and reloads fresh data from the server.

Step 4: Allow Time for Sync

Explain to florist:

“Sometimes the system takes a few moments to sync data across systems.”

• Wait briefly (30–60 seconds)
• Retry checking

? Key Insight:
Most sync issues resolve within a short time window.

Step 5: Verify Data at Source System

Check the origin of data:

• Website → Confirm order exists
• Payment system → Confirm payment success
• Driver app → Confirm delivery update

? Why this matters:
If the source system hasn’t updated, Hana cannot sync it.

Critical Scenarios & Handling

Order Not Showing in POS

Possible causes:

• Sync delay
• Website order not fully processed

✅ Action:

• Refresh
• Wait briefly
• Verify on website

Payment Done but Not Updated

Possible causes:

• Payment gateway delay
• Sync delay

✅ Action:

• Confirm payment success
• Wait and refresh

Status Not Updating

Possible causes:

• Backend delay
• Session not refreshed

✅ Action:

• Re-login
• Recheck order

Changes Not Reflecting

Possible causes:

• Cached data
• Sync delay

✅ Action:

• Refresh page
• Log out and back in

Mismatch Between Systems

Possible causes:

• Source system not updated
• Sync delay

✅ Action:

• Verify source
• Wait and recheck

Best Practices for Support Agents

• ✅ Always identify what data is not syncing
• ✅ Refresh and re-login before deeper troubleshooting
• ✅ Verify source system first
• ✅ Allow reasonable sync time before escalation
• ❌ Do NOT escalate immediately for minor delays
• ❌ Avoid assuming data loss without verification

Escalation Guidelines

Escalate ONLY IF:

• Sync delay exceeds expected time (beyond normal wait)
• Data mismatch persists after refresh and verification
• Multiple sync failures reported
• Critical data missing across systems

? Include in escalation:

• Type of data (order/payment/status)
• Order ID or reference
• Source system confirmation
• Time of issue
• Screenshots (if available)
• Steps already attempted

FAQ Section

Q1: Why is my order not showing immediately?

Due to temporary sync delay between systems.

Q2: Why is payment not reflecting in POS?

Payment gateway may not have synced yet.

Q3: Why is order status not updating?

System may still be processing the update.

Q4: How long does sync usually take?

Typically a few seconds to a minute.

Support Agent Script (Standardized)

Opening

“It looks like a sync delay. Let’s check this step by step.”

Clarification

“Can you confirm what exactly is not syncing — order, payment, or status?”

Guided Troubleshooting

“Let’s refresh the page and recheck the data.”

Reassurance

“This is usually temporary and resolves quickly.”

Closure (Resolved)

“The data is now synced correctly.”

Closure (Escalation)

“Thanks for checking that. I’ll escalate this for further review.”