> This page is for Documentation, version Integration guides (default).
> For other versions, use one of these documentation indexes:
> - Integration guides (default): https://avalara.ferndocs.com/docs/integration-guides/llms.txt
> - Refactor guides: https://avalara.ferndocs.com/docs/refactor-guides/llms.txt
> - Get certified: https://avalara.ferndocs.com/docs/get-certified/llms.txt
> - Agent to Agent (A2A): https://avalara.ferndocs.com/docs/agent-to-agent-a2a/llms.txt
> - AI use cases: https://avalara.ferndocs.com/docs/ai-use-cases/llms.txt
> - API versioning: https://avalara.ferndocs.com/docs/api-versioning/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://avalara.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://avalara.ferndocs.com/_mcp/server.

# FAQs

Guide: Brasil Returns (Tax compliance) - Portuguese

Abaixo estão as respostas para perguntas comuns que os usuários enfrentam ao integrar ***Returns Brasil***.

Qual é o nosso tipo de API?

REST API.

Aceitamos arquivos XML ou apenas modelo de arquivo JSON?

Somente modelos de arquivo JSON são aceitos.

Qual é a diferença entre os ambientes Sandbox e Produção?

O ambiente sandbox está disponível para que o parceiro tenha um ambiente onde possa realizar testes e simular operações na hora do projeto e antes do go-live. Portanto, não há diferenças técnicas entre os ambientes, com exceção da fonte de dados.

Posso usar minhas credenciais no Sandbox e na Produção?

Não, as credenciais são exclusivas para cada ambiente.

Quais métodos de autenticação são suportados?

O método de autenticação compatível é a autenticação de token do portador OAuth 2.0.

Qual é a URL da sandbox?

[https://portal.sandbox.avalarabrasil.com.br/Login](https://portal.sandbox.avalarabrasil.com.br/Login)

Quem devo contatar se meu sandbox tiver expirado?

Se o seu sandbox expirou, você deve entrar em contato com a equipe de Lançamento de parceiros (Partner Launch) do Brasil.

Como posso confirmar se o serviço está ativo?

[https://api-gateway.sandbox.avalarabrasil.com.br/portal/health](https://api-gateway.sandbox.avalarabrasil.com.br/portal/health)

O que você pode fazer se o seu “Token Secreto” for exposto?

Se o seu  “`token secreto`” foi exposto é possível revogá-lo através do Portal Avara.

1. Selecione o token que será revogado e clique em "`revogar`" para revogar o token.
2. Selecione “`confirmar`” para confirmar a operação.

O que devo fazer se perder meu “Token Secreto”?

Se você não salvou seu “`token secreto`” em um lugar seguro e o perdeu, você deve revogar seu token e criar um novo.

Como posso obter meu “ID de cliente”?

Você pode acessar seu ID de cliente de duas maneiras diferentes.

* Quando você cria seu token secreto, seu ID de cliente é mostrado.
* Você também pode encontrar seu ID de cliente na `na assinatura` e em `infomações da assinatura`.

O que acontece se eu enviar a solicitação JSON SEM “disableTokenRefresh”?

Você receberá um "`refresh_token`" na resposta.

O que acontecerá se eu enviar a solicitação JSON COM “disableTokenRefresh” definido como “true”?

Você não receberá o "`refresh_token`" na resposta e será necessário enviar as credenciais novamente após a sessão expirar.

[Anterior](https://developer.avalara.com/extractor-pt/revisao_funcional/etapa_final)

> **Note**
>
> Part of the **Extractor guide (Portuguese)** integration guide. [Open the full "FAQs" milestone on Avalara](https://developer.avalara.com/products/tax-compliance/integration-guides/extractor-pt/faqs/) to see every page in this section.