Troubleshooting Index

Common issues and solutions organized by feature.

Quick Reference

Most Common Issues

Issue	Feature	Quick Fix
No available time slots	Order Capacity	Increase orders per slot limit
Delivery not available	Delivery Zones	Add customer's postal code to zone
Item showing sold out	Inventory	Restock or disable tracking
Payment failing	Payments	Check Stripe keys (live vs test)
Menu not showing	Menus	Assign menu to location
Kiosk blank screen	Devices	Assign menu to kiosk device

---

By Feature

Order Capacity

• No available time slots
• Kitchen overwhelmed despite limits
• Orders rejected unexpectedly

Online Ordering

• Location shows "Currently closed"
• Minimum order error
• Scheduled order not available
• ASAP not working

Delivery Zones

• "Delivery not available to your area"
• Wrong delivery fee shown
• Delivery time estimate incorrect

Menu Items

• Item not appearing on menu
• Price not updating
• Image not showing
• Allergens not displaying

Modifiers

• Required modifier not enforcing
• Price not adding correctly
• Max selections not working

Payments

• Card payment failing
• iDEAL not showing
• Refund not processing
• Webhook not receiving

Loyalty

• Points not earning
• Points not redeeming
• Balance incorrect

Devices

• Kiosk not connecting
• KDS not receiving orders
• Printer not printing

---

Troubleshooting Template

Each issue should include:

### Problem: [Issue Description]

**Symptoms**:
- What the user/customer sees
- Error messages

**Possible Causes**:
1. First possible cause
2. Second possible cause
3. Third possible cause

**Diagnostic Steps**:
1. How to identify the cause
2. What to check in backoffice
3. What to check in logs

**Solutions**:

**For Cause 1**:
1. Step to fix
2. Step to verify

**For Cause 2**:
1. Step to fix
2. Step to verify

**Prevention**:
- How to prevent this issue

---

Error Messages Reference

Online Ordering Errors

Error Message	Cause	Solution
"This location is not available"	Location disabled	Enable location in Settings
"We're currently closed"	Outside business hours	Check business hours config
"This time slot is no longer available"	Capacity reached	Choose different time or increase capacity
"Minimum order amount is €X"	Order below minimum	Add more items or adjust minimum
"Sorry, we don't deliver to your area"	Outside delivery zones	Add postal code to zone
"This item is currently sold out"	Stock = 0	Restock item
"Payment could not be processed"	Payment failed	Check payment config
"This promo code is invalid"	Code wrong/expired	Verify code in Offers
"Location not found"	Payment Profile not validated	Complete Payment Profile validation in Settings → Payments

Kiosk Errors

Error Message	Cause	Solution
"No menu available"	No menu assigned	Assign menu to kiosk
"Payment terminal not connected"	Terminal offline	Check terminal connection
"Unable to process order"	API error	Check network/backend

Backend Errors

Error Code	Meaning	Solution
400	Bad request	Check request data
401	Unauthorized	Check authentication
403	Forbidden	Check permissions
404	Not found	Check resource exists
422	Validation error	Check field values
500	Server error	Check backend logs
503	Service unavailable	Check capacity/load

---

Diagnostic Tools

In Backoffice

• Activity Log: See recent changes
• Transactions: Check order history
• Reports: Analyze patterns

In Browser

• Network tab: Check API calls
• Console: Check for errors
• Application tab: Check local storage

In Backend

• Laravel logs: storage/logs/laravel.log
• MongoDB queries: Check slow queries
• Queue jobs: Check failed jobs