Audience:
Technical Teams, Developers, Account Managers, Database Administrators, and Product Teams.
Description of Issue:
When running a 3rd party SDK application that integrates to Aloha POS, Aloha will respond with errors when the POS configuration or environment in the physical store's database does not support the COM call that the SDK application requests.
Solution:
Interpret error codes in this chart and make necessary configuration changes to resolve the POS errors.
~The errors don’t always make literal sense, but they give great hints in trouble-shooting a problem to the trained eye. If any changes are required to be made to your production environment to reverse a POS error, we always recommend that you contact your POS Support Team to prevent changes making a negative impact on your environment.~
**This refers only to error codes that fit the syntax “0xC0068nnn”.
**Errors that begin with 800, as opposed to C00, should be researched as Windows errors via some commonly used and reputable search engine.**
Reference: "Exception from HRESULT: 0xC0068nnn".
Find "xnnn" or "xnn" in the table below. For your convenience, some are linked to an article to assist with understanding the most common errors.
nnn |
Error |
Error |
0x02 |
Someone already logged in |
ErrCOM_SomeoneAlreadyLoggedIn |
0x05 |
Invalid Magcard |
ErrCOM_InvalidMagCard |
0x06 |
Employee logged in on other terminal |
ErrCOM_EmpLoggedOnOtherTerm |
0x08 |
Already clocked in |
ErrCOM_EmpAlreadyClockedIn |
0x09 |
Too many shifts today |
ErrCOM_EmpToManyShiftsToday |
0x0B |
Unknown employee clock in error |
ErrCOM_UnknownEmpClockInError |
0x0C |
Not clocked in |
ErrCOM_EmpNotClockedIn |
0x0D |
Need to checkout first |
ErrCOM_EmpNeedToCheckoutFirst |
0x0E |
Unknown employee clock out error |
ErrCOM_UnknownEmpClockOutError |
0x0F |
No checkout |
ErrCOM_NoCheckout |
0x12 |
Invalid table |
ErrCOM_InvalidTable |
0x13 |
Open checks on table |
ErrCOM_OpenChecksOnTable |
0x14 |
Table is closed |
ErrCOM_TableIsClosed |
0x15 |
Only one check per table allowed |
ErrCOM_OnlyOneCheckPerTableAllowed |
0x16 |
Invalid check |
ErrCOM_InvalidCheck |
0x17 |
Check has unordered items |
ErrCOM_CheckHasUnorderedItems |
0x18 |
Check not fully tendered |
ErrCOM_CheckNotFullyTendered |
0x19 |
Invalid payment |
ErrCOM_InvalidPayment |
0x1A |
No local printer |
ErrCOM_NoLocalPrinter |
0x1C |
Check is closed |
ErrCOM_CheckIsClosed |
0x1D |
Check is empty |
ErrCOM_CheckIsEmpty |
0x1F |
Employee drawer not on local terminal |
ErrCOM_EmpDrawerNotLocal |
0x22 |
No entry |
ErrCOM_NoEntry |
0x23 |
Invalid order mode |
ErrCOM_InvalidOrderMode |
0x24 |
Invalid void reason |
ErrCOM_InvalidVoidReason |
0x25 |
Invalid entry |
ErrCOM_InvalidEntry |
0x27 |
Invalid ModCode |
ErrCOM_InvalidModCode |
0x2A |
Item is not an open item |
ErrCOM_ItemIsNOTOpenItem |
0x2C |
Employee drawer balance not confirmed |
ErrCOM_EmpDrawerNotConfirmed |
0x2D |
Jobcode cannot close checks |
ErrCOM_JobcodeCannotCloseChecks |
0x2E |
Bad payment track info |
ErrCOM_BadCCTrackInfo |
0x30 |
Illegal declared cash amount |
ErrCOM_IllegalDeclaredCashAmount |
0x31 |
Table not found |
ErrCOM_TableNotFound |
0x33 |
No local cashier |
ErrCOM_NoLocalCashier |
0x34 |
Employee cannot tender cash |
ErrCOM_EmpCannotTenderCash |
0x36 |
Check has pending payments |
ErrCOM_CheckHasPendingPayments |
0x37 |
Check is full |
ErrCOM_CheckIsFull |
0x38 |
Could not print Back Office gift certificate |
ErrCOM_CouldNotPrintBackOfficeGiftCertificate |
0x39 |
Too many checks on table |
ErrCOM_ToManyChecksOnTable |
0x3A |
Entry already selected |
ErrCOM_EntryAlreadySelected |
0x3B |
Invalid special message |
ErrCOM_InvalidSpecialMessage |
0x3C |
Invalid menu |
ErrCOM_InvalidMenu |
0x3D |
No pivot seating |
ErrCOM_NoPivotSeating |
0x3E |
Too many seats |
ErrCOM_TooManySeats |
0x3F |
** UNUSED ** |
** UNUSED ** |
0x40 |
Not supported in Quick Service |
ErrCOM_NotSupportedInQuickService |
0x41 |
Not supported in Table Service |
ErrCOM_NotSupportedInTableService |
0x42 |
Cannot adjust finalized gift card payment |
ErrCOM_CannotAdjustFinalizedGiftCard |
0x43 |
Finalizing gift card payment, must wait to close check |
ErrCOM_FinalizingGiftCard |
0x44 |
Check is from previous shift |
ErrCOM_CheckIsFromPreviousShift |
0x45 |
Employee is checked out |
ErrCOM_EmployeeIsCheckedOut |
0x46 |
Invalid exception modifier group |
ErrCOM_InvalidExceptionModifierGroup |
0x47 |
Item not in exception modifier group |
ErrCOM_NotInExceptionModifierGroup |
0x49 |
No entries moved |
ErrCOM_NoEntriesMoved |
0x4A |
Invalid CompType |
ErrCOM_InvalidCompType |
0x4C |
Invalid Comp |
ErrCOM_InvalidComp |
0x4F |
FOHCOM Server Exception |
ErrCOM_FOHCOM_ServerException |
0x50 |
The check has payments whose signature has not been verified |
ErrCOM_CheckHasPaymentsPending |
0x51 |
Invalid/unexpected parameters are passed in |
ErrCOM_InvalidParameter |
0x52 |
Invalid eFrequency Request or Currently Disabled by eFrequency or eFrequency is disabled or not initialized |
ErrCOM_eFrequency_InvalidRequest |
0x53 |
Invalid eFrequency Card Number |
ErrCOM_eFrequency_InvalidCardNumber |
0x54 |
Invalid prefix of eFrequency Card Number |
ErrCOM_eFrequency_InvalidPrefix |
0x55 |
Manager is required to Override |
ErrCOM_eFrequency_RequireManagerOverride |
0x56 |
Uncertain Error |
ErrCOM_eFrequency_UnknownError |
0x57 |
Manager is not clocked in |
ErrCOM_ManagerNotClockedIn |
0x58 |
The provided break type is not valid |
ErrCOM_IllegalBreakTypeForShift |
0x59 |
The combo of break type and paid is not valid |
ErrCOM_IllegalComboOfBreakAndPaidForShift |
0x5A |
The employee cannot go on break with open tables |
ErrCOM_EmployeeCannotBreakWithOpenTables |
0x5B |
The employee is currently on a break |
ErrCOM_EmployeeOnBreak |
0x5C |
The specified breay type is not valid for this employee |
ErrCOM_InvalidBreakTypeForEmployee |
0x5D |
The employee is not currently on a break |
ErrCOM_EmployeeIsNotOnABreak |
0x5E |
The employee cannot end their break since the enforced break times have not been met |
ErrCOM_EnforcedBreakTimesNotMet |
0x5F |
The supplied passwords is invalid since it contains non-numeric chars |
ErrCOM_PasswordHasNonNumericChars |
0x60 |
The system is not currently setup to use passwords |
ErrCOM_SystemNotSetupToUsePasswords |
|
||
0x61 |
The supplied password is less than the minimum length |
ErrCOM_PasswordIsLessThanMinLength |
0x62 |
The supplied password is greater than the maximum length |
ErrCOM_PasswordIsGreaterThanMaxLength |
0x63 |
The provided emp is magcard only |
ErrCOM_EmpIsMagcardOnly |
0x64 |
A manager must authorize the clockout of this employee |
ErrCOM_ManagerMustClockout |
0x65 |
The supplied magcard is already in use |
ErrCOM_MagcardAlreadyInUse |
0x66 |
The provided employee does not have the rights to clear passwords |
ErrCOM_NoClearPasswordRights |
0x69 |
The employee is currently clocked in |
ErrCOM_EmpCurrentlyClockedIn |
0x6A |
The employee cannot delete their clockout since they do not have a shift |
ErrCOM_EmpCannotDeleteClockoutEmpHasNoShift |
0x6C |
The employee cannot work another shift |
ErrCOM_EmpCannotWorkAnotherShift |
0x6D |
The employee cannot clock out yet |
ErrCOM_EmpCannotClockOutYet |
0x6E |
Cannot find a drawer for the employee |
ErrCOM_CannotFindDrawerForEmployee |
0x6F |
The drawer for this employee is currently assigned to another employee |
ErrCOM_DrawerCurrentlyAssignedToAnotherEmployee |
0x70 |
A password was provided for an employee whose password was previously cleared |
ErrCOM_EmpsPasswordWasClearedButPasswordProvided |
0x71 |
The employee is currently checked out |
ErrCOM_EmployeeIsCheckedIn |
0x72 |
The employee needs a manager to allow them to checkout |
ErrCOM_NeedManagerToCheckoutEmp |
0x73 |
The employee does not have the rights to delete clockouts |
ErrCOM_NoDeleteClockoutRights |
0x74 |
The employee does not have the rights to delete checkouts |
ErrCOM_NoDeleteCheckoutRights |
0x75 |
The employee password is not in a resettable state. |
ErrCOM_InvalidResetPasswordState |
0x76 |
This employee's password has expired. Call SetExpiredPassword. |
ErrCOM_SetExpiredPasswordRequired |
This employee's password has been cleared. Call SetExpiredPassword |
||
0x78 |
This employee's password has not been set up. Call SetExpiredPassword |
ErrCOM_SetUninitPasswordRequired |
0x79 |
|
|
0x80 |
Manager or Employee does not have sufficient access rights to perform the action. |
ErrCOM_InsufficientAccessLevel |
0x81 |
Either the system is not configured right or current system status does not allow it |
ErrCOM_InvalidRequest |
0x82 |
Unable to reopen check to specified employee. |
ErrCOM_UnableToReopenCheckToEmployee |
0x83 |
ErrCOM_CheckHasAnOverPayment |
ErrCOM_CheckHasAnOverPayment |
0x84 |
ErrCOM_InvalidGetCheckContex |
ErrCOM_InvalidGetCheckContex |
0x85 |
ErrCOM_OperationFailed |
ErrCOM_OperationFailed |
There was no order number assigned by master – This is QS only |
||
0x087 |
Driver Mileage must be set |
ErrCOM_DriverMileageRequired |
0x088 |
Terminal not found from ID |
ErrCOM_TerminalNotFound |
0x089 |
Specified Terminal is not a Radiant Interface Terminal |
ErrCOM_TerminalNotAnRIT |
0x090 |
Attempting to initialize RIT on the wrong host |
ErrCOM_InvalidRITHost |
0x091 |
Maximum number of allowed virtual terminals has been reached |
ErrCOM_MaxNumberOfVirtualTerminals |
0x092 |
Maximum number of allowed virtual terminals has been reached |
ErrCOM_DefaultQueueNotDefined |
0x093 |
Source or Target seat is not available |
ErrCOM_SourceOrTargetSeatNotAvailable |
0x094 |
At least one split seat required to move items |
ErrCOM_SplitSeatAtleastOneSeatRequired |
0x095 |
Inactive House Account |
ErrCOM_InactiveHouseAccount |
0x096 |
House Account Not Found |
ErrCOM_HouseAccountNotFound |
0x097 |
Membership LiquorPool Exception |
ErrCOM_MembershipLiquorPoolException |
0x098 |
No Membership Charge Privileges |
ErrCOM_NoMembershipChargePrivileges |
0x099 |
Membership Account Expired |
ErrCOM_MembershipAccountExpired |
0x100 |
Member not found |
ErrCOM_MemberNotFound |
0x101 |
Configuration Error |
ErrCOM_ConfigurationErro |
0x102 |
Invalid GiftCard |
ErrCOM_InvalidGiftCard |
0x103 |
PMS Inactive |
ErrCOM_PMSInactive |
0x104 |
Not a PMS Payment |
ErrCOM_NotAPMSPayment |
0x105 |
PMS Payment Id required for delete and adjust |
ErrCOM_PMSPaymentIdRequired |
0x106 |
Employee can not delete payments |
ErrCOM_EmpCannotDeletePayment |
0x107 |
EDC is inactive |
ErrCOM_EDCInactive |
0x108 |
Drawer Id was not found |
ErrCOM_DrawerNotFound |
0x109 |
No tender defined for the ident |
ErrCOM_IllegalIdent |
0x10A |
Max level depth of modifiers reached. (Currently set to 8) |
ErrCOM_ModLevelMaxReached |
0x10B |
Screenflow is violated for FOH display |
ErrCOM_InvalidScreenHandle |
0x10C |
Invalid Button Func for FOH screen switching (QS only) |
ErrCOM_InvalidButtonFunc |
0x110 |
Recall order not allowed since the table is not on delivery queue and the employee is not a delivery employee |
ErrCOM_RecallOrderNotAllowed |
0x111 |
Violates either giftcard cannot be redeemed the same day it activates or redeemed more then once a day |
ErrCOM_GiftCardRestrictionViolation |
0x112 |
Tender ID sent to ApplyPayment is not a match for the track info sent |
ErrCOM_TenderIDAndCardNumberDontMatch |
0x113 |
No payment allowed at non tendering terminal |
ErrCOM_NoPaymentAtNonTenderingTerminal |
0x114 |
No close check allowed at non tendering terminal |
ErrCOM_NoCloseCheckAtNonTenderingTerminal |
0x115 |
Static employee clock in other terminal already |
ErrCOM_StaticEmployeeClockInOtherTerminal |
0x116 |
No static employee clock out allowed at non tendering terminal |
ErrCOM_NoStaticEmployeeClockOut |
0x117 |
The last employee with a drawer cannot check out if there are open checks |
ErrCOM_EmpHasOpenCheck |
0x118 |
The table has no saved card info |
ErrCOM_NoSavedCardInfo |
0x119 |
ErrCOM_GiftCardRedeemptionViolation |
Cannot Purchase or activate a giftcard with a giftcard |
0x11A |
ErrCOM_OfflineGiftCardViolation |
Cannot void a offline giftcard activation/add value |
0x11B |
ErrCOM_TerminalIntristic |
Cannot change a different iber screen, terminal is processing another UI operation. |
0x11C |
ErrCOM_TableTransferDisabled |
Table transfer is disabled |
0x11D |
ErrCOM_EmpIsThumbScannerOnly |
The supplied employee must login with a thumb scanner |
0x11E |
ErrCOM_OrderModeIsLocked |
The order mode can’t be changed because it is locked |
0x11F |
ErrCOM_CompRequirementsNotMet |
COMPS requirements have not been met |
0x120 |
ErrCOM_InternalError |
Internal Error: input is fine but something unexpected happened |
0x121 |
ErrCOM_SecurePinPadError |
Input is fine but terminal is not using secure pinpad |
0x122 |
ErrCOM_SecurePinPadError2 |
Input is fine but txn key does not match pinpad’s current key |
0x123 |
ErrCOM_SecurePinPadError3 |
Input is fine but terminal is not a POS terminal |
0x124 |
ErrCOM_TableForcedLocked |
Table is forced locked and must be explicitly unlocked |
0x125 |
ErrCOM_EmpIsDallasKeyOnly |
The supplied employee must login with a Dallas key |
0x126 |
ErrCOM_DialogPending |
Unable to return result of dialog because the dialog has not been closed yet |
0x127 |
ErrCOM_DialogCanceled |
Dialog was closed without retrieving needed data from user |
0x128 |
ErrCOM_DialogClosedOnForceLogout |
Dialog was closed because force logout occurred |
0x130 |
ErrCOM_CannotAcceptTableToSelf |
Cannot accept table to self |
0x131 |
ErrCOM_OperationRejectedByInterceptor |
Blocking Interceptor rejected operation |
0x132 |
ErrCOM_PendingInterceptedOperation |
Blocking interceptor operation pending, try again |
0x133 |
ErrCOM_InvalidEFreqCompType |
Invalid EFreq Comp Type specified |
0x134 |
ErrCOM_InvalidEFreqPromotion |
Invalid EFreq Promotion specified |
0x135 |
ErrCOM_InvalidArgument |
argument out of domain range |
0x136 |
ErrCOM_InvalidItemGroupList |
invalid item group list |
0x137 |
ErrCOM_NoLoyaltyCard |
No loyalty card passed in |
0x138 |
ErrCOM_LoyaltyRemoveDiscountFailed |
Failed to remove Loyalty Discount |
0x139 |
ErrCOM_FunctionRetired |
Function is no longer supported |
0x14A |
ErrCOM_CombineTablesNotAllowed |
cannot combine if two tables have same tabledef |
0x14B |
ErrCOM_TableProcessingGiftCard |
cannot combine if currently processing giftcard payment |
0x14C |
ErrCOM_CombineTablesFailed |
unknown failure in combinetables |
0x14D |
ErrCOM_DetachTablesFailed |
unknown failure in detachtables |
0x14E |
ErrCOM_GetCombinedTablesFailed |
unknown failure in GetCombineTablesGroups |
0x14F |
ErrCOM_FailedToInitializeSafeArray |
SafeArray failure |
0x150 |
ErrCOM_FailedSafeArrayCopy |
SafeArray copy failure |
0x151 |
ErrCOM_FailedGetRecordInfoFromGuids |
GetRecordInfoFrom Guid failure - usual COM registration issue |
0x152 |
ErrCOM_FailedSafeArrayPutElement |
SafeArray PutElement failure |
0x153 | FailedSafeArrayAccessData | SafeArray Access/unaccess data failure |
0x154 | ErrCOM_InvalidPackagePromo | |
0x155 | ErrCOM_PackagePromoNotAuthorized | |
0x156 | ErrCOM_PackagePromoAlreadyOnCheck | |
0x157 | ErrCOM_PackagePromoCannotBeAppliedDueToPricing | |
0x158 | ErrCOM_PackagePromoInvalidGuestCount | |
0x159 | ErrCOM_PackagePromoEntryNotOnCheck | |
0x15A | ErrCOM_PackagePromoNotOnCheck | |
0x15B | ErrCOM_PackagePromoEntryListEmpty | |
0x15C | ErrCOM_PackagePromoEntriesOnCheckNotEligible | |
0x15D | ErrCOM_InvalidDeviceLogin | |
0x15E | ErrCOM_NotAPhyscalTerminal | |
0x15F | ErrCOM_SerializationEntityNotAccessibleDirectly | |
0x160 | ErrCOM_SerializationEntityTreeAsListMalformed | |
0x161 | ErrCOM_SerializationValueNotInitialized | |
0x162 | ErrCOM_EmployeeCannotUseTender | |
0x163 | ErrCOM_AcceptingEmployeeInsufficientRights | |
0x164 | ErrCOM_RepeatRefillItemException | |
0x165 | ErrCOM_RepeatWeighedQCItemException | |
0x166 | ErrCOM_RepeatRequiresManagerRightsException | |
0x167 | ErrCOM_Loyalty_MultimemberNotAllowed | |
0x168 | ErrCOM_TableNameNotProvided | |
0x169 | ErrCOM_InvalidJsonSchema | |
0x16A | ErrCOM_InvalidJsonData | |
0x16B | ErrCOM_OrderEntryException | |
0x16C | ErrCOM_UnknownJsonSchema |