Forgot Password?

Enter your email to get a password reset link

Remember your password? Login

Operating Handbook, Shortcuts & MoR Error Doctor
F1 Ctrl+K MoR Directive 1142 Compliant
Zero-mouse cashier workflows, regulatory tax essentials, and 68 official MoR error remediation procedures.
Zero-Mouse High-Speed Operation (የፈጣን ሽያጭ አሠራር)
Serve customers in under 3 seconds using hotkeys (F1–F10, Ctrl+K) without touching the mouse.
Scan Item → Press F2 → Enter
Fast Checkout & Tender (የክፍያ አቋራጮች)
Daily Checkout
F2
Quick Cash Pay & Instant Print
Auto-tenders exact cash & prints receipt in <300ms
Fastest
F9
Multi-Tender & Split Payment
Split payment across Cash, Card, Telebirr, and Bank Wire
Split Pay
Enter
Finalize / Print / Confirm Modal
Submits transaction, confirms dialogs, or sends to INSA seal
Primary
Space
Next Customer (Clear & Reset Cart)
Dismisses completed receipt & readies cart for next buyer
Workflow
MoR Compliance & Modes (የገቢዎች ህግጋት)
Directive 1142
F4
Transaction Mode & Buyer Profile
Switch between B2C, B2B (10-Digit TIN), B2G, and EXP
B2B / B2G
F3
Reprint Last Fiscal Receipt
Prints verified duplicate copy marked with DUPLICATE stamp
Reprint
F8
Fiscal Return & Credit Note (FL-01)
Issues customer credit note & restocks items with parent IRN
Credit Note
F7
Transaction History & In-Flight Void
Inspect recent transactions or cancel under Rule 7002 limits
Ledger
Cart Management & Line Edits
Navigation
/ or F11
Focus Product Search Bar
Instantly types barcode, item SKU, or product title
Search
+ / -
Increment / Decrement Quantity
Adjusts quantity of the currently focused line item
Qty
Del
Remove Line Item from Cart
Deletes active row with quick 5-second undo snackbar
Remove
Esc
Close Open Modal / Dialog
Safely exits current dialog without saving uncommitted edits
Dismiss
Shift Closeout & Offline Queue
Shift Operations
F10
Offline Queue Sync Manager
Inspects buffered offline invoices and triggers 1-click batch upload
72h SLA
Ctrl+Z
Mandatory Daily Z-Report (FL-02)
Closes fiscal day, locks tax accumulator, and prints official seal
EOD
Ctrl+X
Mid-Day X-Report / Shift Audit
Prints subtotal summary without resetting daily counters
Audit
Ctrl+K
Universal Handbook & Error Doctor
Opens this guide modal from anywhere in the application
Help
Z-Report (FL-02) vs X-Report
Directive Art 26

Daily Z-Report: Legal fiscal day closeout required once every 24 hours. Resets daily counters and synchronizes cumulative turnover to MoR cloud.

X-Report: Mid-shift reading used during cashier handovers. Does not reset tax memory counters or close the shift.

Credit Note (CRE) Chaining
Rule 7021 & 7028

Under MoR Rule 7021, an adjustment document (Credit Note / Debit Note) cannot be issued independently. It strictly requires a valid, registered 64-hexadecimal parent IRN.

Use the 1-click recent invoice chips in the Sales/POS adjustment interface to link the original bill in under 1 second.

B2C Retail TIN Prohibition
Rule 7008 / Test IRC-P01

MoR Directive 1142 strictly dictates that B2C walk-in retail bills must NOT contain a Buyer TIN (Gateway returns 406 Error 7008). If a business client requests their TIN on the invoice, the transaction must be switched to B2B Mode (F4).

72-Hour Offline SLA Buffer
Directive Art 23(4)

In case of internet failure, transactions are securely signed offline and queued in local WORM storage (<50ms). Cashiers may continue trading, but all queued invoices must be synced to MoR within 72 hours.

