Troubleshooting ArUco Codes

This article details troubleshooting steps to take if ArUco labels are not being recognized correctly on the kiosk.

Step 1

Resolve Recognition Issues

Verify Label Placement Verify the label is in a clear area, flat on top of the product packaging.  Verify the label is not wrapped around the product's edges or sides. If you are printing a label that contains 2 ArUco codes (One for the top, and one for the back of the item) please ensure the codes are not placed on the same side of the product.  Ensure nothing, including thaw stickers, obstructs the Aruco codes.

• Verify Active Items

  • Navigate to Creator to ensure that the item linked to the Aruco code is active.

• • ArUco Codes linked to inactive items will often prompt "Please See Cashier" alert.

Step 2

Address Printing Issues

• Menu Tablet Sync Verification
  

  • If you are using a third-party system to print Aruco codes, verify that it is correctly synchronized with the settings configured in Creator. 

    • An unsynced tablet can cause labels to print without the Aruco codes, resulting in recognition failures.
    • If you are unsure how to sync your third-party system contact your operations team. 

Step 3

Eliminate Posing Conflicts and Verify Accurate Aruco Code

Ensure No Poses Are Associated with the Item:  Log into Manager Mode  Scan UPC of the ArUco labeled item, or search for the item using the Items page.   Verify there are no poses of that item  Attempt to delete poses If poses are older than 24 hours please reach out to [e-mail] Poses linked to Aruco labeled items can confuse recognition. Check Creator for Aruco Label Details: Confirm that the Dotcode Label in Creator matches the one on the packaging.  To generate an Aruco code, visit: Aruco Generator.

 

✋🏽 For any additional questions, please contact our support team at [e-mail]