Approve

If you are using TaxBandits API to send Transactions and then generate 1099s using the transactions data, then this endpoint will be applicable to you. This endpoint is used to approve the draft 1099-NEC forms generated by TaxBandits. Once the returns are approved you will be able to transmit these 1099-NEC using the Transmit method of the 1099-NEC API.

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
}