Skip to main content
Version: 1.7.3

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 
Run in Postman

Request Body

FieldTypeDescription
TaxYearstringTax year of Form 1099-NEC to be filed.
Allowed values: "2022","2023"
BusinessobjectPayer Information. Either PayerRef, BusinessId or TIN is mandatory.
    PayerRefstringUnique identifier of the payer. Set by the client.
    BusinessIdGuidUnique identifier of the payer. Generated by TaxBandits.
    TINTypestringTIN Type of the business.
Allowed values: "SSN", "EIN"
    TINstringTaxpayer Identification Number of the business.
Size Range: 9
Recipientsobject[]Recipient Information.
    PayeeRefstringUnique identifier of the recipient. Set by the client.
Size Range: 4..20
    RecipientIdGuidUnique identifier of the recipient. Generated by TaxBandits.

Request JSON

{
"TaxYear": "2023",
"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

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission.
BusinessIdGuidTaxBandits Unique Business Identifier.
PayerRefstringUnique identifier of the payer. Set by the client in the endpoint Business/RequestByUrl.
Form1099NECRecordsobjectLists the 1099-NEC forms generated
    SuccessRecordsobject[]It will show the detailed information about the 1099-NEC forms generated.
        PayeeRefstringUnique identifier of the recipient. Set by the client.
        NoOf1099numberShows the number of 1099NECs generated.
        RecipientIdGuidAn unique identifier of the recipient. Generated by TaxBandits
        RecordIdGuidAn unique identifier of the 1099-NEC form generated by TaxBandits. Use this as a future reference to Approve, Update, Delete and Transmit.
        FederalReturnobjectFederal return information
            StatusstringFederal return status.
            StatusTsstringStatus timestamp.
            InfostringAdditional information of the Federal return (If any)
    ErrorRecordsobject[]Contains the list of errors
        PayeeRefstringUnique identifier of the recipient. Set by the client.
        RecipientIdGuidUnique identifier of the recipient. Generated by TaxBandits.
        Errorsobject[]Shows detailed error information
            IdstringReturns the validation error Id
            NamestringName of the validation error
            MessagestringDescription ofthe validation error
Errorsobject[]Shows the detailed error information
    IdstringValidation error Id
    NamestringName of the validation error
    MessagestringDescription of the validation error

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
}