POS Transaction Status Code Directory (የሰነድ ሁኔታ መለያዎች)
Status Legend
A Active / Final
Certified with live MoR seal
O Offline Queued
Saved locally; sync in <72h
C Cancelled / Void
Legally voided with MoR
S Synchronized
Uploaded & certified after offline
Official 68-Code MoR Regulatory Error Doctor (የገቢዎች የስህተት መፍቻ)
Directive 1142, Proclamation 979 & MoR EIMS Specification §7 (docs/invoice/erros.md)
68 Official Rules
Code 4001
Missing Required Authentication Values
የሚያስፈልጉ የማረጋገጫ እሴቶች ጠፍተዋል
HTTP 400
Cause: One or more required authentication fields (clientid, clientsecret, apikey, tin) are missing.
አንድ ወይም ከዚያ በላይ የሚያስፈልጉ የማረጋገጫ መስኮች ጠፍተዋል።
Remediation Workflow:
Ensure all four credentials (client_id, client_secret, api_key, tin) are configured in config/eims.php or .env.
Code 4110
Invalid Authentication Credentials
ልክ ያልሆነ የማረጋገጫ ምስክርነቶች
HTTP 401
Cause: The provided authentication credentials are invalid or have been revoked.
የቀረቡት የማረጋገጫ ምስክርነቶች ልክ ያልሆኑ ናቸው ወይም ተሰርዘዋል።
Remediation Workflow:
Regenerate credentials from the MoR Taxpayer Portal and update config/eims.php.
Code 1028
Required Property Not Found
የሚያስፈልገው ባህሪ አልተገኘም
HTTP 400
Cause: A required property in the JSON payload is missing per MoR Draft-07 schema.
በJSON ክፍያ ውስጥ የሚያስፈልገው ባህሪ ጠፍቷል።
Remediation Workflow:
Check the instanceLocation and property fields in the error response to identify the missing field.
Code 4400
User Not Found During Authentication
በማረጋገጫ ወቅት ተጠቃሚው አልተገኘም
HTTP 401
Cause: The provided username or client ID is not registered in the MoR authentication directory.
የቀረበው የተጠቃሚ ስም ወይም የደንበኛ መለያ በገቢዎች ሚኒስቴር ማረጋገጫ ማውጫ ውስጥ አልተገኘም።
Remediation Workflow:
Verify credentials in config/eims.php. If the issue persists, raise a support ticket with MoR.
Code 4401
Group Not Found During Authentication
በማረጋገጫ ወቅት ምድብ አልተገኘም
HTTP 401
Cause: Taxpayer user group not recognized during MoR authentication.
የግብር ከፋይ የተጠቃሚ ቡድን በማረጋገጫ ወቅት አልታወቀም።
Remediation Workflow:
Raise support ticket with MoR for user group provisioning.
Code 4402
General Authentication Attribute Not Found
አጠቃላይ የማረጋገጫ መረጃ አልተገኘም
HTTP 401
Cause: Required authentication token attributes were missing from the MoR auth service.
አስፈላጊ የማረጋገጫ ባህሪያት ከገቢዎች ማረጋገጫ አገልግሎት አልተገኙም።
Remediation Workflow:
Raise support ticket with MoR to verify account attributes.
Code 4403
API Key Attribute Not Found During Authentication
የኤፒአይ ቁልፍ (API Key) አልተገኘም
HTTP 401
Cause: API key attribute is missing from the authentication request.
የኤፒአይ ቁልፍ መረጃ በማረጋገጫ ጥያቄው ውስጥ አልተካተተም።
Remediation Workflow:
Use correct credentials and try again. Verify EIMS_CLIENT_ID and EIMS_CLIENT_SECRET in .env.
Code 4404
TIN Attribute Not Found During Authentication
የግብር ከፋይ መለያ ቁጥር (TIN) አልተገኘም
HTTP 401
Cause: TIN attribute was missing from the authentication token payload.
የግብር ከፋይ መለያ ቁጥር (TIN) በማረጋገጫው ውስጥ አልተገኘም።
Remediation Workflow:
Verify EIMS_TIN in .env matches the provisioned taxpayer TIN.
Code 4405
Encryption Key Attribute Not Found
የምስጠራ ቁልፍ መረጃ አልተገኘም
HTTP 401
Cause: Encryption key attribute missing during authentication handshake.
በማረጋገጫ ወቅት የምስጠራ ቁልፍ መረጃ አልተገኘም።
Remediation Workflow:
Clear token cache and re-authenticate to obtain fresh session keys.
Code 4406
Authentication Endpoint Unreachable
የማረጋገጫ መስመር ሊገናኝ አልቻለም
HTTP 401
Cause: MoR IAM Authentication endpoint is unreachable or timing out.
የገቢዎች ሚኒስቴር ማረጋገጫ ሰርቨር ምላሽ አልሰጠም ወይም ግንኙነቱ ተቋርጧል።
Remediation Workflow:
Please raise ticket with MoR to investigate the issue. Also check internet connectivity.
Code 4407
Error Response From Authentication Endpoint
ከማረጋገጫ ሰርቨር የስህተት ምላሽ ደርሷል
HTTP 401
Cause: MoR auth service responded with an internal authentication error.
የገቢዎች ማረጋገጫ ሰርቨር የውስጥ ስህተት መልሷል።
Remediation Workflow:
Verify credentials and raise support ticket with MoR if persistent.
Code 4408
Invalid API Key Used During Login
ልክ ያልሆነ የኤፒአይ ቁልፍ (API Key)
HTTP 401
Cause: Provided client secret or API key is invalid or unauthorized.
የቀረበው የኤፒአይ ቁልፍ ወይም ሚስጥራዊ ቁጥር ልክ ያልሆነ ነው።
Remediation Workflow:
Use the exact client credentials provisioned in the MoR Sandbox/Production portal.
Code 4409
Invalid TIN Used During Login
ልክ ያልሆነ የግብር ከፋይ መለያ ቁጥር (TIN)
HTTP 401
Cause: Provided Taxpayer TIN is not recognized or not associated with this client ID.
የቀረበው TIN በገቢዎች ሚኒስቴር እውቅና የሌለው ወይም ከደንበኛ መለያው ጋር የማይዛመድ ነው።
Remediation Workflow:
Confirm seller TIN in settings matches the taxpayer registration certificate.
Code 4410
Invalid Password Used During Login
ልክ ያልሆነ የይለፍ ቃል
HTTP 401
Cause: Authentication credentials password verification failed.
የቀረበው የማረጋገጫ የይለፍ ቃል አልተቀበለም።
Remediation Workflow:
Verify client credentials and update .env configuration.
Code 4411
Refresh Token Endpoint Unreachable
የቶከን ማደሻ መስመር ሊገናኝ አልቻለም
HTTP 401
Cause: MoR Token Refresh service is temporarily unavailable.
የገቢዎች ሚኒስቴር የቶከን ማደሻ አገልግሎት ለጊዜው አልተገኘም።
Remediation Workflow:
Please raise support ticket with MoR. Re-authenticate with primary credentials to obtain fresh token.
Code 4412
Error Response From Refresh Token Endpoint
ከቶከን ማደሻ ሰርቨር የስህተት ምላሽ ደርሷል
HTTP 401
Cause: Refresh token was rejected or expired.
የቀረበው የቶከን ማደሻ ጊዜው ያለፈበት ወይም ውድቅ የተደረገ ነው።
Remediation Workflow:
Clear token cache and request a new access token.
Code 4501
Authentication Entry Point Failure
የማረጋገጫ መግቢያ ስህተት
HTTP 401
Cause: Fatal error occurred at MoR authentication security gateway.
በገቢዎች የደህንነት መግቢያ በር ላይ ስህተት ተከስቷል።
Remediation Workflow:
Raise support ticket with MoR technical team.
Code 4502
Access Denied Error Occurred
የመዳረሻ ፈቃድ ተከልክሏል
HTTP 401
Cause: The authenticated account does not have permission for invoice submission.
ይህ መለያ ደረሰኝ ለመመዝገብ የሚያስችል ፈቃድ የለውም።
Remediation Workflow:
Re-authenticate. Verify the system number and TIN permissions on MoR portal.
Code 4503
General Token Issue Occurred
አጠቃላይ የቶከን ስህተት
HTTP 401
Cause: Bearer token is malformed, expired, or rejected.
የቀረበው ቶከን ልክ ያልሆነ ወይም ጊዜው ያለፈበት ነው።
Remediation Workflow:
Clear token cache and perform fresh login.
Code 4601
Payload Encryption Issue
የምስጠራ ሂደት ስህተት
HTTP 400
Cause: Failed to encrypt payload using MoR session key.
በገቢዎች ሚስጥራዊ ቁልፍ መረጃን የማመስጠር ሂደት አልተሳካም።
Remediation Workflow:
Re-authenticate and obtain fresh encryption key.
Code 4602
Payload Decryption Issue
የምስጠራ መፍታት ስህተት
HTTP 400
Cause: Failed to decrypt payload or response.
የተመሰጠረውን መረጃ የመፍታት ሂደት አልተሳካም።
Remediation Workflow:
Re-authenticate and obtain new session encryption key.
Code 4603
TIN Extraction Issue
የTIN ማውጣት ስህተት
HTTP 400
Cause: MoR gateway could not extract TIN from request headers or signature.
የገቢዎች ሰርቨር የግብር ከፋይ ቁጥርን (TIN) ማውጣት አልቻለም።
Remediation Workflow:
Please raise support ticket with MoR. Also verify TIN header and SellerDetails.Tin are correctly populated.
Code 4604
Username Extraction Issue
የተጠቃሚ ስም ማውጣት ስህተት
HTTP 400
Cause: MoR gateway could not resolve username from request token.
የተጠቃሚ ስም መረጃን ከቶከን ማግኘት አልተቻለም።
Remediation Workflow:
Please raise support ticket with MoR. Re-authenticate with valid user credentials.
Code 4605
Session State Extraction Issue
የክፍለ-ጊዜ ሁኔታ ማውጣት ስህተት
HTTP 400
Cause: MoR gateway could not verify current session state.
የአሁኑን የስራ ክፍለ-ጊዜ ሁኔታ ማረጋገጥ አልተቻለም።
Remediation Workflow:
Please raise support ticket with MoR. Re-authenticate and re-acquire session state.
Code 4606
Unknown Encryption/Decryption Error
ያልታወቀ የምስጠራ ስህተት
HTTP 400
Cause: Internal cryptographic subsystem failure on MoR server.
በገቢዎች የምስጠራ ንዑስ ስርዓት ላይ ያልታወቀ ስህተት ተከስቷል።
Remediation Workflow:
Raise support ticket with MoR technical team.
Code 4607
Encryption Key Extraction Issue
የምስጠራ ቁልፍ ማውጣት ስህተት
HTTP 400
Cause: MoR gateway failed to extract session encryption key.
የምስጠራ ቁልፍን ከጥያቄው ማውጣት አልተቻለም።
Remediation Workflow:
Please raise support ticket with MoR. Clear token cache and re-authenticate.
Code 67001
Unknown Certificate Validation Error
ያልታወቀ የሰርተፍኬት ማረጋገጫ ስህተት
HTTP 400
Cause: The X.509 certificate failed generic PKI validation.
የዲጂታል ሰርተፍኬቱ አጠቃላይ የPKI ማረጋገጫ አልተሳካም።
Remediation Workflow:
Verify INSA-issued certificate chain validity.
Code 67002
Error Loading Trust Store
የታማኝ ሰርተፍኬቶች ማከማቻ ስህተት
HTTP 400
Cause: MoR trust store could not load root CA certificate.
የገቢዎች ሰርቨር የዋናውን ሰርተፍኬት ማከማቻ መክፈት አልቻለም።
Remediation Workflow:
Raise support ticket with MoR PKI operations.
Code 67003
Certificate Is Expired
የዲጂታል ሰርተፍኬቱ ጊዜ አልፏል
HTTP 400
Cause: The INSA PKI digital certificate validity period has expired.
የ INSA ዲጂታል ሰርተፍኬት የአገልግሎት ጊዜው አልቋል።
Remediation Workflow:
Obtain a renewed certificate from INSA and deploy to storage/app/eims/certs/.
Code 67004
Certificate Signature Is Invalid
የሰርተፍኬቱ ዲጂታል ፊርማ ልክ አይደለም
HTTP 400
Cause: The payload digital signature does not match the public key in the certificate.
የቀረበው ዲጂታል ፊርማ ከሰርተፍኬቱ ይፋዊ ቁልፍ (Public Key) ጋር አይጣጣምም።
Remediation Workflow:
Ensure the private key used for signing matches the public certificate provided.
Code 67005
OCSP Validation Service Unreachable
የOCSP ሰርተፍኬት ማረጋገጫ አገልግሎት አልተገኘም
HTTP 400
Cause: MoR could not reach INSA Online Certificate Status Protocol (OCSP) server.
የገቢዎች ሰርቨር የ INSA OCSP ሰርተፍኬት ማረጋገጫ ሰርቨርን ማግኘት አልቻለም።
Remediation Workflow:
Raise support ticket with MoR to investigate OCSP gateway connectivity.
Code 67006
OCSP URL Not Found In Certificate
የOCSP አድራሻ በሰርተፍኬቱ ውስጥ አልተገኘም
HTTP 400
Cause: The digital certificate Authority Information Access (AIA) extension is missing.
የዲጂታል ሰርተፍኬቱ የ AIA መረጃ አድራሻን አልያዘም።
Remediation Workflow:
Request an updated certificate profile from INSA PKI root.
Code 67007
Invalid OCSP Response
ልክ ያልሆነ የOCSP ምላሽ
HTTP 400
Cause: INSA OCSP revocation status response was invalid or unverifiable.
የቀረበው የሰርተፍኬት ሁኔታ ምላሽ ተቀባይነት አላገኘም።
Remediation Workflow:
Raise support ticket with MoR PKI administration.
Code 67008
Certificate Has Been Revoked
የዲጂታል ሰርተፍኬቱ ተሰርዟል (Revoked)
HTTP 400
Cause: The digital certificate has been formally revoked by INSA.
የቀረበው ዲጂታል ሰርተፍኬት በ INSA ሙሉ በሙሉ ተሰርዟል።
Remediation Workflow:
Immediately request a new PKI certificate and key pair from INSA.
Code 67009
Certificate Not In Base64 Format
ሰርተፍኬቱ በ Base64 ቅርጸት አልቀረበም
HTTP 400
Cause: Digital certificate encoding must strictly be standard Base64 RFC 4648.
የዲጂታል ሰርተፍኬቱ በ Base64 ቅርጸት መቅረብ አለበት።
Remediation Workflow:
Verify Base64 encoding without raw binary or line-breaks.
Code 67010
Public Key In Certificate Is Invalid
በሰርተፍኬቱ ውስጥ ያለው ይፋዊ ቁልፍ ልክ አይደለም
HTTP 400
Cause: The public key inside the X.509 certificate is malformed or unsupported.
በሰርተፍኬቱ ውስጥ ያለው Public Key ቅርጸቱ ልክ ያልሆነ ነው።
Remediation Workflow:
Generate a new 2048-bit RSA key pair using php artisan eims:generate-csr.
Code 67011
Certificate Chain Validation Error
የሰርተፍኬት ሰንሰለት ማረጋገጫ ስህተት
HTTP 400
Cause: Intermediate CA or Root CA certificate chain could not be verified.
የመካከለኛ ወይም የዋና ሰርተፍኬት ሰንሰለትን ማረጋገጥ አልተቻለም።
Remediation Workflow:
Provide complete PEM certificate bundle including intermediate CA.
Code 67012
Invalid Certificate Provided
ልክ ያልሆነ ሰርተፍኬት ቀርቧል
HTTP 400
Cause: The X.509 certificate syntax or structure is corrupted.
የቀረበው የዲጂታል ሰርተፍኬት መረጃ ተበላሽቷል።
Remediation Workflow:
Re-deploy the clean PEM certificate issued by INSA.
Code 67013
Certificate Signature Validation Failure
የሰርተፍኬት ፊርማ ማረጋገጫ ስህተት
HTTP 400
Cause: MoR could not cryptographically verify the signature on the invoice envelope.
የደረሰኙን ዲጂታል ፊርማ በሰርተፍኬቱ ማረጋገጥ አልተቻለም።
Remediation Workflow:
Ensure SHA-256 with RSA 2048-bit signature (SHA256withRSA) is computed on canonical JSON per MoR §5.1.6.
Code 67014
Invalid Request Object Provided
ልክ ያልሆነ የጥያቄ መረጃ ቀርቧል
HTTP 400
Cause: JSON payload violates MoR schema structure, missing mandatory fields.
የቀረበው የJSON መረጃ የገቢዎች መስፈርትን አያሟላም ወይም አስፈላጊ መረጃ ጎድሎታል።
Remediation Workflow:
Inspect schema validation error details in audit log and correct missing nodes.
Code 67015
Certificate Ownership Invalid
የሰርተፊኬቱ ባለቤትነት ማረጋገጫ አልተሳካም
HTTP 400
Cause: Ownership of the digital certificate is not valid. INSA certificate does not match enrolled taxpayer TIN.
የዲጂታል ሰርተፊኬቱ ባለቤትነት ከተመዘገበው የግብር ከፋይ መለያ ቁጥር (TIN) ጋር አይዛመድም።
Remediation Workflow:
Provide correct INSA certificate matching enrolled taxpayer TIN (Rule 67015).
Code 7001
Document Number Uniqueness Checker / Duplicate Document
የተደገመ የሰነድ መለያ ቁጥር
HTTP 406
Cause: The submitted document number or invoice counter has already been registered in the MoR central ledger.
የቀረበው የሰነድ ቁጥር ወይም የደረሰኝ ቆጣሪ ቀደም ሲል በገቢዎች ሚኒስቴር ማዕከላዊ መዝገብ ተመዝግቧል።
Remediation Workflow:
Provide a unique, monotonic document number. The system will auto-sync counter to latest.
Code 7002
Single Cancellation Limit Exceeded
የነጠላ ደረሰኝ ስረዛ ገደብ አልፏል
HTTP 406
Cause: The taxpayer has exceeded the maximum allowable cancellations for a single invoice period.
ግብር ከፋዩ ለአንድ የደረሰኝ ጊዜ የተፈቀደውን ከፍተኛ የስረዛ ገደብ አልፏል።
Remediation Workflow:
Please raise a support ticket with MoR to increase the single cancellation limit.
Code 7003
Bulk Cancellation Reason Code Invalid
ልክ ያልሆነ የጅምላ ስረዛ ምክንያት ኮድ
HTTP 406
Cause: One or more items in the bulk cancellation batch contains an invalid ReasonCode.
በጅምላ ስረዛ ውስጥ ካሉት ሰነዶች አንዱ ወይም ከዚያ በላይ ልክ ያልሆነ የስረዛ ምክንያት ኮድ ይዟል።
Remediation Workflow:
Ensure all items specify a valid reason code (1: Duplicate, 2: Entry Mistake, 3: Return, 4: Other).
Code 7004
Buyer Id Type Validator Failure
የገዥ መለያ አይነት (IdType) ስህተት
HTTP 406
Cause: Buyer ID Type must strictly be one of: NID, KID, SID, WID, PST, DLS, MRS.
የገዥው መለያ አይነት ከ NID, KID, SID, WID, PST, DLS, MRS አንዱ መሆን አለበት።
Remediation Workflow:
Set BuyerDetails.IdType to KID (Kebele ID) or NID (National ID) with valid IdNumber.
Code 7005
Region Code for Buyer Validator Failure
የገዥ ክልል ኮድ ስህተት
HTTP 406
Cause: Buyer Region or City code is not recognized in the MoR geographic registry.
የገዥው የክልል ወይም የከተማ ኮድ በገቢዎች ሚኒስቴር እውቅና ካላቸው ውጭ ነው።
Remediation Workflow:
Provide a correct, registered region code (e.g. Region: "1", City: "101" for Addis Ababa).
Code 7006
Buyer Legal Name Validator Failure
የገዥ ህጋዊ ስም ስህተት
HTTP 406
Cause: Buyer Legal Name is empty or does not match the registered legal name for this TIN.
የገዥው ህጋዊ ስም ባዶ ነው ወይም ከግብር ከፋይ መለያ ቁጥሩ (TIN) ጋር አይዛመድም።
Remediation Workflow:
Provide the exact legal trade name registered on the buyer tax certificate.
Code 7007
Seller TIN Mismatch
የሻጭ የግብር ከፋይ መለያ ቁጥር (TIN) አልተዛመደም
HTTP 406
Cause: Seller TIN in the invoice payload does not match the authenticated taxpayer TIN.
በደረሰኙ ውስጥ ያለው የሻጭ TIN ከተረጋገጠው የግብር ከፋይ TIN ጋር አይዛመድም።
Remediation Workflow:
Ensure SellerDetails.Tin matches the TIN used during MoR authentication. Check eims.tin config.
Code 7008
Buyer TIN Not Found in MoR Registry
የገዥ TIN በMoR ማዕከላዊ ዳታቤዝ አልተገኘም
HTTP 406
Cause: The buyer TIN was submitted with the correct format but is not registered in the MoR Central Taxpayer Registry. MoR validates that the buyer is an active, enrolled taxpayer — a correctly formatted 10-digit TIN that does not exist in their system will be rejected with this error.
የገዥው TIN ቅርጸቱ ትክክል ቢሆንም በMoR ማዕከላዊ የግብር ከፋዮች መዝገብ ውስጥ አልተመዘገበም። MoR ግዢ ፈጻሚው ንቁ የሆነ ምዝገባ ያለው ግብር ከፋይ መሆኑን ያረጋግጣል።
Remediation Workflow:
The buyer TIN must belong to an active taxpayer enrolled in MoR's Central Taxpayer Registry. For B2B/B2G/G2B transactions, confirm the TIN with the buyer directly or verify it via MoR's taxpayer lookup portal. For sandbox/development testing, use a TIN from a real registered entity — placeholder or self-assigned TINs will always fail this check. B2C retail sales do not require a buyer TIN.
Code 7009
Bulk Cancellation Limit Exceeded
የጅምላ ስረዛ መጠን ገደብ አልፏል
HTTP 406
Cause: The number of invoices submitted for bulk cancellation exceeds authorized quota.
ለጅምላ ስረዛ የቀረቡት የደረሰኞች ብዛት ከተፈቀደው ጣሪያ በላይ ሆኗል።
Remediation Workflow:
Raise support ticket with MoR to increase bulk cancellation limit or submit in smaller batches.
Code 7010
Cancellation Reason Code Invalid
የማይታወቅ የስረዛ ምክንያት ኮድ
HTTP 406
Cause: The provided cancellation reason code is not registered under Directive 1142/2018.
የቀረበው የስረዛ ምክንያት ኮድ በመመሪያ ቁጥር 1142/2018 ስር ያልተመዘገበ ነው።
Remediation Workflow:
Use registered reason codes: 1 (Duplicate), 2 (Entry Mistake), 3 (Sales Return), 4 (Other).
Code 7011
Currency Validator Failure
የገንዘብ አይነት ማረጋገጫ ስህተት
HTTP 406
Cause: Invoice currency is not a recognized ISO 4217 code or not permitted for this taxpayer.
የተጠቀሰው የገንዘብ አይነት በ ISO 4217 እውቅና የሌለው ወይም ለግብር ከፋዩ ያልተፈቀደ ነው።
Remediation Workflow:
Provide standard 3-character currency (ETB, USD, EUR, GBP, etc.).
Code 7012
Tax Account With Withholding Validator
የቀረጥ ተቀናሽ (Withholding) ማረጋገጫ ስህተት
HTTP 406
Cause: Withholding tax amount is incorrect or invalid for this transaction type. Income WHT applies only to B2B and B2G transactions (private-sector sellers); G2B government sellers are exempt. G2C/B2C require explicit withholding values from the caller.
የቀረጥ ተቀናሽ መጠኑ ትክክለኛ አይደለም። ለ B2B እና B2G ግብይቶች ብቻ የገቢ ቀረጥ ተቀናሽ (Income WHT) ተፈፃሚ ነው።
Remediation Workflow:
Verify IncomeWithholdValue and TransactionWithholdValue. G2B invoices must have IncomeWithholdValue = 0 (government sellers are income-tax exempt). B2G must have TransactionWithholdValue = 50% of TaxValue (MoR Tax Calculation Guide §4.2 & §10 Rule 3: government buyers withhold 50% of Output VAT at source). B2B services ≥ 3,000 ETB require 2% income WHT; goods ≥ 10,000 ETB require 1% income WHT.
Code 7013
Validate Source System / System Number
የምንጭ ስርዓት መለያ (System Number) ስህተት
HTTP 406
Cause: The SourceSystem.SystemNumber (MRC) is not registered or inactive under this TIN.
የስርዓት ቁጥሩ (System Number/MRC) በገቢዎች ሚኒስቴር ያልተመዘገበ ወይም ያልነቃ ነው።
Remediation Workflow:
Ensure SystemNumber matches the MRC certificate provisioned by MoR.
Code 7014
Item Code Validator Failure
የእቃ መለያ ኮድ (ItemCode) ስህተት
HTTP 406
Cause: Item code is missing or malformed on one or more line items.
የእቃ መለያ ኮድ በአንዱ ወይም ከዚያ በላይ እቃዎች ላይ አልተካተተም ወይም የተዛባ ነው።
Remediation Workflow:
Provide non-empty SKU/ItemCode for all non-manual invoice lines.
Code 7015
Invoice Counter Validator Failure / Sequence Divergence
የደረሰኝ ቆጣሪ ቅደም ተከተል ልዩነት
HTTP 406
Cause: InvoiceCounter is out of sequence with the central MoR fiscal ledger.
የደረሰኝ ቅደም ተከተል ቁጥር ከገቢዎች ማዕከላዊ መዝገብ ጋር አልተጣጣመም።
Remediation Workflow:
System automatically syncs counter to MoR expected sequence and resubmits.
Code 7016
Region Code for Seller Validator Failure
የሻጭ ክልል ኮድ ስህተት
HTTP 406
Cause: Seller Region code does not match registered taxpayer branch location.
የሻጩ የክልል ኮድ በገቢዎች ከተመዘገበው ቅርንጫፍ አድራሻ ጋር አይዛመድም።
Remediation Workflow:
Provide registered seller Region code (e.g. "1" for Addis Ababa).
Code 7017
Seller Details Checker Failure
የሻጭ ዝርዝር መረጃ ስህተት
HTTP 406
Cause: Seller details (LegalName, VatNumber, Address) do not match MoR master record.
የሻጩ መረጃ (ህጋዊ ስም፣ የተጨማሪ እሴት ታክስ ቁጥር፣ አድራሻ) ከገቢዎች መዝገብ ጋር አይጣጣምም።
Remediation Workflow:
Update seller details in EIMS settings to match tax registration certificate.
Code 7018
Tax Center Lookup Failure
የግብር ቅርንጫፍ ማረጋገጫ ስህተት
HTTP 406
Cause: Taxpayer tax center could not be resolved from provided branch credentials.
የግብር ከፋዩ የታክስ ማዕከል ቅርንጫፍ ሊረጋገጥ አልቻለም።
Remediation Workflow:
Verify taxpayer branch and tax center association with MoR.
Code 7019
Previous IRN Checker / Hash Chaining Failure
የቀዳሚ IRN አለመጣጣም (የሰንሰለት መቋረጥ)
HTTP 406
Cause: The PreviousIrn hash does not match the last recorded IRN on the MoR fiscal chain.
የቀረበው የቀዳሚ IRN ቁጥር በገቢዎች ሰንሰለት ከተመዘገበው የመጨረሻ IRN ጋር አይዛመድም።
Remediation Workflow:
System queries latest confirmed IRN and updates chain state before resubmission.
Code 7020
Credit / Debit Note Validator Failure
የክሬዲት/ዴቢት ኖት ስሌት ስህተት
HTTP 406
Cause: Credit/Debit note financial amounts exceed original invoice or missing required fields.
የክሬዲት ወይም ዴቢት ኖት መጠን ከመጀመሪያው ደረሰኝ ይበልጣል ወይም መረጃ ጎድሎታል።
Remediation Workflow:
Ensure credit/debit amount is less than or equal to original invoice total.
Code 7021
Related Document Validation Failure (Rule 31)
የተዛማጅ ደረሰኝ ማረጋገጫ ስህተት (ደንብ 31)
HTTP 406
Cause: Credit note must reference an existing active invoice and Buyer details must match original invoice.
ክሬዲት ኖት ቀደም ሲል በስራ ላይ ያለ የተመዘገበ ደረሰኝ መጥቀስ እና የገዢው መረጃ ከዋናው ጋር መዛመድ አለበት።
Remediation Workflow:
Ensure original IRN exists and that buyer details (Name, City, Phone) match the original invoice.
Code 7022
Payment Mode Validator Failure
የክፍያ ዘዴ ማረጋገጫ ስህተት
HTTP 406
Cause: Payment mode is not recognized in MoR specification §2.1.
የክፍያ ዘዴው በገቢዎች ሚኒስቴር ተቀባይነት ካላቸው ዝርዝሮች ውጭ ነው።
Remediation Workflow:
Use CASH, CREDIT, Direct Transfer, TELEBIRR, CBE BIRR, CARD, CHEQUE, or CPO.
Code 7023
Unit of Measure Validator Failure
የእቃ መለኪያ (UoM) ስህተት
HTTP 406
Cause: Unit of measure is not in MoR allowed enumeration: [PCS, LTR, KLG, MTR, PKG, SET, ROL, MTS, SRV]. Numeric codes (e.g. "101") are not permitted — they are automatically mapped to SRV for services.
የእቃው መለኪያ በገቢዎች ከተፈቀዱት (PCS, LTR, KLG, MTR, PKG, SET, ROL, MTS, SRV) ውጭ ነው። እንደ "101" ያሉ ቁጥሮች ልክ አይደሉም።
Remediation Workflow:
Map unit code to standard MoR enumeration (e.g. BOX/BAG/CTN -> PKG).
Code 7024
Tax Code Validator Failure
የታክስ ኮድ ስህተት
HTTP 406
Cause: Item TaxCode is invalid (must strictly be VAT15, VAT0, VATEX, TOT2, TOT10).
የታክስ ኮድ ልክ ያልሆነ ነው (መሆን ያለበት: VAT15, VAT0, VATEX, TOT2, TOT10)።
Remediation Workflow:
Set line item tax code strictly to one of the authorized MoR tax codes.
Code 7025
Validate Nature of Supply
የአቅርቦት አይነት (Nature of Supply) ስህተት
HTTP 406
Cause: NatureOfSupplies must strictly be "goods" or "service" (all lowercase).
የአቅርቦት አይነት መሆን ያለበት "goods" ወይም "service" (ሁሉም ትንሽ ፊደል) ብቻ ነው።
Remediation Workflow:
Set NatureOfSupplies to "goods" or "service" (all lowercase, per MoR oneOf schema).
Code 7026
Document Date By Type Validator Failure
የሰነድ ቀን ቅርጸት ስህተት
HTTP 406
Cause: Document Date format is invalid or timestamp is outside permissible time window.
የሰነዱ ቀን ቅርጸት ልክ ያልሆነ ነው ወይም ከተፈቀደው የጊዜ ገደብ ውጭ ነው።
Remediation Workflow:
Provide date in standard format: DD-MM-YYYYTHH:mm:ss.
Code 7027
Transaction Type Checker Failure
የግብይት አይነት ስህተት
HTTP 406
Cause: Transaction type must strictly be one of: B2B, B2C, B2G, G2B, G2C.
የግብይት አይነት ከ B2B, B2C, B2G, G2B, G2C አንዱ መሆን አለበት።
Remediation Workflow:
Set TransactionType to B2B, B2C, B2G, G2B, or G2C.
Code 7028
Document Type Validator Failure
የሰነድ አይነት ስህተት
HTTP 406
Cause: Document type must be one of: INV, CRE, DEB, INT, RTN, FIN, MIX, INC, PRF, OVD.
የሰነድ አይነት INV, CRE, DEB, INT, RTN, FIN, MIX, INC, PRF, OVD መሆን አለበት።
Remediation Workflow:
Use standard document types: INV (Standard Invoice), CRE (Credit Note), etc.
Code 7029
Seller Details Existence Checker Failure
የሻጭ መረጃ መኖር ማረጋገጫ ስህተት
HTTP 406
Cause: Seller details are missing from the invoice payload.
የሻጩ ዝርዝር መረጃ በደረሰኙ ውስጥ አልተካተተም።
Remediation Workflow:
Provide complete SellerDetails node with Tin, LegalName, and Address.
Code 7030
Exchange Rate Required for Foreign Currency
የምንዛሬ ተመን አልተገለጸም
HTTP 406
Cause: ExchangeRate is missing or non-positive for foreign currency transaction.
የምንዛሬ ተመን አልተገለጸም ወይም ከ 0 በታች ነው።
Remediation Workflow:
Ensure a valid positive ExchangeRate is entered by the user.
Code 7035
Invoice Already Cancelled with MoR
ደረሰኙ አስቀድሞ በገቢዎች ሚኒስቴር ተሰርዟል
HTTP 400
Cause: This invoice has already been officially cancelled in the Ministry of Revenues central fiscal registry.
ይህ ደረሰኝ በገቢዎች ሚኒስቴር ማዕከላዊ የግብር መዝገብ ላይ አስቀድሞ የተሰረዘ ነው።
Remediation Workflow:
The invoice is already voided with the tax authority. No further cancellation required.
Code 7036
IRN Not Registered in MoR
የደረሰኝ መለያ ቁጥር (IRN) በገቢዎች አልተመዘገበም
HTTP 400
Cause: The invoice IRN is not registered in the MoR EIMS central database.
የቀረበው የደረሰኝ መለያ ቁጥር (IRN) በገቢዎች ሚኒስቴር ማዕከላዊ የውሂብ ጎታ ውስጥ አልተገኘም።
Remediation Workflow:
Verify that the invoice was successfully transmitted and certified by MoR before attempting cancellation.
Code 4608
Invalid Digest Algorithm in PKI Signature
ልክ ያልሆነ የምስጢራዊ ዳይጀስት አልጎሪዝም
HTTP 400
Cause: The message digest algorithm must strictly be SHA-256 (SHA256withRSA) per MoR §5.1.6 and FIPS 186-4.
የዲጂታል ፊርማው ዳይጀስት አልጎሪዝም በMoR §5.1.6 መመሪያ መሰረት SHA-256 ብቻ መሆን አለበት።
Remediation Workflow:
Ensure InsaPkiSigner uses OPENSSL_ALGO_SHA256 for cryptographic signature generation.
Code 67016
Digital Certificate Revoked
የዲጂታል ሰርተፍኬቱ ውድቅ (Revoked) ተደርጓል
HTTP 400
Cause: The INSA X.509 certificate has been revoked on the Certificate Revocation List (CRL).
የINSA ዲጂታል ሰርተፍኬት በስረዛ ዝርዝር (CRL) ላይ ተመዝግቧል።
Remediation Workflow:
Generate a fresh 2048-bit RSA CSR and request a new certificate from ica@insa.gov.et.
Code 7031
Taxpayer Tax Accounts Registration Validator
የግብር ከፋይ ታክስ ምዝገባ ማረጋገጫ ስህተት
HTTP 406
Cause: Supplier is not registered for the specified tax accounts (e.g. charging VAT when not VAT-registered).
አቅራቢው ለተጠቀሰው የታክስ አይነት አልተመዘገበም (ለምሳሌ ተ.እ.ታ ሳይመዘገብ 15% VAT ማስከፈል)።
Remediation Workflow:
Make sure you are using the correct tax code matching your official MoR tax registration.
Code 7032
Minimum Transaction Value Threshold Violation
አነስተኛ የግብይት መጠን ገደብ ስህተት
HTTP 406
Cause: Withholding tax was deducted on an invoice below statutory minimum threshold.
የቀረጥ ቅነሳ (WHT) ከተፈቀደው አነስተኛ የገንዘብ መጠን በታች ባለው ደረሰኝ ላይ ተተግብሯል።
Remediation Workflow:
Do not apply withholding tax for services < 3,000 ETB or goods < 10,000 ETB (Proclamation 983/2016).
Code 7033
Negative Line Item Total Prohibited
አሉታዊ የደረሰኝ ዋጋ ተከልክሏል
HTTP 406
Cause: Invoice line item totals must be non-negative. For returns/refunds, issue a Credit Note (CRE) instead.
የደረሰኝ ዝርዝር እቃዎች ዋጋ ከአሉታዊ (-) ቁጥር ውጭ መሆን አለበት። ለተመላሽ እቃዎች የክሬዲት ኖት (CRE) ይጠቀሙ።
Remediation Workflow:
Ensure all invoice line item prices and quantities are positive numbers.
Code 70031
Taxpayer Tax Accounts Registration Validator
የግብር ከፋይ ታክስ ምዝገባ ማረጋገጫ ስህተት
HTTP 406
Cause: Supplier is not registered for the specified tax accounts (e.g. charging VAT when not VAT-registered).
አቅራቢው ለተጠቀሰው የታክስ አይነት አልተመዘገበም (ለምሳሌ ተ.እ.ታ ሳይመዘገብ 15% VAT ማስከፈል)።
Remediation Workflow:
Make sure you are using the correct tax code matching your official MoR tax registration.
Thermal Printer Troubleshooting (80mm / 58mm)
Blank Paper Out: Thermal paper is single-sided. Flip the roll so the glossy side touches the print head.
Cutter Jam: Power off the printer, open cover manually with release lever, remove jammed scrap, and re-feed.
Dim Printing: Clean the thermal heating element with a dry lint-free cloth or isopropyl alcohol swab.
Barcode Scanner & Cash Drawer
Scanner Not Typing: Ensure cursor is focused on the search box (/). Unplug and reconnect USB cable.
Drawer Won't Kick: Verify RJ11 cable is securely plugged from receipt printer kick-out port into drawer bottom.
Morning Shift Opening Checklist
  • Power on POS monitor, printer, and barcode scanner.
  • Check paper roll reserve (ensure at least 25% remaining).
  • Verify date & time synchronization (Directive Rule 7026 NTP check).
  • Press F3 to run a diagnostic test print.
Evening Shift Closing Checklist
  • Press F10 and ensure Offline Pending Count is 0.
  • Run mandatory Daily Fiscal Z-Report (FL-02).
  • Reconcile physical cash drawer against collected totals.
  • Enclose signed Z-slip with drawer cash drop envelope.
Tip: Press Ctrl+K or F1 from anywhere to open this handbook.
© 2026 Tewos EIMS POS • Directive 1142/2018 E.C. Certified Made with ❤️ for Ethiopia 🇪🇹