Other errors
Codes any exchange call can meet are recorded once, in the Other specification: the gateway's NHCX- codes, the standard payer codes, and the reference payer's structure and transport codes. The reference payer's other codes sit with the exchange they reject: coverage eligibility, preauthorisation, claim and insurance plan. Reading error codes explains the code spaces.
18 codes from PAYR-1003 to PAYR-1020 mean one thing on the standard payer sheet and another on the reference payer's sheet. Read the code together with its message.
Gateway codes
Gateway codes, NHCX-. Sent by the exchange; they arrive synchronously on your own call, or on /v1/error.
Unclassified
The rule that reads the message could not classify these. Read the message and decide.
| Code | Message |
|---|---|
NHCX-401 | User Unauthorized |
NHCX-1001 | Receiver system is not reachable. |
NHCX-1002 | Sender not registered in NHCX. Please register in NHCX portal and try again. |
NHCX-1003 | Receiver not registered in NHCX. Please try again with valid receiver details. |
NHCX-1004 | No receiver registered in NHCX for the requested scheme. Please try again with valid receiver details for the scheme. |
NHCX-1005 | Invalid request header. Please try again with valid headers. |
NHCX-1006 | Duplicate request. Request with same correlation id already exist in the system. |
NHCX-1007 | Something went wrong while processing the request. Please check the request structure and values and try again. |
NHCX-1008 | Something went wrong while processing the request. Please try again after sometime. |
NHCX-1009 | Something went wrong while processing the request. Please check log for more details. |
NHCX-1010 | No Data with given Correlation id for call back request, please check status for more details |
NHCX-1011 | Invalid Status, please check x-hcx-status value from the protected header |
NHCX-1012 | No records found with the requested api caller id. Please try again with a valid api caller id. |
NHCX-1013 | Invalid or blank request found. |
NHCX-1014 | Unable to send protocol response to sender. |
NHCX-1015 | Invalid response received from receiver. |
NHCX-1016 | Invalid Api Action, please check the request action for this correlationId before trying again |
NHCX-1017 | Invalid response received from receiver |
NHCX-1018 | Invalid ABHA number received. ABHA number should be sent in the format XX-XXXX-XXXX-XXXX |
Standard Payer codes
Standard payer codes, PAYR-1001 to PAYR-1020. Sent by A payer implementing the published standard; they arrive inside the sealed response.
Unclassified
The rule that reads the message could not classify these. Read the message and decide.
| Code | Message |
|---|---|
PAYR-1001 | Error while decrypting request. Please reprocess the request encrypting with valid certificate of the payer. |
PAYR-1002 | Error while encrypting request. Please update encryption certificate in NHCX. |
PAYR-1003 | Error while connecting to NHCX. System will try to resend the message to NHCX after some time. |
PAYR-1004 | Provider is not registered with the payer for requested policy. |
PAYR-1005 | Beneficiary is not a covered member for requested policy. Please enroll beneficiary for the policy and try again. |
PAYR-1006 | Policy does not exist. Please try with a valid policy. |
PAYR-1007 | Requested policy is expired. Please try with a valid policy. |
PAYR-1008 | Eligible coverage amount of the beneficiary for the requested policy is insufficient to process the request. |
PAYR-1009 | Requested items are not valid or not covered. Please try again with valid or covered items. |
PAYR-1010 | Preauthorization is required to process the request but was not obtained. |
PAYR-1011 | Enhancement request can not be processed as the prior approved package/procedure does not support enhancement. |
PAYR-1012 | Claim amount requested is more than the preauthorization approved amount. |
PAYR-1013 | No prior approval for the requested procedures/packages obtained. |
PAYR-1014 | Date of birth of the beneficiary can not be after date of service. |
PAYR-1015 | Date of service cannot be after date of death. |
PAYR-1016 | Duplicate claim submitted based on service codes and dates. |
PAYR-1017 | Amount calculations are not correct. Please verify calculated amount. |
PAYR-1018 | Time limit for submission expired. |
PAYR-1019 | Requested additional information was not received or was not received within time limit |
PAYR-1020 | Unable to process payment as no valid bank details found for the provider. |
Reference Payer codes
Reference payer codes, PAYR-1001 to PAYR-1520. Sent by the PMJAY reference implementation; they arrive inside the sealed response.
Unclassified
The rule that reads the message could not classify these. Read the message and decide.
| Code | Message |
|---|---|
PAYR-1001 | Error occurred while decrypting payload for receiver code <receiver_code> with correlation id <sender_correlation_id>. |
PAYR-1002 | Error occurred while encrypting payload for receiver code <receiver_code> with correlation id <sender_correlation_id>. |
PAYR-1003 | Invalid workflow requested. Hence request will not be processed further. |
PAYR-1004 | Received FHIR bundle is malformed. Please correct the bundle and try again. |
PAYR-1005 | Maximum time limit exceeded in receiving the request. Please try again. |
PAYR-1006 | Invalid name in request. Hence request will not be processed further. |
PAYR-1007 | Invalid gender in request. Hence request will not be processed further. |
PAYR-1008 | Invalid FHIR bundle received. Hence request will not be processed further. |
PAYR-1009 | No identifier found for patient component. Hence request will not be processed further. https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Patient.html |
PAYR-1010 | No type found for patient component identifier. Hence request will not be processed further. https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Patient.html |
PAYR-1011 | No identifier found for claim component. Hence request will not be processed further. |
PAYR-1012 | No type found for claim component identifier. Hence request will not be processed further. |
PAYR-1013 | No identifier found for organization component for provider. Hence request will not be processed further. |
PAYR-1014 | No type found for organization component identifier for provider. Hence request will not be processed further. |
PAYR-1015 | No identifier found for organization component for payer. Hence request will not be processed further. |
PAYR-1016 | No type found for organization component identifier for payer. Hence request will not be processed further. |
PAYR-1017 | No task code received. Hence request will not be processed further. |
PAYR-1018 | No task reason code received. Hence request will not be processed further. |
PAYR-1019 | Invalid sequence received in supporting info element. Hence request will not be processed further. |
PAYR-1020 | Invalid category received in supporting info element for sequence %s. Hence request will not be processed further. |
PAYR-1021 | Invalid code received in supporting info element for sequence %s. Hence request will not be processed further. |
PAYR-1023 | Invalid procedure category received for procedure component. Hence request will not be processed further. |
PAYR-1024 | Invalid procedure status received for procedure component. Hence request will not be processed further. |
PAYR-1025 | Invalid procedure sequence received for procedure component. Hence request will not be processed further. |
PAYR-1026 | No procedure component found for reference in claim component. Hence request will not be processed further. |
PAYR-1027 | Invalid item id found for item in claim component. Hence request will not be processed further. |
PAYR-1028 | Invalid item sequence received for item in claim component. Hence request will not be processed further. |
PAYR-1029 | Invalid bundle id received for FHIR bundle. Hence request will not be processed further. |
PAYR-1030 | Invalid questionnaire id received in FHIR bundle for questionnaire component. Hence request will not be processed further. |
PAYR-1031 | Invalid url received for bundle entry in FHIR bundle. Hence request will not be processed further. Please reach out to technical team. |
PAYR-1032 | Invalid purpose received for coverage eligibility request. Hence request will not be processed further. Please try again with valid purpose details. |
PAYR-1033 | No items received for coverage eligibility purpose. Since items are mandatory for the requested purpose, hence request will not be processed further. Please try again with valid item details. |
PAYR-1034 | Invalid procedure code received. Please try again with valid procedure details. |
PAYR-1035 | Invalid policy code received. Please try again with valid policy details. |
PAYR-1036 | Invalid attachment received in supporting info with sequence number %s. Please try again with valid attachment details as attachment value is expected. If issue is not resolved, please reach out to technical team. |
PAYR-1037 | No identifier found for communication component. Hence request will not be processed further. |
PAYR-1038 | No type found for communication component identifier. Hence request will not be processed further. |
PAYR-1039 | No payload found for communication component. Hence request will not be processed further. |
PAYR-1040 | No component found for given reference. Hence request will not be processed further. |
PAYR-1041 | No identifier found for procedure component. Hence request will not be processed further. |
PAYR-1042 | No type found for procedure component identifier. Hence request will not be processed further. |
PAYR-1043 | Date received in the request does not adhere to the NRCES date datatype format. Hence request will not be processed further. Please refere to the date format in NRCES portal. |
PAYR-1044 | Date and time received in the request does not adhere to the NRCES date datatype format. Hence request will not be processed further. Please refere to the date time format in NRCES portal. |
PAYR-1045 | Invalid quantity received for item. Hence request will not be processed further. |
PAYR-1046 | No value or timing details received for supporting info for sequence %s. Hence request will not be processed further. Please reach out to technical team. |
PAYR-1047 | Invalid reference received in supporting info with sequence number %s. Please try again with valid resource as reference value. |
PAYR-1048 | No reference resource received for supporting info with sequence number %s. Please try again with valid resource for reference value. |
PAYR-1049 | Invalid FHIR bundle received. Hence request will not be processed further. please reach out to technical team. |
PAYR-1050 | No type found for practitioner component identifier. Hence request will not be processed further. |
PAYR-1051 | No section found for composition component. Hence request will not be processed further. |
PAYR-1052 | No references found in composition section. Hence request will not be processed further. |
PAYR-1053 | Invalid reference found in child sections of composition section. Hence request will not be processed further. |
PAYR-1054 | No section content found for composition component. Hence request will not be processed further. |
PAYR-1055 | Invalid subject type found for composition component. This should be of type Patient. Hence request will not be processed further. Please try again with valid subject type for the composition. |
PAYR-1056 | Invalid contact organization found for subject in composition component. This should be of type Organization. Hence request will not be processed further. Please try again with valid data. |
PAYR-1057 | Invalid general practioner type found for subject in composition component. This should be of type Organization/Practitioner/PractitionerRole. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Patient.html |
PAYR-1058 | Invalid managing organization type found for subject in composition component. This should be of type Organization. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Patient.html |
PAYR-1059 | Invalid encounter type found for composition/observation component. This should be of type Encounter. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-DiagnosticReportRecord.html |
PAYR-1060 | No subject found for encounter in composition component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1061 | Invalid subject type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1062 | No episode of care found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1063 | Invalid episode of care type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1064 | No based on found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1065 | Invalid based on type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1066 | No appointment found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1067 | Invalid appointment type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1068 | No reason reference found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1069 | Invalid reason reference type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1070 | No author found for composition component. Hence request will not be processed further. |
PAYR-1071 | Invalid author type found for composition component. This should be of type Practitioner / PractitionerRole / Organization / Patient / Device / RelatedPerson. Hence request will not be processed further. Please try again with valid author type for the composition. |
PAYR-1072 | No procedure reference received for procedure element in claim resource. Hence request will not be processed further. |
PAYR-1073 | No based on found for observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Observation.html |
PAYR-1074 | Invalid based on type found for observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Observation.html |
PAYR-1075 | No part of found for observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Observation.html |
PAYR-1076 | Invalid part of type found for observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Observation.html |
PAYR-1077 | No subject found for observation component. Hence request will not be processed further. |
PAYR-1078 | Invalid subject type found for observation component. This should be of type Patient. Hence request will not be processed further. Please try again with valid subject type for the observation. |
PAYR-1079 | No care team details received. Hence request will not be processed further. Please add the care team details and try again. |
PAYR-1080 | Invalid HPR details received for practioner resource with url %s. Hence request will not be processed further. Please try again with valid HPR id. |
PAYR-1081 | Invalid service date received for item with sequence %s in claim resource. Hence request will not be processed further. Please try again with valid item service date. |
PAYR-1082 | Invalid title received for composition for supporting info with sequence %s in claim resource. Hence request will not be processed further. Please try again with valid composition title. |
PAYR-1083 | No HPR details found for the practitioner for resource %s. Hence request will not be processed further. Please send the details in the identifier for Practitioner resource with category code as HPIN. |
PAYR-1084 | No questionnaire response resource found for url %s. Hence request will not be processed further. Please add the resources for all the references given in the FHIR bundle and try again. |
PAYR-1085 | Invalid questionnaire response resource type found in the FHIR bundle for url %s. Hence request will not be processed further. |
PAYR-1086 | No procedure resource found for url %s. Hence request will not be processed further. Please add the resources for all the references given in the FHIR bundle and try again. |
PAYR-1087 | Invalid procedure resource type found in the FHIR bundle for url %s. Hence request will not be processed further. Procedure resource type is expected. |
PAYR-1088 | Invalid composition details. |
PAYR-1089 | No billing items found. Hence request will not be processed further. Please try again with valid billing items. |
PAYR-1090 | No identifier found for coverage component. Hence request will not be processed further. |
PAYR-1091 | No type found for coverage component identifier. Hence request will not be processed further. |
PAYR-1092 | Something went wrong while processing request, kindly intiate new request |
PAYR-1093 | No subject found for encounter in composition component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1094 | Invalid subject type found for encounter in composition/observation component. Hence request will not be processed further. Please refer to https://www.nrces.in/ndhm/fhir/r4/StructureDefinition-Encounter.html |
PAYR-1095 | Invalid discharge information received for claim request. Hence request will not be processed further. Please send the discharge information in supporting info in claim resource, with category as DIS (refer - https://www.nrces.in/ndhm/fhir/r4/ValueSet-ndhm-supportinginfo-category.html), and codes in LAMA/DAMA/DTH/DTM (refer - https://www.nrces.in/ndhm/fhir/r4/ValueSet-ndhm-supportinginfo-code.html). |
PAYR-1096 | Invalid death date received for claim request. Hence request will not be processed further. Please send the death date information in supporting info in claim resource, with category as ONS (refer - https://www.nrces.in/ndhm/fhir/r4/ValueSet-ndhm-supportinginfo-category.html), and code as DTM (refer - https://www.nrces.in/ndhm/fhir/r4/ValueSet-ndhm-supportinginfo-code.html). |
PAYR-1097 | No payload found in the request. Please ensure that the request that is being sent, contains encrypted payload within the mandatory payload properties. |
PAYR-1098 | Value type received as %s for category - OTH and code - EDT for item with sequence %s in supporting info in claim resource. In supporting info list, item with category - OTH and code - EDT combination is used to get the registration date. So the registration date should be sent as timing (date or period) or as a string value, adhering to the NRCES standards, with the category - OTH and code - EDT. |
PAYR-1099 | Value type received as %s for category - ONS and code - DSDE for item with sequence %s in supporting info in claim resource. In supporting info list, item with category - ONS and code - DSDE combination is used to get the discharge date. So the discharge date should be sent as timing (date or period) or as a string value, adhering to the NRCES standards, with the category - ONS and code - DSDE. |
Observed codes
Observed live codes, ERR-PYR-. Sent by the PMJAY reference implementation, on none of its published sheets; they arrive inside the sealed response.
On none of the seven sheets. The SHA HP sandbox sent it for a claim raised under a number of its own rather than the preauthorisation's.
| Code | Message |
|---|---|
ERR-PYR-CLM-007 | No prior preauthorization or claim record found for case number |
Code ranges
| Range | What it covers | Examples |
|---|---|---|
NHCX-1xxx | The exchange, on the envelope. The message never reached the payer. | NHCX-1001, NHCX-1002 |
PAYR-10xx | Transport and bundle structure. An element, id, sequence or type is missing. Not a value problem. | PAYR-1001, PAYR-1002 |
PAYR-11xx | Coverage eligibility. The policy, the beneficiary or the hospital configuration. | PAYR-1101, PAYR-1102 |
PAYR-12xx | Preauthorisation. Codes, amounts, dates, sequencing and scheme rules. | PAYR-1201, PAYR-1202 |
PAYR-13xx | Claim. The same, against the approved preauthorisation. | PAYR-1301, PAYR-1302 |
PAYR-14xx | Insurance plan, and the scheme's outer rules. Empanelment, policy association, plan configuration. | PAYR-1401, PAYR-1402 |
Every code above is recorded in the specification that owns it. The aggregated list across modules is at error codes.