Approve
Approve
This endpoint will be applicable only if you’ve generated 1099-NEC forms using the ‘GenerateFromTxns’ method.
Once TaxBandits generates the draft 1099-NEC forms, you can use this endpoint to approve them. Once approved, you will be able to transmit the forms using the Transmit endpoint.
POST Form1099NEC/Approve Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| RecordIds | Guid[] | List of record Ids to get the Approved Form 1099-NEC. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| Form1099NECRecords | object | Contains Form 1099NEC records that are approved. |
| SuccessRecords | object[] | Contains detailed information of Form 1099 NECs that were successfully approved. |
| RecordId | string | Unique identifier of a record |
| Status | Guid | Status of the 1099-NEC. |
| StatusTs | Guid | Returns date and time of return created. |
| ErrorRecords | object[] | Contains the list of errors |
| PayeeRef | string | Unique identifier of the recipient. Set by the client. |
| RecipientId | Guid | Unique identifier of the recipient. Generated by TaxBandits. |
| 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 the detailed error information |
| Id | string | Validation error Id |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request JSON
{
"SubmissionId": "ed4eb5c4-cc6a-4b34-8253-ac326674fb41",
"RecordIds": [
"f53d6303-9d48-4ed8-8d4a-5b6713392e47",
"7d403f42-3533-41bd-9c9e-c2cb6f1cb365"
]
}
Response JSON
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "ed4eb5c4-cc6a-4b34-8253-ac326674fb41",
"Form1099NECRecords": {
"SuccessRecords": [
{
"RecordId": "f53d6303-9d48-4ed8-8d4a-5b6713392e47",
"Status": "CREATED",
"StatusTs": "2021-12-03 03:06:58 -05:00"
},
{
"RecordId": "7d403f42-3533-41bd-9c9e-c2cb6f1cb365",
"Status": "CREATED",
"StatusTs": "2021-12-03 03:06:58 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}