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}