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

Amount

created

Form 1099 is created – this is the default status

Any other amount not listed below

pending

Form 1099 has started the filing process with the tax authority

111

done

Successful Form 1099 filing

222

error

message: "userError".

333

error

message: "payerError"

444

error

message: "documentError"

555

error

message: "filingError"

666

error

message: "stateError"

777

verifying

Form 1099 has started the SSN verification process

888

error

message: "ssnVerificationError"

999


Did this page help you?