Troubleshooting
Grantor Troubleshooting
The following list describes Grants.gov System to System (S2S) Error Messages. They are returned when the Web Services fail.
| Error Number | Error Name | Error Description |
|---|---|---|
| 00 | E_METHOD_UNSUCCESSFUL | Method was unsuccessful |
| 01 | E_NO_SESSION | No session |
| 02 | E_NO_USER_CERT | No user certificate |
| 03 | E_NO_CERT_USER_ID | No user ID [serial #] in certificate |
| 04 | E_INVALID_CERT | Invalid certificate |
| 05 | E_NO_AGENCY_TRACK_NUM | Missing agency tracking number |
| 06 | E_NO_GG_NUM | Missing Grants.gov number |
| 07 | E_NO_USER_ID | Missing user id |
| 08 | E_CANT_RETRIEVE_APP | Unable to retrieve application |
| 09 | E_UNSUPPORTED_FILTER | Unsupported Filter" |
| 10 | E_USER_LACKS_ROLE | User lacks Role necessary to perform this function |
| 11 | E_NOT_USERS_APP | User not authorized to modify this application |
| 12 | E_AUTHORIZATION_FAILURE | Authorization Failure |
| 13 | E_UNRECOGNIZED_GG_NUM | Unrecognized Grants.gov Tracking Number |
| 14 | E_CANT_DETERMINE_USER_AGENCY | Unable to determine user's organization |
| 15 | E_APPLICANT_SUBMIT_DOWN | Applicant WS Submission Sub-System is unavailable |
| 16 | E_RECEIVE_ERROR | Grants.gov was unable to receive your submission |
| 17 | E_APPS_NOT_RETRIEVED | Applications not yet retrieved |
| 18 | E_NO_OPPORTUNITY_XML | Opportunity/FOA XML is null or empty |
| 19 | E_NO_OPPORTUNITY_NUM | Missing opportunity/FOA number |
| 20 | E_NO_OPPORTUNITY_FOR_AGENCY | Could not find opportunity for your agency |
| 21 | E_ATTACHMENT_ERROR | The following attachment error(s) were found: |
| 22 | E_INVALID_XML_USER_ID | Invalid user ID in opportunity XML |
| 23 | E_NOT_AOR | You are not designated by your organization to be an Authorized Organizational Representative |
| 24 | E_INVALID_USER_PASSWORD_ATTEMPT | Please verify that you have typed your username and password correctly. Note: The password is case sensitive |
| 25 | E_USER_PASSWORD_EXPIRING | Warning! Your Password will expire in |
| 26 | E_USER_LOCKED | Alert! This account has been locked because three (3) consecutive unsuccessful login attempts were made. Please wait 15 minutes before attempting to submit an application |
| 27 | E_USER_PASSWORD_EXPIRED | Alert! Your Password has expired. In order to submit your application you will need to change your password. After you have successfully changed your password submit the application package again |
| 28 | E_USER_INACTIVE | Your account is inactive |
| 29 | E_SUBMISSION_INVALID_STATUS | Only applications in the following status can be downloaded: Validated, Received by Agency, or Agency Tracking Number Assigned |
| 30 | E_NO_PROFILE_FOUND_FOR_USER_ID | No Profile found for the specified User ID |
| 31 | E_NO_PROFILE_FOUND_FOR_USER_ID_AND_DUNS | No Profile found for the specified User ID and DUNS |
| 32 | E_USER_LACKS_PRIVILEGE | User lacks privilege(s) necessary to perform this function |
| 33 | E_INVALID_HEADER_VERSION | Rejected due to discontinued support of Header-V1.0. Please use Header-V2.0 |
| 34 | E_NO_DUNS_FOUND_FOR_USER_ORG | Unable to determine the user's organization |
The following list describes additional Grants.gov S2S Error Messages for the new Web Services. They are returned when the Web Services fail.
| Error Code | Error Message | Validation Rule |
|---|---|---|
| SEC-1001 | Certificate has none of the following roles: {Roles List} |
Certificate must have at least one of the required roles for the web service. For more details of which roles are required, please see the business rules for the specific web service. |
| SEC-1002 | Opportunity does not belong to certificate Agency (or any of its Sub-Agencies if certificate has Manage Agencies role) | Opportunity ID must belong to Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role) |
| SEC-1003 | Opportunity does not belong to certificate Agency or any of its Sub-Agencies | Opportunity ID must belong to Agency associated with the certificate or any of its Sub-Agencies |
| SEC-1004 | Certificate does not have {Role} role | Certificate must have Manage {Synopses, Forecast, Packages, or Agency Template Creator} role |
| SEC-1005 | Agency Code does not belong to certificate Agency (or any of its Sub-Agencies if certificate has Manage Agencies role) | Agency Code must match Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role) |
| SEC-1006 | Template does not belong to certificate Agency (or any of its Sub-Agencies if certificate has Manage Agencies role) | Template must belong to the Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role) |
| SEC-1007 | Certificate is not a valid Agency certificate | Certificate must be a valid Agency certificate (no roles required) |
| SEC-1008 | Opportunity(ies) {Opportunity ID(s)} do not belong to certificate Agency (Access to all specified Opportunities is required) | To add an Opportunity Relationship, both Opportunity IDs must be non-deleted, non-draft, and belong to Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role). Note: Opportunities in Draft status are not currently retrievable by S2S |
| SEC-1009 | Opportunity(ies) do not belong to certificate Agency (Access to at least one of the specified Opportunities it required) | To modify/remove an Opportunity Relationship, at least one of the Opportunity IDs must belong to Agency associated with the certificate (or any of its Sub-Agencies if certificate has Manage Agencies role), and both opportunities must be non-draft since S2S cannot currently retrieve draft opportunities |
| VAL-1001 | No input action specified | At least one action must be specified |
| VAL-1002 | Schema element {Name of Schema Element} contains invalid value(s) {Invalid Value(s)} | Specified schema element contains invalid values – list of invalid values provided in the error message |
| VAL-1101 | Opportunity Number is not unique for the Agency Code | Opportunity Number must be unique within Agency Code |
| VAL-1102 | Opportunity Number cannot be modified since Opportunity has a Package | Opportunity Number cannot be modified if the Opportunity has a Package |
| VAL-1103 | Opportunity Category Explanation is required if Opportunity Category is 'Other' | Opportunity Category Explanation is required if Opportunity Category is ‘Other' |
| VAL-1104 | Opportunity Category Explanation must be blank when Opportunity Category is not 'Other' | Opportunity Category Explanation must be blank when Opportunity Category is not ‘Other' |
| VAL-1105 | Opportunity CFDA(s) {CFDA List} are used in Opportunity Packages and cannot be removed | CFDA cannot be removed from the Opportunity if used in its Packages |
| VAL-1106 | Opportunity CFDA(s) {CFDA List} are not active in Grants.gov | Opportunity CFDA(s) must be active in Grants.gov |
| VAL-1107 | Opportunity has no CFDA Number | Opportunity must have at least one CFDA Number |
| VAL-1108 | Opportunity CFDA(s) {CFDA List} are not unique for the Opportunity | Opportunity CFDA(s) must be unique for the Opportunity |
| VAL-1109 | Cannot delete the last Opportunity component | If Opportunity only has a Forecast, Delete Adobe Opportunity must be used to delete the Forecast |
| VAL-1201 | Combination of Folder Type and Folder Name is not unique for the Opportunity | Combination of Folder Type and Folder Name must be unique for the Opportunity (Actions: Create Folder and Update Folder) |
| VAL-1202 | Folder ID not found for the Opportunity | Folder ID must belong to specified Opportunity ID (Actions: Update Folder and Delete Folder) |
| VAL-1203 | File Name is not unique for the folder | File Name must be unique within a folder (Actions: Add File and Replace File) |
| VAL-1204 | File Description is not unique for the folder | File Description must be unique within a folder (Actions: Add File and Replace File) |
| VAL-1205 | Folder not found for the Opportunity | Folder ID must belong to specified Opportunity ID (Action: Add File) |
| VAL-1206 | File not found for the Opportunity | File ID must belong to specified Opportunity ID (Actions: Replace File and Remove File) |
| VAL-1207 | Link Description is not unique for the Opportunity | Link Description must be unique for the Opportunity (Actions: Create Link and Update Link) |
| VAL-1208 | Link URL is not unique for the Opportunity | Link URL must be unique for the Opportunity (Actions: Create Link and Update Link) |
| VAL-1209 | Link URL does not begin with http:// or https:// | Link URL must begin with http:// or https:// (Actions: Create Link and Update Link) |
| VAL-1210 | Link not found for the Opportunity | Link ID must belong to specified Opportunity ID (Actions: Update Link and Delete Link) |
| VAL-1212 |
Cannot upload Attachment file to Grants.gov because it contains a virus |
Attachment file cannot contain viruses |
| VAL-1213 |
Both File and File Name must be provided if either is provided |
File and File Name must be provided if either is provided (Action: Replace File) |
| VAL-1301 | Opportunity already has a Forecast | Opportunity can only have one Forecast |
| VAL-1302 | Fiscal Year is not within a 10 year range starting with current fiscal year minus 2 and ending with current fiscal year plus 7 | Fiscal Year must be within a 10 year range starting with current fiscal year minus 2 and ending with current fiscal year plus 7 |
| VAL-1303 | Forecast cannot be created/updated while Synopsis is in Posted status | Forecast cannot be created/updated if the Opportunity has a Synopsis in Posted status |
| VAL-1304 | Forecast Post Date cannot be in the past | Forecast Post Date cannot be in the past |
| VAL-1305 | Forecast Post Date must be today since Opportunity has a Synopsis | If a Synopsis exists, Forecast cannot have a future Post Date |
| VAL-1306 | {Date Field 1} must be the same or later than {Date Field 2} | Forecast Dates must be in following Order if not blank (equal is fine): - Forecast Post Date - Estimated Synopsis Post Date - Estimated Application Due Date - Estimated Award Date - Estimated Project Start Date |
| VAL-1307 | Forecast Archive Date must be later than Forecast Post Date | Forecast Archive Date must be later than Forecast Post Date |
| VAL-1308 | Forecast Archive Date cannot be specified while Synopsis Post Date is in the future | If Synopsis has future Post Date, Forecast Archive Date cannot be provided (Forecast Archive Date will automatically be set to Synopsis Post Date minus one day) |
| VAL-1309 | Funding Activity Category Explanation is required if Funding Activity Category contains 'Other' | Funding Activity Category Explanation is required if Funding Activity Category contains ‘Other' |
| VAL-1310 | Funding Activity Category(ies) {Funding Activity Category List} are not unique for the Forecast | Funding Activity Category(ies) must be unique for the Opportunity |
| VAL-1311 | Additional Information on Eligibility is required if Eligible Applicants contains 'Other' | Additional Information on Eligibility is required if Eligible Applicants contains ‘Other' |
| VAL-1312 | Eligible Applicant(s) {Eligible Applicant List} are not unique for the Forecast | Eligible Applicant(s) must be unique for the Opportunity |
| VAL-1313 | Award Ceiling is less than Award Floor | Award Ceiling must be greater than or equal to Award Floor |
| VAL-1314 | Funding Instrument Type(s) {Funding Instrument Type List} are not unique for Forecast | Funding Instrument Type(s) must be unique for the Opportunity |
| VAL-1315 | Forecast Post Date can only be modified when it is in the future | Forecast Post Date can only be updated if current Post Date is in the future |
| VAL-1316 | Fiscal Year is not within a 10 year range starting with current Forecast fiscal year minus 2 and ending with current Forecast fiscal year plus 7 | Fiscal Year must be within a 10 year range starting with current Forecast fiscal year minus 2 and ending with current Forecast fiscal year plus 7 |
| VAL-1317 | Forecast not found for the Opportunity | Forecast cannot be updated/deleted if it does not exist |
| VAL-1318 | Forecast Archive Date cannot be set to today or in the past | Forecast Archive Date must be in the future |
| VAL-1401 | Package CFDA not included in Opportunity CFDA(s) | CFDA for the Package must be one of the Opportunity CFDA(s) |
| VAL-1402 | Combination of Competition ID, CFDA Number and Opportunity Number is not unique | Combination of Competition ID, CFDA Number and Opportunity Number must be unique |
| VAL-1403 | Competition Title is required if Competition ID is not blank | Competition Title is required if Competition ID is not blank |
| VAL-1404 | Competition Title must be blank if Competition ID is blank | Competition Title must be blank if Competition ID is blank |
| VAL-1405 | Closing Date must be the same or later than Opening Date | Closing Date must be the same or later than Opening Date |
| VAL-1406 | Package cannot have Closing Date today or in the past | Closing Date must be in the future |
| VAL-1407 | Template name not found | Template Name must exist in Grants.gov |
| VAL-1408 | Template does not contain mandatory SF-424 form | If Single-Project Package, Template must contain a mandatory SF-424 form |
| VAL-1409 | Overall Template does not contain mandatory SF-424 form | If Multi-Project Package, Overall Template must contain a mandatory SF-424 form |
| VAL-1410 | Cannot use Multi-Project Templates since Agency does not have Multi-Project feature activated | Multi-Project Templates are only available to Agencies with Multi-Project feature |
| VAL-1411 | Label(s) {Label List} are not unique for the Package | Label must be unique with a Multi-Project Package |
| VAL-1412 | Cannot have Multi-Project Packages since Agency does not have Multi-Project feature activated | Multi-Project Packages are only available to Agencies with Multi-Project feature |
| VAL-1413 | Max Iterations is less than Min Iterations | Max Iterations must be equal or greater than Min Iterations |
| VAL-1414 | Grants.gov Closings Calendar limit exceeded for specified Closing Date | Grants.gov Closings Calendar limit exceeded for specified Closing Date – Closing Date must be changed to a different day or contact PMO to request limit increase |
| VAL-1415 | Package not found for the Opportunity | Package ID must belong to specified Opportunity ID |
| VAL-1416 |
Cannot upload Instructions file to Grants.gov because it contains a virus |
Instructions file cannot contain a virus |
| VAL-1417 |
Cannot change Project Type (Single-Project or Multi-Project) for an existing Package |
Project Type (Single-Project or Multi-Project) cannot be modified |
| VAL-1418 |
Min Iterations is required when specified Sub-Application Group Label {Label} does not exist. |
Min Iterations must be specified when Sub-Application Group Label does not exist. |
| VAL-1419 |
Max Iterations is required when specified Sub-Application Group Label {Label} does not exist. |
Max Iterations must be specified when Sub-Application Group Label does not exist. |
| VAL-1420 |
Template Name is required when specified Sub-Application Group Label {Label} does not exist. |
Template Name must be specified when Sub-Application Group Label does not exist. |
| VAL-1421 |
Label {Label} must begin with a letter; only contain letters, numbers, spaces and underscores; and cannot equal ‘XML' |
Label must begin with a letter; only contain letters, numbers, spaces and underscores; and cannot equal ‘XML' |
| VAL-1422 |
Package cannot be reopened because it contains retired form(s) |
Open opportunity packages cannot contain retired forms |
| VAL-1423 |
This Package contains UEI forms; it cannot be updated to use the specified Template with DUNS forms |
Existing packages containing UEI forms can only specify a template containing UEI forms since new organizations may not have a DUNS number in SAM |
| VAL-1501 | Template Name is not unique within Grants.gov | Template Name must be unique within Grants.gov (regardless of case) Note: If same name is specified on an Update, no error |
| VAL-1502 | Form ID(s) {Form ID(s)} not found or retired | Form ID not found or retired |
| VAL-1503 | Form ID(s) {Form ID(s)} do not belong to the same form family as the Template | All forms in a template must belong to the same form family as the Template |
| VAL-1504 | SF-424 form must be included as the first mandatory form | Single-Project Templates must include the SF-424 form as a mandatory form and in first position |
| VAL-1505 | If you wish to include the SF-424 form, it must be the first mandatory or the first optional form | If SF-424 form is included in a Multi-Project Template, it must be either the first mandatory or the first optional form |
| VAL-1506 | Form ID(s) {Form ID(s)} are included in the Template more than once | A form ID can only be included once in a Template |
| VAL-1507 | Agency {Agency Code} does not have Multi-Project feature enabled and thus cannot set Template Type to "MultiProject" | Only the Agencies flagged as a Multi-Project Agency can create a Multi-Project Template or change a Template from Single to Multi-Project |
| VAL-1508 | Inactive Form ID(s) {Form ID(s)} are not allowed for a new template | A new Template can only include active form versions |
| VAL-1509 | Template not found | Template cannot be updated/deleted if it does not exist |
| VAL-1510 | Inactive Form ID(s) {Form ID(s)} cannot be included in a modified Template if not already in the original Template | Cannot include an inactive form version if not in the original Template |
| VAL-1511 | Inactive form version {Form ID} cannot be included with corresponding Active form version {Form ID} | If inactive form is included, no other version of the same form can be included in the Template (multiple error messages may occur if multiple forms in error) |
| VAL-1512 | Removing forms is the only allowed update to the list of forms when SF424 is inactive | If inactive SF424 is included, only allowed update to the list of forms is to remove forms |
| VAL-1513 | Updating to active SF424 requires all forms to be active | If updating SF424 from inactive to active, all forms in the Template must be active |
| VAL-1514 | Form ID(s) {Form ID(s)} have newer list of Countries and/or States, while Form ID(s) {Form ID(s)} have older list(s). Selected forms must use consistent lists | All forms in template must have the same Country and/or State Code lists |
| VAL-1515 | Form ID(s) {Form ID(s)} have UEI, while Form ID(s) {Form ID(s)} have DUNS. Selected forms must all use DUNS or all use UEI | All forms in template must either be DUNS forms or UEI forms |
| VAL-1601 | Opportunity relation already exists | Cannot add an Opportunity relationship that already exists |
| VAL-1602 | Opportunity relation not found | Cannot modify/remove an Opportunity relationship that does not exist, and both opportunities must be non-draft since S2S cannot currently retrieve draft opportunities |
| VAL-1603 | Cannot relate Opportunity to itself | Cannot relate Opportunity to itself |
The following list describes Grants.gov S2S Error Messages for all Web Services. They are returned when the Web Services fail for system errors.
| Error Code | Error Message |
|---|---|
| SYS-1001 | System Error occurred while executing the Web Service |
| SYS-1002 | Failed to retrieve certificate from the HTTPS request |
| SYS-1003 | Failed to load certificate account from LDAP server |
| SYS-1004 | Error retrieving Entity: {Entity} due to system error |
| SYS-1005 | Error creating Entity: {Entity} due to system error |
| SYS-1006 | Error updating Entity: {Entity} due to system error |
| SYS-1007 | Error deleting Entity: {Entity} due to system error |
| SYS-1008 | Error adding Entity: {Entity} due to system error |
| SYS-1009 | Error replacing Entity: {Entity} due to system error |
| SYS-1010 | Error removing Entity: {Entity} due to system error |
| SYS-1011 | Cannot save file contents due to system error |
| SYS-1012 | Cannot perform file virus scan due to system error |
| SYS-1013 | Cannot upload file to Grants.gov because it contains a virus |
| SYS-1014 | Failed to load Folder Zip data when attempting to delete Related Document file due to system error |
| SYS-1015 | Entity: {Entity} ID not found due to system error |
| SYS-1016 | Failed to validate Entity: {Entity} due to system error |