Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

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

FieldTypeDescription
TaxYearstringTax year of Form 1099-NEC to be filed.
Allowed values: "2021"
Businessobject[]Payer 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"
    TINstringTIN Type of the business.
Size Range: 9-11
Recipientsobject[]Recipient Information.
    PayeeRefstringUnique identifier of the recipient. Set by the client.
Size Range: 4..20
    RecipientIdGuidUnique identifier of the recipient. Generated by TaxBandits.

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

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
}