GenerateFromTxns

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 will generate Form 1099-NECs for the given BusinessID and RecipientIDs based on the transactions reported. 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.

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	TIN Type of the business. Size Range: 9-11
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.

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-NECs 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

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 JSON

{
 "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
}