DownloadForm8879EMP

If you are an ERO (Electronic Return Originator) filing Form 941 on behalf of a client (recipient), the client must sign Form 941. This can be done using Form 8879EMP.

You can use this endpoint to download the 8879EMP Form (with reference to the RecordId) and send it to the client. The client, in turn, will sign the form and return it to you.

note

In order to use this endpoint, you must have specified the Signature Type as “ERO” in the Create request of Form 941.

The response will return the PDF in a byte array encoded in base64 in the response. You'll need to convert this byte array to a PDF file format. Below is an example code snippet for reference.

GET Form941/DownloadForm8879EMP  

Request Params

Field	Type	Description
RecordId	Guid	Unique identifier of a record.

Request Params

To download the Form 8879 EMP, provide the RecordId of the specific record.

"Form941/DownloadForm8879EMP?RecordId=eed7cf65-088e-4eba-800a-dcd54c0d05bb"

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.
RecordId	Guid	Unique identifier of a record
Form8879EMPPdf	byte[]	Pulls the byte array of Form-8879 pdf records with Success and Error status
Errors	object[]	Shows detailed error information.
Id	string	Returns the validation error id.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Response JSON

After verifying the RecordId, Form 8879 EMP will be downloaded.

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "RecordId": "eed7cf65-088e-4eba-800a-dcd54c0d05bb",
 "Form8879EMPPdf": "QEA",
  "Errors": null
}