Invoice / Receipt Formatting Issues – Complete Troubleshooting Guide (Hana POS)

Overview

Invoice and receipt formatting in Hana POS is critical for:

• Customer communication
• Professional presentation
• Legal and accounting records

Receipts and invoices are often the final customer-facing output, making accuracy and clarity essential.

? Even small formatting issues can lead to:

• Customer confusion
• Reprinting delays
• Perception of unprofessional service

Why This Matters (Support Context)

Formatting issues are highly visible and often reported urgently during live operations.

? Key Insight:
Most formatting issues are caused by:

• Printer configuration mismatches
• Incorrect paper size settings
• Scaling or margin issues
• Incorrect printer mapping in Hana POS

? These are typically printer/environment-related issues, not system bugs.

Common Symptoms Reported by Florists

Florists may report:

• “Receipt is misaligned”
• “Text is cut off”
• “Card message not printing properly”
• “Receipt looks different than before”
• “Some details are missing on the receipt”

Root Cause Categories

1. Incorrect Printer Configuration

• Wrong printer settings applied
• Printer not configured for correct output

2. Paper Size Mismatch

• Thermal printer using incorrect roll size
• Standard printer set to wrong paper format (A4/Letter)

3. Scaling and Margin Issues

• Scaling not set to 100%
• Margins cutting off content

4. Incorrect Printer Mapping in Hana POS

• Receipt or card message mapped to wrong printer
• Multiple printers causing confusion

5. Template / Layout Sensitivity

• Thermal printers require precise alignment
• Small changes can affect formatting

Step-by-Step Troubleshooting Process

⚠️ Always identify the printer type before adjusting settings.

Step 1: Identify Printer Type (Critical First Step)

Ask:

“Are you using a receipt (thermal) printer or a regular printer?”

? Why this matters:

• Formatting behavior depends entirely on printer type

Step 2: Check Paper Size Configuration

For Thermal Printers:

• Ensure correct roll size (e.g., 80mm / 58mm)

For Standard Printers:

• Verify paper size:
  • A4
  • Letter

? Key Insight:
Incorrect paper size is the most common cause of cut-off or misaligned receipts.

Step 3: Verify Printer Preferences (Windows Level)

Guide florist:

• Go to Devices and Printers
• Right-click the printer → Printer Preferences

Check:

• Paper size
• Margins
• Scaling → must be 100%

? Why this matters:
Scaling or margin issues can distort the entire layout.

Step 4: Verify Printer Mapping in Hana POS

Navigate to:
Settings → Printing Configuration

Confirm:

• Correct printer assigned for:
  • Receipts
  • Card Messages

? Key Insight:
Incorrect mapping may send output to a printer with incompatible settings.

Step 5: Print Test Output

• Print a sample receipt or card message
• Check:
  • Alignment
  • Text visibility
  • Spacing

? Why this matters:
Validates whether adjustments have resolved the issue.

Step 6: Test Outside Hana (If Needed)

• Print a test page from Windows

? Interpretation:

• If test page fails → printer issue
• If test page works → Hana configuration issue

Critical Scenarios & Handling

Receipt is Cut Off

Possible causes:

• Paper size mismatch
• Scaling not set correctly

✅ Action:

• Verify paper size
• Set scaling to 100%

Text Misaligned or Shifted

Possible causes:

• Margin settings
• Thermal alignment sensitivity

✅ Action:

• Adjust printer preferences
• Re-test print

Card Message Not Printing Properly

Possible causes:

• Incorrect printer mapping
• Wrong paper size

✅ Action:

• Verify mapping in Hana
• Check printer settings

Receipt Looks Different Suddenly

Possible causes:

• Printer settings changed
• Default printer switched

✅ Action:

• Recheck printer preferences
• Confirm default printer

Missing Details on Receipt

Possible causes:

• Layout cut-off
• Scaling/margin issue

✅ Action:

• Adjust margins
• Reprint test

Best Practices for Support Agents

• ✅ Always identify printer type first
• ✅ Verify paper size and scaling
• ✅ Check printer mapping in Hana
• ✅ Test both inside and outside Hana
• ❌ Do NOT assume system issue without printer validation
• ❌ Avoid skipping Windows-level settings

Escalation Guidelines

Escalate ONLY IF:

• Windows test print works but Hana output is incorrect
• Formatting issue persists after all configuration checks
• Multiple users report the same issue
• Template/layout appears broken system-wide

? Include in escalation:

• Printer type (thermal/standard)
• Paper size used
• Printer settings (scaling/margins)
• Sample output (screenshot/photo)
• Steps already attempted

FAQ Section

Q1: Why is my receipt cut off?

Most commonly due to:

• Incorrect paper size
• Scaling not set to 100%

Q2: Why is card message not aligned properly?

Possible reasons:

• Incorrect printer mapping
• Paper size mismatch

Q3: Why does the receipt look different suddenly?

Printer settings or default printer may have changed.

Q4: Are thermal printers sensitive to settings?

Yes, even small changes in alignment or paper size can affect output.

Support Agent Script (Standardized)

Opening

“I understand the receipt formatting is not correct. Let’s fix that step by step.”

Validation

“First, let’s check your printer type and paper size.”

Guided Troubleshooting

“We’ll review your printer settings and ensure everything is configured correctly.”

Adjustment

“Let’s make a few adjustments and test the output.”

Closure (Resolved)

“Please try printing again now — it should look correct.”

Closure (Escalation)

“Thanks for trying those steps. I’ll escalate this for further review.”