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. |
Request JSON
{
"SubmissionId": "ed4eb5c4-cc6a-4b34-8253-ac326674fb41",
"RecordIds": [
"f53d6303-9d48-4ed8-8d4a-5b6713392e47",
"7d403f42-3533-41bd-9c9e-c2cb6f1cb365"
]
}
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 |
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
}