Error codes and messages



This page is a proposal to the community, not an approved directive

When an error is encountered in openIMIS, the user must have precise information on the error so the support team will know where to start there troubleshooting, this information can also be used in a FAQ

here are the information that this error message should contain:

  • Error code - Unique code

  • Context (e.g: Claim submission,) - translated in resource file

  • Error Type message (e.g: not authorized, ) - translated in resource file


Possible naming convention for the error codes:

Vendor(2 hexa)MODULE(2 hexa)unique_context(4 hexa)-ErrType (3 digits)

Vendor: Creator of the module (Exact in our case)
Module: openIMIS functional Module (proposal for the current module below)
Context: Action that failed
ErrType: Error type like the Http ones (


Here the example with the message M_PASSWORDERROR

  • Error code - 0x01010201-401

  • Context - web application access

  • Error Type message - authentication is required and has failed

Vendor: 01 (Exact)
Module: 01 (core)
Context: 0201 (webapp access)
ErrType: 401 - authentication is required and has failed

The module list is still to be define, to have the latest status please refer to openIMIS Modules

Did you encounter a problem or do you have a suggestion?

Please contact our Service Desk

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.