Skip to main content
Avalara Help Center

Fix CertCapture API errors

This article applies to:Avalara CertCapture

CertCapture sends exemption certificate data to AvaTax via an API call. If there are issues with the customer or certificate data that prevent the API call from being sent, you'll see an error on the History tab of the exemption certificate in CertCapture. Here are some common errors messages you may see, and the ways to resolve those errors.

Before you begin

To see a full list of the API errors on all certificates, generate a Failed API Calls report. 

Common API errors

Error message Steps to resolve
Reason Code X is not exempt in region(s): XX. (Invalid ExemptReasonId and region combination) The exemption reason is not valid for the regions listed in the error message. See the Exempt reason matrix for the US and Canada to find which exemption reasons are valid for each region. To change the exemption reason, go to the Details tab of the certificate and select Edit.
Certificate exempt reason does not exist in AvaTaxCalcApi. The exemption reason isn't available in AvaTax. See the List of Entity/Use Codes guide for the full list of exemption reasons available in AvaTax. To change the exemption reason, go to the Details tab of the certificate and select Edit.
DocumentRefNo is required. (This value must be specified.) The exemption certificate is a Single Use certificate, but does not have a Certificate PO Number. To resolve this, go to the Details tab of the certificate and select Add PO Number.
CustomerName is required. (This value must be specified.) The Customer Name field is blank for one of the customers linked to the certificate. Go to the Customers tab of the certificate to view all of the linked customers, and add a Customer Name for any customers without one. Next, go to the Details tab of that customer and select Edit to enter the customer name.
The certificate customer(customer number) does not contain an address. The Address 1 field is blank for the customers listed in the error message. Go to Details tab for that customer and select Edit to enter the street address.
The certificate customer(customer number) does not contain a city. The City field is blank for the customers listed in the error message. Go to Details tab for that customer and select Edit to enter the city name.
Region is required. (This value must be specified.) The Region field is blank for a customer linked to the certificate. Go to the Customers tab of the certificate to view all of the linked customers to find any customers without a state in the address. Next, go to the Details tab of that customer and select Edit to enter the state.
The certificate customer(customer number) does not contain a zip. The ZIP field is blank for the customer numbers listed in the error message. Go to the Details tab for that customer and select Edit to enter the ZIP code.
The certificate customer(customer number) is not associated to a country. The Country field is blank for the customer numbers listed in the error message. Go to the Details tab for that customer and select Edit to enter the country.
Certificate record could not be found or did not meet send credentials. The Effective Date of the certificate is a date in the future. If the certificate is intentionally future-dated, you don't need to do anything. A new API call will be sent on the selected effective date. If you do want to adjust the effective date, go to the Details tab of the certificate and click Edit.
  • Was this article helpful?