# AvaTax Brazil error handling

Source: https://developer.avalara.com/goods-calculation-en/errors/avatax_error_handling/

The table below describes the AvaTax Brazil error handling codes:

HTTP CODE

PAYLOAD ERROR CODE

DETAILS

ERROR MESSAGE

TAX TYPE

REASON

ACTION

HTTP 400

WC001

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS BENEFITS

ICMS, ICMS\_Inter

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Deferral

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Reduction

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_PartialExemption,

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_ST\_Reduction,

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Inter\_Deferral,

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_InterReduction,

Missing Tax Rule

Create Rule

HTTP 400

WC002

Payload Response: Line Warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Inter\_PartialExemption

Missing Tax Rule

Create Rule

HTTP 400

WC003

Payload Response: Line Warning

SCENARIO SUBJECT TO (TAX) BENEFITS

PIS,COFINS, PIS-IMP, COFINS-IMP.

Missing Tax Rule

Create Rule

HTTP 400

WC004

Payload Response: Line Warning

SCENARIO SUBJECT TO (TAX) BENEFITS

IPI, IPI-EXP

Missing Tax Rule

Create Rule

HTPP 400

WC005

Payload Response: Line Warning

SCENARIO SUBJECT TO (TAX) BENEFITS

II

Missing Tax Rule

Create Rule

HTTP 400

WC006

Payload Response: Line Warning

SCENARIO SUBJECT TO (TAX) BENEFITS

ANY Services Taxes

Missing Tax Rule

Create Rule

HTTP 400

WC100

Payload Response: Line Warning

SCENARIO SUBJECT TO (TAX) UNMAPPED BENEFITS

ANY Taxes

Missing Tax Rule

Create Rule

HTTP 400

TC000

Payload Response

Too Many Errors

ANY

Two o more errors per line

Resolve all erros

HTTP 400

TC001

Payload Response

Cannot find TaxCitation

ANY

Missing Citation for that calculation

Verify the Item Descriptor data, if is correct contact the Support

HTTP 400

TC002

Payload Response

We cannot find a TaxCode to resolve this conflict

ANY

We cannot calculate the line because the engine find two o more Citation applied for the same scenario

Verify the Item Descriptor data or Create Rule.

HTTP 400

TC003

Payload Response

Set a TaxCode rule for the Benefit

ANY

This scenario has only benefits and you don’t have any rule to use that benefit

Create Rule

HTTP 400

TC101

Payload Response

HS Code is missing.

Goods

Missing NCM

Inform the NCM on line.itemDescriptor.hsCode

HTTP 400

TC102

Payload Response

The service Code is missing.

Services ISS

Missing City Service Code

Inform the City Service Code on line.itemDescriptor.serviceCode

HTTP 401

A101

Payload Response

1Required Authenticator

N/A

Missing Authenticator

Add the Authorization on Header Request

HTTP 401

A103

Payload Response

1Invalid Authenticator

N/A

Authorization string is not Bearer

Use Bearer in Authenticator

HTTP 401

A104

Payload Response

1Invalid Token

N/A

The Token is invalid

Refresh or create a new Token

HTTP 403

A121

Payload Response

1Subscription is null

N/A

Token has no subscriptionId

Change the credentials to Subscription Token Type

HTTP 403

A301

Payload Response

1This account was disabled to access this endpoint.

N/A

The endpoint is disabled for that subscription

Contact the support

HTTP 426

A401

Payload Response

1I only allow 1000 errors on requests logged for users. 2Try again soon (10 minutes).

N/A

More the 1000 errors for the same request

Fix the request or wait 10 minutes.