GenerateFromTxns

By using the Form1099Transactions endpoint, you can record the payouts and transactions made to the vendors throughout the year. Based on these data, the applicable 1099 forms for the vendors can be generated.

There are three ways available to generate 1099 forms:

• TaxBandits UI: You can access TaxBandits UI (https://secure.taxbandits.com/login) to generate 1099 forms on your own based on the transactions recorded. You can use your Developer Console credentials to log in. Click here to see how it works

• Auto-generate: You can submit your request to have TaxBandits generate 1099s automatically for you based on the transactions recorded. Once generated, you can review the forms and provide your approval.

• GenerateFromTxns: As an alternative to the above two methods, you can use this endpoint to generate the 1099 forms.

To Generate 1099-NEC using GenerateFormTxns:

You must send a request to this endpoint with the business IDs and recipient IDs. In response, a SubmissionID/RecordIDs will be generated, which can be further used as a reference for all other methods of the 1099-NEC API.

Based on the transactions recorded, the 1099-NEC Forms will be generated for the respective businesses.

POST Form1099NEC/GenerateFromTxns 

Request Body

Field	Type	Description
TaxYear	string	Tax year of Form 1099-NEC to be filed. Allowed values: "2021"
Business	object	Payer Information. Either PayerRef, BusinessId or TIN is mandatory.
PayerRef	string	Unique identifier of the payer. Set by the client.
BusinessId	Guid	Unique identifier of the payer. Generated by TaxBandits.
TINType	string	TIN Type of the business. Allowed values: "SSN", "EIN"
TIN	string	Taxpayer Identification Number of the business. Size Range: 9
Recipients	object[]	Recipient Information.
PayeeRef	string	Unique identifier of the recipient. Set by the client. Size Range: 4..20
RecipientId	Guid	Unique identifier of the recipient. Generated by TaxBandits.

Request JSON

{
 "TaxYear": "2021",
 "Business": {
   "PayerRef": "1473",
   "BusinessId": null,
   "TINType": null,
   "TIN": null
 },
 "Recipients": [
   {
     "PayeeRef": "2a-ed6789896",
     "RecipientId": "87626E20-75B2-4CB5-A2AC-B65C0105FA5C"
   },
   {
     "PayeeRef": "Alex9608912",
     "RecipientId": "A6316079-C3F9-4AAD-BA99-6DF71F635AD3"
   }
 ]
}

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
BusinessId	Guid	TaxBandits Unique Business Identifier.
PayerRef	string	Unique identifier of the payer. Set by the client in the endpoint Business/RequestByUrl.
Form1099NECRecords	object	Lists the 1099-NEC forms generated
SuccessRecords	object[]	It will show the detailed information about the 1099-NEC forms generated.
PayeeRef	string	Unique identifier of the recipient. Set by the client.
NoOf1099	number	Shows the number of 1099NECs generated.
RecipientId	Guid	An unique identifier of the recipient. Generated by TaxBandits
RecordId	Guid	An unique identifier of the 1099-NEC form generated by TaxBandits. Use this as a future reference to Approve, Update, Delete and Transmit.
FederalReturn	object	Federal return information
Status	string	Federal return status.
StatusTs	string	Status timestamp.
Info	string	Additional information of the Federal return (If any)
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 ofthe 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": "8f5c57ec-5c9e-4dee-a650-e79eeb087e4c",
 "BusinessId": "1cc352d4-6d91-4fd5-a886-7b59b9fbe2e8",
 "PayerRef": "1473",
 "NoOf1099": "2",
 "Form1099NECRecords": {
   "SuccessRecords": [
     {
       "PayeeRef": "2a-ed6789896",
       "RecordId": "5ef596cc-70e2-4258-885c-e5e18d48fa70",
       "RecipientId": "87626E20-75B2-4CB5-A2AC-B65C0105FA5C",
       "NECBox1": "10000",
       "NECBox4": "2000",
       "FederalReturn": {
         "Status": "CREATED",
         "StatusTs": "2021-10-14 10:58:19 +05:30",
         "Info": null
       }
     },
     {
       "PayeeRef": "Alex9608912",
       "RecordId": "5ef596cc-70e2-4258-885c-e5e18d48ff78",
       "RecipientId": "A6316079-C3F9-4AAD-BA99-6DF71F635AD3",
       "NECBox1": "10000",
       "NECBox4": "2000",
       "FederalReturn": {
         "Status": "CREATED",
         "StatusTs": "2021-10-14 10:58:19 +05:30",
         "Info": null
       }
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}