# Planejando sua integração

Source: https://developer.avalara.com/merchandise-calculation-pt/como_comecar/planejando_integracao/

Esta seção fornece uma visão geral dos requisitos do selo _Cálculo de Mercadoria_ necessário para se tornar um parceiro certificado. Revise esta seção para ajudá-lo a planejar sua integração.

**Aviso:** Antes de iniciar a sua integração, é importante definir o tipo de operação principal e o tipo de uso coberto durante o programa de certificação.

[![Closed](https://avalara-devdocs-prod.mcoutput.com/merchandise-calculation-pt/Skins/Default/Stylesheets/Images/transparent.gif)Telas administrativas e melhores práticas](javascript:void\(0\);)

A tabela abaixo apresenta 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

Requerimentos

Notas

Nível

Obrigatório

Tela de configuração

De acordo com as melhores práticas, é desejável ter uma tela de configurações para as credenciais, conforme listado abaixo:

-   Token ID do cliente

-   Secret Token

UI

Obrigatório

Teste de autenticação de conexão - Serviço Health (PING)

Existe um método disponível para verificação de estabilidade do serviço/PING

UI

Obrigatório

Habilitar/Desabilitar a utilização dos serviços

O usuário poderá habilitar/desabilitar os serviços AvaTax a qualquer momento. É indicada a criação de uma flag para operacionalizar isso

UI

Obrigatório

Serviços de Log Compreensivos

Dado que todas as transações são baseadas em solicitação e resposta de JSON, os parceiros deverão providenciar logs dessas transações, caso seja necessário a verificação de dados ou cálculos. Fica a critério do parceiro definir o tempo de permanência desses dados no sistema

UI

Obrigatório

Selecionar opções de ambiente

Fornecer opção de ambiente para permitir que o usuário-chave possa alternar entre os ambientes de sandbox e ambiente de produção

UI

Obrigatório

Verificação de ambiente

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

UI

Sugerido

Configuração de Tempo de Expiração da Chamada

Configurar um tempo de expiração para cada chamada realizada pela API (timeout)

Configuração oculta

Obrigatório

API base URL

As URLs devem ser configuráveis

Configuração oculta

Obrigatório

Versão

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

Documentação

Obrigatório

Arquitetura

Fornecer informações sobre a arquitetura do conecotor, bem como os pré-requisitos necessários para seu funcionamento

Documentação

[![Closed](https://avalara-devdocs-prod.mcoutput.com/merchandise-calculation-pt/Skins/Default/Stylesheets/Images/transparent.gif)Cenários para vendas](javascript:void\(0\);)

A tabela abaixo descreve os requisitos e sugestões para as transações de vendas.

Obrigatório/ Sugerido

Cenário

Tipo da transação

Sugerido

Operação de zona franca

Venda

Sugerido

Pauta

Venda

Sugerido

Venda para Simples Nacional

Venda

Obrigatório

Venda interestadual para contribuinte do ICMS

Venda

Obrigatório

Venda interestadual para não contribuinte do ICMS

Venda

Obrigatório

Venda dentro do Estado

Venda

Sugerido

Venda simples faturamento

Venda

Obrigatório

Fatura de venda complementar

Venda

Sugerido

Exportação de mercadoria

Venda

Sugerido

Nota fiscal complementar de venda

Venda

Sugerido

Remessa para feiras/demonstrações

Remessa

Sugerido

Remessa simples de faturamento

Remessa

Sugerido

Transferência entre matriz e filiais

Transferência

Sugerido

Devolução total de saída

Devolução

Sugerido

Devolução parcial de saída

Devolução

[![Closed](https://avalara-devdocs-prod.mcoutput.com/merchandise-calculation-pt/Skins/Default/Stylesheets/Images/transparent.gif)Cenários para compras](javascript:void\(0\);)

A tabela abaixo descreve os requisitos e sugestões para as transações de compra.

Obrigatório/ Sugerido

Cenários

Transações

Sugerido

Remessa simples faturamento

Remessa

Sugerido

Remessa para feiras/demonstrações

Remessa

Sugerido

Devolução parcial de entrada

Devolução

Sugerido

Devolução total de saída

Devolução

Sugerido

Compra de Simples Nacional

Compra

Obrigatório

Compra Interestadual

Compra

Obrigatório

Compra dentro do estado

Compra

Obrigatório

Compra de transporte

Compra

Sugerido

Importação de mercadorias

Compra