Aloha POS: Error Code Responses from Aloha to SDK's via COM

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.

Audience:

Technical Teams, Developers, Account Managers, Database Administrators, and Product Teams.

Solution:

Interpret error codes in this chart and make configuration changes to resolve the POS errors.

The table is only valid for error codes on the form “0xC0068nnn”. In cases where it starts with 800, not C0068, so it’s not the 6B one.

You can read these using the following format (this is how they come back in the error messages from Aloha). These errors don’t always make literal sense, but they give great hints in trouble-shooting a problem.

Syntax for reference: "Exception from HRESULT: 0xC0068nnn".

Find "nnn" in the table below.

nnn	Error	Error
0x01	Unauthorized terminal	ErrCOM_UnauthorizedCOMTerm
0x02	Someone already logged in	ErrCOM_SomeoneAlreadyLoggedIn
0x03	Could not find employee	ErrCOM_CouldNotFindEmployeeFromId
0x04	Invalid employee password	ErrCOM_InvalidEmpPassword
0x05	Invalid Magcard	ErrCOM_InvalidMagCard
0x06	Employee logged in on other terminal	ErrCOM_EmpLoggedOnOtherTerm
0x07	No one logged in	ErrCOM_NoOneLoggedIn
0x08	Already clocked in	ErrCOM_EmpAlreadyClockedIn
0x09	Too many shifts today	ErrCOM_EmpToManyShiftsToday
0x0A	Invalid jobcode for employee	ErrCOM_EmpInvalidJobcode
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
0x10	Already checked out	ErrCOM_EmpAlreadyCheckedout
0x11	Invalid queue	ErrCOM_InvalidQueue
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
0x1B	Invalid tender	ErrCOM_InvalidTender
0x1C	Check is closed	ErrCOM_CheckIsClosed
0x1D	Check is empty	ErrCOM_CheckIsEmpty
0x1E	Employee not assigned to drawer	ErrCOM_EmpNotAssignedToDrawer
0x1F	Employee drawer not on local terminal	ErrCOM_EmpDrawerNotLocal
0x20	Table in use on other terminal	ErrCOM_TableActiveOnOtherTerm
0x21	Invalid item	ErrCOM_InvalidItem
0x22	No entry	ErrCOM_NoEntry
0x23	Invalid order mode	ErrCOM_InvalidOrderMode
0x24	Invalid void reason	ErrCOM_InvalidVoidReason
0x25	Invalid entry	ErrCOM_InvalidEntry
0x26	Unavailable item	ErrCOM_UnavailableItem
0x27	Invalid ModCode	ErrCOM_InvalidModCode
0x28	Modifier not allowed for parent item	ErrCOM_ModNotAuthForParentItem
0x29	Modifier requirements not met	ErrCOM_ModReqsNotMet
0x2A	Item is not an open item	ErrCOM_ItemIsNOTOpenItem
0x2B	Need more payment info	ErrCOM_NeedMoreCCInfo
0x2C	Employee drawer balance not confirmed	ErrCOM_EmpDrawerNotConfirmed
0x2D	Jobcode cannot close checks	ErrCOM_JobcodeCannotCloseChecks
0x2E	Bad payment track info	ErrCOM_BadCCTrackInfo
0x2F	Illegal declared tips amount	ErrCOM_IllegalDeclaredTipsAmount
0x30	Illegal declared cash amount	ErrCOM_IllegalDeclaredCashAmount
0x31	Table not found	ErrCOM_TableNotFound
0x32	Table in use	ErrCOM_TableInUse
0x33	No local cashier	ErrCOM_NoLocalCashier
0x34	Employee cannot tender cash	ErrCOM_EmpCannotTenderCash
0x35	Check is missing items from required category	ErrCOM_CheckIsMissingItemsFromReqdCat
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
0x48	No entries selected	ErrCOM_NoEntriesSelected
0x49	No entries moved	ErrCOM_NoEntriesMoved
0x4A	Invalid CompType	ErrCOM_InvalidCompType
0x4B	Invalid Promotion	ErrCOM_InvalidPromotion
0x4C	Invalid Comp	ErrCOM_InvalidComp
0x4D	Invalid Promo	ErrCOM_InvalidPromo
0x4E	FOHCOM Currently Busy	ErrCOM_FOHCOM_CurrentlyBusy
0x4F	FOHCOM Server Exception	ErrCOM_FOHCOM_ServerException
0x50	The check has payments whose signature has not been verified	ErrCOM_CheckHasPaymentsPending
SignatureVerification	SignatureVerification	SignatureVerification
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 break 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 password is invalid since it contains non-numeric chars	ErrCOM_PasswordHasNonNumericChars
0x60	The system is not currently setup to use passwords	ErrCOM_SystemNotSetupToUsePasswords
Break	BreakPoint	BreakPoint
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
0x67	The employee is terminated	ErrCOM_EmployeeIsTerminated
0x68	The employee is currently locked on another terminal	ErrCOM_EmployeeIsLockedOnAnotherTerminal
0x69	The employee is currently clocked in	ErrCOM_EmpCurrentlyClockedIn
0x6A	The employee can delete their clockout since they do not have a shift	ErrCOM_EmpCannotDeleteClockoutEmpHasNoShift
0x6B	The employee is not scheduled to work	ErrCOM_EmpNotScheduledToWork
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
0x77	This employee's password has been cleared. Call SetExpiredPassword	ErrCOM_SetClearedPasswordRequired
0x78	This employee's password has not been set up. Call SetExpiredPassword	ErrCOM_SetUninitPasswordRequired
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 systsm 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
0x86	There was no order number assigned by master – This is QS only	ErrCOM_InvalidOrderNumber
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 cannot 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