Status
Gets the status of the 940SCHR returns by Submission Id and Record Ids.
GET Form940SchR/Status
Request Body
Field | Type | Description |
---|---|---|
SubmissionId | string | Unique identifier of a submission |
RecordIds | string | List of record Ids to get status. |
ReturnType | string | Type of the return to be filed. Enter values like FORM940, FORM940PR, FORM940SS, FORM940SCHR |
EIN | string | Employer Identification Number |
TaxYear | string | The Tax year for which Form 940/940 SCH R needs to be filed. |
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 |
Form940SchRRecords | object | Pulls the Form 940SCHR 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. |
    ClientSuccessRecords | object[] | Client Success Status. |
      CSeqId | string | This identifies the sequence on the record sent in the pay load. When errors occur we will send the errors attached to particular sequence. |
      CRecordId | string | Client Record Identifier |
      RecordStatus | string | Return status details like Processing, Created, Accepted, Rejected. |
      CreatedTs | string | Return created date and time |
      UpdatedTs | string | Return updated date and time |
  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. |
    ClientErrorRecords | object[] | Client Error Status. |
      CSeqId | object[] | This identifies the sequence on the record sent in the pay load. When errors occur we will send the errors attached to particular sequence. |
      CRecordId | object[] | Client Record Identifier |
      Errors | object[] | It will show the detailed information about the error. |
        Code | string | It will return the validation error code. |
        Name | string | It will return the name of the validation error. |
        Message | string | It will return the detailed message of the validation error. |
        Type | string | It will show the type of an 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. |
Request JSON
Form940SCHR/Status?SubmissionId=9723f666-c46e-43e6-8c56-8cba391acbf7&RecordIds=554fb9c3-b68b-4a52-9114-792cd4a70433&EIN=007820414&TaxYear=2018
Response JSON
{ "StatusCode": 200, "StatusName": "Ok", "StatusMessage": "Successful API call", "SubmissionId": "9723f666-c46e-43e6-8c56-8cba391acbf7", "Form940SchRRecords": { "SuccessRecords": [ { "Sequence": "", "RecordId": "554fb9c3-b68b-4a52-9114-792cd4a70433", "RecordStatus": "Created", "CreatedTs": "2019-08-07 02:59:41 -04:00", "UpdatedTs": "2019-08-07 03:24:00 -04:00", "ClientSuccessRecords": null } ], "ErrorRecords": null }, "Errors": null}