Validate
Runs business and data validation checks for the 940 forms already created in API. You must use the Submission ID of the return to Validate.
GET Form940/Validate
Request Params
Field | Type | Description |
---|---|---|
SubmissionId | string | Unique identifier of a submission |
RecordIds | string | List of record Ids to be transmitted. |
Request Params
"Form940/Validate?SubmissionId=8129c446-dedd-4b40-befb-0ce0ae4f0678&RecordIds=91b4df85-dc32-4b0c-b4db-b47838882cb3"
Response Body
Field | Type | Description |
---|---|---|
StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
StatusName | string | Name of the status code. |
StatusMessage | string | Detailed status message. |
SubmissionId | Guid | Unique identifier of a submission. |
Form940Records | object | Pulls the Form 940 records with Success and Error statuses. |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 940 Records. |
Sequence | string | A unique number given by an inbound application to identify failed records. |
RecordId | Guid | Unique identifier of a record. |
RecordStatus | string | Returns the status of the records. |
CreatedTs | string | Date and time of return created. |
UpdatedTs | string | Date and time of return updated. |
ErrorRecords | object[] | It will show the detailed information about the error status of Form 940 Records |
RecordId | Guid | Unique identifier of a record. |
Sequence | string | A unique number given by an inbound application to identify failed records. |
Errors | object[] | Shows detailed error information. |
Code | string | Returns the validation error code. |
Name | string | Name of the validation error. |
Message | string | Description of the validation error. |
Type | string | Type of validation error. |
Errors | object[] | Shows detailed error information. |
Code | string | Returns the validation error code. |
Name | string | Name of the validation error. |
Message | string | Description of the validation error. |
Type | string | Type of validation error. |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "8129c446-dedd-4b40-befb-0ce0ae4f0678",
"Form940Records": {
"SuccessRecords": [
{
"Sequence": "",
"RecordId": "91b4df85-dc32-4b0c-b4db-b47838882cb3",
"RecordStatus": "Created",
"CreatedTs": "2019-08-06 01:09:55 -04:00",
"UpdatedTs": "2019-08-06 01:21:28 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}