# AvaTax Brazil error handling

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

# AvaTax Brazil error handling

Use these AvaTax Brazil error codes to identify issues and determine how to resolve them.

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 a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Deferral

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Reduction

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_PartialExemption

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_ST\_Reduction

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Inter\_Deferral

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_InterReduction

Missing tax rule.

Create a rule.

HTTP 400

WC002

Payload response, line warning

SCENARIO SUBJECT TO ICMS DEFERRAL BENEFITS

ICMS\_Inter\_PartialExemption

Missing tax rule.

Create a rule.

HTTP 400

WC003

Payload response, line warning

SCENARIO SUBJECT TO (TAX) BENEFITS

PIS, COFINS, PIS-IMP, COFINS-IMP

Missing tax rule.

Create a rule.

HTTP 400

WC004

Payload response, line warning

SCENARIO SUBJECT TO (TAX) BENEFITS

IPI, IPI-EXP

Missing tax rule.

Create a rule.

HTTP 400

WC005

Payload response, line warning

SCENARIO SUBJECT TO (TAX) BENEFITS

II

Missing tax rule.

Create a rule.

HTTP 400

WC006

Payload response, line warning

SCENARIO SUBJECT TO (TAX) BENEFITS

Any services taxes

Missing tax rule.

Create a rule.

HTTP 400

WC100

Payload response, line warning

SCENARIO SUBJECT TO (TAX) UNMAPPED BENEFITS

Any taxes

Missing tax rule.

Create a rule.

HTTP 400

TC000

Payload response

Too many errors

Any

2 or more errors per line.

Resolve all errors.

HTTP 400

TC001

Payload response

Cannot find TaxCitation

Any

Missing citation for that calculation.

Verify the item descriptor data. If it's correct, contact Support.

HTTP 400

TC002

Payload response

We cannot find a TaxCode to resolve this conflict

Any

The engine found 2 or more citations applied to the same scenario, so it can't calculate the line.

Verify the item descriptor data or create a rule.

HTTP 400

TC003

Payload response

Set a TaxCode rule for the Benefit

Any

The scenario has only benefits and you don't have any rule to use that benefit.

Create a rule.

HTTP 400

TC101

Payload response

HS Code is missing.

Goods

Missing NCM.

Provide the NCM in line.itemDescriptor.hsCode.

HTTP 400

TC102

Payload response

The service Code is missing.

Services ISS

Missing city service code.

Provide the city service code in line.itemDescriptor.serviceCode.

HTTP 401

A101

Payload response

1 Required Authenticator

N/A

Missing authenticator.

Add the authorization in the request header.

HTTP 401

A103

Payload response

1 Invalid Authenticator

N/A

Authorization string isn't Bearer.

Use a Bearer token in the authenticator.

HTTP 401

A104

Payload response

1 Invalid Token

N/A

The token is invalid.

Refresh or create a new token.

HTTP 403

A121

Payload response

1 Subscription is null

N/A

The token has no `subscriptionId`.

Change the credentials to a subscription token type.

HTTP 403

A301

Payload response

1 This account was disabled to access this endpoint.

N/A

The endpoint is disabled for that subscription.

Contact Support.

HTTP 426

A401

Payload response

1I only allows 1,000 errors on requests logged for users. 2 Try again soon (10 minutes).

N/A

More than 1,000 errors for the same request.

Fix the request or wait 10 minutes.