# Planejando sua integração

Source: https://developer.avalara.com/products/tax-compliance/integration-guides/extractor-pt/como_comecar/planejando_sua_integracao/

Guide: Brasil Returns (Tax compliance) - Portuguese

# Planejando sua integração

Esta seção fornece uma visão geral dos requisitos do selo Brasil Returns que você precisa atender para se tornar um parceiro certificado.

O selo para extratores certifica os conectores que extraem dados do ERP e os enviam por meio de API para informar as obrigações fiscais para as autoridades brasileiras.

Ter um extrator certificado torna o processo de implantação mais fácil e ágil, reduzindo significativamente o tempo do projeto.

Revise esta seção para ajudá-lo a planejar sua integração.

Administração e utilidades

Abaixo, você encontrará uma lista de requisitos que abrangem, desde a experiência do usuário, até as melhores práticas recomendadas da aplicação.

**Obrigatório/ Sugerido**

**Casos de Uso**

**Notas**

**Nível**

Obrigatório

Configurar credenciais Avalara

Deve existir uma interface que permita ao usuário a entrada de credenciais Avalara, incluindo:

-   Token ID do cliente
-   Secret Token

UI

Obrigatório

Teste de autenticação - Health service (PING)

Existe um método disponível para disponibilidade de serviço/PING

UI

Obrigatório

Ativar/Desativar a utilização do serviço

Deve ser possível ao usuário habilitar ou desabilitar o serviço a qualquer momento. O sinalizador indicará que o serviço está operacional

UI

Obrigatório

Logging abrangente

Como todas as transações são baseadas em JSON de solicitação/resposta, o conector deve fornecer logs dessas transações para solução de problemas, se necessário. Os parceiros podem definir o tempo necessário para manter esses dados no sistema

UI

Obrigatório

Selecione a opção de ambiente

Fornecer opção de ambiente para permitir que o usuário-key alterne entre sandbox e ambiente de produção

UI

Obrigatório

Verificação de ambiente

Fornecer evidências que demonstrem em qual ambiente (produção ou sandbox) o cliente/parceiro está operando

UI

Obrigatório

Extração

Os extratores devem garantir que todos os documentos relevantes para um correto cálculo de imposto e relatório fiscal foram selecionados

Aplicação

Obrigatório

Extração

Os extratores devem ter um mecanismo para garantir o controle do que já foi extraído

Aplicação

Sugerido

Definir o tempo limite para chamadas de API

Definir um tempo limite para a chamada da API, conforme recomendado pelas melhores práticas. 

Hide  configuration

Obrigatório

URL base da API

As URLs devem ser configuráveis

Hide  configuration

Obrigatório

Versão

Informar a compatibilidade da versão do ERP com o conector

Documentação

Obrigatório

Arquitetura

Informar a arquitetura do conector, bem como pré-requisitos para o pleno funcionamento da operação 

Documentação

### Principais transações

Abaixo listamos as principais transações que precisam ser concluídas para obter a certificação. No entanto, transações adicionais podem ser exigidas de acordo com o tipo de negócio, dada a complexidade do universo tributário brasileiro.

Extratores fiscais

Documentos fiscais de entrada para mercadoria (Modelo 55)

Obrigatório

Documentos fiscais de saída para mercadoria (Model 55)

Obrigatório

Documentos Fiscais de Serviços Tomados

Se aplicável (Modelo SV)

Documentos Fiscais de Serviços Prestados

Se aplicável (Modelo SV)

Documentos Fiscais - Conhecimento de Transporte - CT-e (Model 57)

Se aplicável

Extratores de contabilidade

Plano de contas (COA)

Obrigatório

Conta contábil

Obrigatório

Centro de custo

Se aplicável

Histórico padrão de lançamento

Se aplicável

Código de aglutinação

Se aplicável

Participante acionário

Se aplicável

Lançamento contábil

Obrigatório

Saldo contábil

Obrigatório

Código de aglutinação por centro de custo

Se aplicável

Conta referencial

Se aplicável

Transações de Inventário / Saldos

Saldo de inventário

Se aplicável

[Anterior](/extractor-pt/como_comecar/sobre_o_programa)

[Próxima](/extractor-pt/como_comecar/recursos/recursos_adicionais)