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
}