Table of Contents

Common Issues

This section lists frequent problems encountered during POS integration and their recommended solutions.

1. Missing POS Item IDs

Issue: Orders are rejected because one or more items do not have a mapped POS ID.

Solution:

  • Validate menu mapping before certification.
  • Use the Template Menu for testing.
  • Implement error handling to log missing IDs.

2. Incorrect Price or Tax Calculation

Issue: POS shows mismatched prices or taxes compared to UEAT.

Solution:

  • Ensure default prices are used (no discounts applied twice).
  • Validate tax configuration model.
  • Test with edge cases like price overrides and the combination of different tax rate and promotions on specific items.

3. Special Characters Not Supported

Issue: Customer names or addresses with accents or emojis cause errors.

Solution:

  • Confirm POS supports UTF-8 encoding.
  • Test with accented characters during certification.

UEAT is not responsible for any issues related to special characters between the POS an the MEV web of a KDS.

4. Order Rejected Without Clear Reason

Issue: POS rejects an order but does not provide a detailed error message.

Solution: Follow the standard response format:

{
  "errors": [
    {
      "code": "Rejected",
      "message": "Missing POS ID for Item Id 953518, _Ueat Item Name_ Order rejected"
    }
  ]
}
  • Log all rejection reasons for troubleshooting.

5. Resend Flow Not Implemented

Issue: Corrected orders cannot be resent after initial rejection.

Solution:

  • Implement manual resend logic as described in Status Management.
  • Ensure POS can accept resent orders without duplication.

6. Menu Synchronization Delays

Issue: Menu updates do not propagate to UEAT or POS in time.

Solution:

  • Validate push/pull frequency.
  • Confirm centralized menu updates at HQ level.

7. Test Orders Impacting Production

Issue: Test orders appear in live reports or dashboards.

Solution:

  • Always use the dedicated sandbox URL for testing.
  • Tag test orders clearly for filtering.

8. Printing Issues

Issue: Notes do not appear on kitchen tickets or invoices.

Solution:

  • Validate printing configuration during certification.
  • Ensure note fields are mapped correctly.