Errors and Testing 1099 Documents in Sandbox

Form 1099 documents will not be filed to the tax authority in your sandbox environment, so it’s the best way to test your integration before going to production. You can force a 1099 document to resolve to a specific status in your sandbox environment to test various scenarios by passing the federalIncomeTaxWithheld specified in the table below. This is especially useful when testing Webhooks for different statuses.

For example, if you want to test a Form 1099 in which the final status = "error" and message = "userError", you would create a Form 1099 with federalIncomeTaxWithheld = 333.

Status

Description

Testing Values

created

Form 1099 is created – this is the default status

Any other amount not listed below

verifying

Form 1099 has started the SSN verification process

888

pending

Form 1099 has started the filing process with the tax authority

111

done

Successful Form 1099 filing

222

error

message: "userError". A field is not correct for the user provided. Update and try again.

333

error

message: "payerError". A field is not correct for the payer provided. Update and try again.

444

error

message: "documentError". A field is not correct or is missing from the required document fields. Update and try again.

555

error

message: "irsFilingError". An error occurred during filing. Please contact Abound.

666

error

message: "stateFilingError". An error occurred during filing. Please contact Abound.

777

error

message: "ssnVerificationError". The SSN of the User or the TIN of the payer provided was invalid. Update the SSN and try again.

999


Did this page help you?