Brasil¶
Introdução¶
Com a localização brasileira, você pode calcular automaticamente os impostos sobre vendas de mercadorias usando o AvaTax (Avalara) através de chamadas de API, além de poder também configurar impostos para serviços.
Para o cálculo do imposto sobre mercadorias e o processo de faturamento eletrônico, é necessário configurar os contatos, a empresa e os produtos e criar uma conta no AvaTax nas configurações gerais do Odoo.
Os impostos sobre serviços podem ser criados e configurados diretamente do Odoo, sem calculá-los com o AvaTax.
A localização também inclui impostos e um modelo de plano de contas que pode ser modificado, se necessário.
Configuração¶
Instalação de módulos¶
Instale os seguintes módulos para obter todos os recursos da localização brasileira:
Nome |
Nome técnico |
Descrição |
---|---|---|
Financeiro - Brasil |
|
Padrão pacote de localização fiscal - adiciona características contábeis para a localização brasileira, que representam a configuração mínima necessária para uma empresa operar no Brasil. A instalação do módulo carrega automaticamente: o plano de contas, os impostos e os campos necessários para configurar adequadamente o contato. |
Brasil - Relatórios financeiros |
|
Adiciona um relatório fiscal simples que ajuda a verificar o valor do imposto por grupo fiscal em um determinado período de tempo. Também adiciona o P&L e o BP adaptados para o mercado brasileiro. |
Avatax Brasil |
|
Adicione o cálculo de impostos brasileiros pelo Avatax e todos os campos necessários para configurar o Odoo para usar o Avatax adequadamente e enviar as informações fiscais necessárias para levantamento dos impostos corretos. |
Avatax para PVs no Brasil |
|
Igual ao módulo |
Configurar sua empresa¶
Para configurar as informações da sua empresa, acesse o aplicativo
e pesquise o nome dado à sua empresa.Selecione a opção Empresa na parte superior da página. Em seguida, configure os seguintes campos:
Nome
Endereço (adicione Cidade, Estado, Código postal, País).
ID fiscal (CNPJ)
IE (Registro estadual).
IM (Registro municipal).
Código SUFRAMA (Superintendência da Zona Franca de Manaus - adicionar se aplicável).
Telefone.
E-mail.
Configure as Informações fiscais na aba:guilabel:
Vendas e Compras
:Adicione a Posição fiscal do Avatax Brasil.
Regime fiscal (Regime tributário federal).
Tipo de contribuinte de ICMS (indica regime de ICMS, status de Isento ou Não contribuinte).
Setor de atividade principal.
Por fim, carregue um logotipo da empresa e salve o contato
Nota
Se você se enquadrar em um regime simplificado, precisará configurar a alíquota de ICMS em
.Configurar a integração do AvaTax¶
O Avalara AvaTax é um provedor de cálculo de impostos que pode ser integrado ao Odoo para calcular impostos automaticamente, levando em conta as informações da empresa, do contato (cliente), do produto e da transação para encontrar o imposto correto a aplicar.
A Odoo tem parceria certificada com a Avalara Brasil, o que significa que os especialistas da Avalara revisaram os fluxos de trabalho abrangidos pelo escopo da integração.
Using this integration requires In-App-Purchases (IAPs) to compute taxes. Every time you compute taxes, an API call is made, using credits from your IAP credits balance.
Configuração de credenciais¶
Para ativar o AvaTax no Odoo, você precisa criar uma conta. Para isso, vá para AvaTax Brasil, adicione o endereço de e-mail usado no portal AvaTax e clique em Criar conta’. Este e-mail será usado como endereço de e-mail do administrador no Avatax.
e, na seçãoDepois de criar a conta no Odoo, você precisa ir ao Portal Avalara para configurar sua senha:
Acesse o portal Avalara.
Clique em Meu primeiro acesso
Adicione o endereço de e-mail que você usou no Odoo para criar a conta Avalara/Avatax e, em seguida, clique em Solicitar senha.
Você receberá um e-mail com um token e um link para criar sua senha. Clique nesse link e copie e cole o token para alocar a senha desejada.
Aviso
Se você pretende primeiro testar a integração em uma base de dados de teste ou sandbox, é recomendável usar um endereço de e-mail alternativo, pois não será possível reutilizar o mesmo endereço de e-mail na base de dados de produção.
Dica
Você pode começar a usar o AvaTax no Odoo sem criar uma senha e acessar o Portal Avalara; no Odoo, o único requisito para começar a usar o Mecanismo de cálculo de impostos da Avalara é criar uma conta na página de definições.
Nota
Você pode transferir credenciais API. Use isso somente quando já tiver criado uma conta em outra instância do Odoo e quiser reutilizá-la.
Configurar dados mestre¶
Plano de contas¶
O plano de contas é instalado por padrão como parte do conjunto de dados incluído no módulo de localização. As contas são mapeadas automaticamente em seus impostos correspondentes e nos campos padrão de conta a pagar e conta a receber.
Nota
O plano de contas para o Brasil é baseado no SPED CoA, que fornece uma linha de base das contas necessárias no Brasil.
Você pode adicionar ou excluir contas de acordo com as necessidades da empresa.
Impostos¶
Os impostos são criados automaticamente ao instalar a localização brasileira. Os impostos já estão configurados, e alguns deles são usados pelo Avalara ao calcular a tributação no pedido de venda ou na fatura.
É possível editar ou adicionar mais impostos. Por exemplo, alguns impostos usados para serviços precisam ser adicionados e configurados manualmente, pois a taxa pode ser diferente dependendo da cidade em que você está oferecendo o serviço.
Importante
Impostos associados a serviços não são calculados pelo AvaTax, somente os impostos sobre mercadorias.
Ao configurar um imposto de um serviço incluído no preço final (quando o imposto não é adicionado ou subtraído do preço do produto), defina o Cálculo de imposto como Porcentagem do preço com impostos e, na guia Opções avançadas, marque a opção Incluído no preço.
Para obter mais informações sobre como configurar os impostos para que atendam melhor às suas necessidades, acesse a documentação funcional documentação funcional de impostos.
Aviso
Não exclua impostos, pois eles são usados para o cálculos do AvaTax. Se forem excluídos, o Odoo os criará novamente quando forem usados em um SO ou fatura e no cálculo de impostos com o AvaTax, mas a conta usada para registrar o imposto precisará ser reconfigurada na aba Definição do imposto, nas seções Distribuição para faturas e Distribuição para reembolsos.
Produtos¶
Para usar a integração do AvaTax em pedidos de venda e faturas, primeiro especifique as seguintes informações sobre o produto:
Código CEST (Código para produtos sujeitos à substituição tributária do ICMS).
Código NCM do Mercosul (Código de Produto da Nomenclatura Comum do Mercosul).
Fonte de origem (Indica a origem do produto, que pode ser estrangeira ou nacional, entre outras opções possíveis, dependendo do caso de uso específico).
Tipo de produto fiscal SPED (Tipo de produto fiscal de acordo com a tabela de listas do SPED).
Finalidade de uso (Especifique a finalidade de uso pretendida deste produto).
Nota
O Odoo cria automaticamente três produtos para serem usados nos custos de transporte associados às vendas. São denominados Frete
, Seguro
e Outros custos
e já estão configurados; se for necessário criar mais, duplique e use a mesma configuração (configuração necessária: Tipo de produto Serviço
, Tipo de custo de transporte Seguro
, Frete
ou Outros custos
).
Contatos¶
Antes de usar a integração, especifique as seguintes informações do contato:
Informações gerais do contato:
Selecione a opção Empresa para um contato com CNPJ, ou marque a opção Particular para um contato com CPF.
Nome
Endereço: Código postal é um campo obrigatório para calcular os impostos corretamente.
ID fiscal ou CPF: Utilize o CPF para pessoas físicas e o CNPJ para pessoas jurídicas
IE: número de identificação fiscal estadual
IM: número de identificação fiscal municipal.
Código SUFRAMA: Número de registro na SUFRAMA.
Telefone.
E-mail.
Nota
Os campos CPF, IE, IM e código SUFRAMA ficam ocultos até que o País seja definido como
Brasil
.Informações fiscais sobre o contato na aba Vendas e Compras:
Posição fiscal: adicione a posição fiscal do AvaTax para calcular automaticamente os impostos sobre pedidos de venda e faturas
Regime fiscal: regime tributário federal
Tipo de contribuinte de ICMS: o tipo de contribuinte determina se o contato está dentro do regime de ICMS, se está isento ou se é um não contribuinte
Setor principal de atividade: lista dos principais setores de atividade do contato
Posições fiscais¶
Para calcular impostos em pedidos de venda e faturas, é necessário ter uma Posição fiscal com as opções Detectar automaticamente e Usar API do AvaTax habilitadas.
A Posição fiscal pode ser configurada no contato ou selecionada ao criar um pedido de vendas ou uma fatura.
Fluxo de Trabalho¶
Esta seção fornece uma visão geral das ações que acionam chamadas de API para cálculo de impostos.
Aviso
Observe que cada chamada de API incorre em um custo. Esteja atento às ações que acionam essas chamadas para gerenciar os custos de modo eficaz.
Cálculos de impostos sobre cotações/pedidos de vendas¶
Acione uma chamada de API para calcular impostos em uma cotação ou pedido de venda automaticamente com o AvaTax das seguintes maneiras:
- Confirmação de cotação
Confirme uma cotação e a converta em um pedido de vendas.
- Disparo manual
Clique em Calcular impostos usando Avatax.
- Visualizar
Clique no botão Visualizar.
- Envie uma cotação/pedido de venda por e-mail
Envie uma cotação ou um pedido de vendas para um cliente por e-mail.
- Acesso à cotação on-line
Quando um cliente acessa a cotação on-line (por meio da visualização do portal), a chamada de API é acionada.
Cálculos de impostos em faturas¶
Acione uma chamada de API para calcular os impostos em uma fatura do cliente automaticamente com o AvaTax das seguintes maneiras:
- Disparo manual
Clique em Calcular impostos usando AvaTax.
- Visualizar
Clique no botão Visualizar.
- Acesso à fatura on-line
Quando um cliente acessa a fatura on-line (por meio da visualização do portal), a chamada de API é acionada.
Nota
A Posição fiscal deve ser definida como Mapeamento automático de impostos (Avalara Brasil)
para que qualquer uma dessas ações calcule os impostos automaticamente.