Transmit
Transmit the Form 1099-NEC return to the IRS to file your non-employee remuneration. Transmit method should be called only after all the validation errors are cleared. Else, check for the errors and clear them.
Note that, after transmitting the form 1099-NEC, it cannot be edited or deleted.
POST Form1099NEC/Transmit
Request Body
Field | Type | Description |
---|---|---|
SubmissionId | Guid | Unique identifier of a submission |
RecordIds | Guid[] | An unique identifier generated by TaxBandits when a 1099-NEC return is created. Mention the 1099-NEC return's Record ID that you want to transmit. |
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 |
Form1099Records | object | Pulls the Form 1099 NEC records with Success and Error statuses |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 1099 NEC Records |
SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
RecordId | Guid | Unique identifier of a record |
Status | string | Returns the status of the records. |
StatusTs | string | Date and Time of the Return Transmission |
ErrorRecords | object[] | It will show the detailed information about the error status of Form 1099 NEC Records. |
SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
RecordId | Guid | Unique identifier of a record |
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 |
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 |
Request JSON: Give the SubmissionId and RecordId for the return that has to be transmitted.
{
"SubmissionId": "e88e7f1d-7ae5-43b6-99f6-38d85664035a",
"RecordIds": [
"63f0aaf2-7b35-487d-a003-0be8b522ef47"
]
}
Response JSON: The given record is now transmitted, and the RecordStatus will change to “Transmitted”.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "e88e7f1d-7ae5-43b6-99f6-38d85664035a",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "63f0aaf2-7b35-487d-a003-0be8b522ef47",
"Status": "Transmitted",
"StatusTs": "2021-08-23 02:02:19 -04:00",
"StateReturns": [
{
"StateCode": "WV",
"RecordStatus": "Transmitted"
},
{
"StateCode": "ID",
"RecordStatus": "Transmitted"
}
]
}
],
"ErrorRecords": null
},
"Errors": null
}