DTCRMSD-426 - Adequação do cálculo de imposto em um pedido de venda à nova API do Protheus

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

O Protheus desenvolveu uma API nativa para simular o cálculo de impostos de uma ordem de venda de forma que qualquer sistema externo possa solicitar este cálculo que é de competência do ERP. Até então o TOTVS CRM Gestão de clientes utilizava uma API que era um plugin desenvolvido pela franquia TOTVS Cascavel para realização do cálculo. Tal plugin precisava ser contratado de forma independente pelos clientes como um serviço personalização do Protheus, assim gerando custos. Com a API nativa disponibilizada pelo Protheus, o TOTVS CRM Gestão de clientes passou a adotar ela como solução padrão para realização de cálculo de impostos, assim o plugin antigo, renomeado como plugin WSSIM3G nas configurações, passou a ser descontinuado e continua a ser disponibilizado até que os seus atuais utilizadores migrem para a nova API. 

03. SOLUÇÃO

A nova API de calculo de impostos é definida pela seguinte documentação:  Impostos do Pedido de Venda - 1.000. Como premissa, nesta release inicial da funcionalidade, não será suportado o atributo TES, assumindo assim que a funcionalidade TES Inteligente do Protheus será utilizada.

Para que o cálculo de impostos ser realizado na API nativa do Protheus, é necessário realizar as seguintes configurações:

1. Habilitar cálculo de impostos nas configurações de Ordens de Venda e realizar configurações

No menu de configurações do módulo Ordens de Venda, opção Configurações da ordem de venda (Ordens de venda > Configurações > Configurações da ordem de venda), habilitar a opção "Habilitar cálculo de impostos", selecionando no campo ERP a opção "Protheus (API SalesTaxes)" e informar a URL do serviço de cálculo de impostos do Protheus (veja figura 1).

Se o serviço necessitar de autenticação, habilite também a opção "Habilitar autenticação" e configure o "Nome de usuário" e a "Senha" para ser utilizada como autenticação (veja figura 1).

Na sequência deve ser configurado quais impostos devem ser calculados. Para isso, marcar os checkboxes dos impostos que se desejam que sejam calculados (veja figura 2).

2. Configurar Moedas a serem utilizadas no cálculo

Para que o cálculo seja realizado é necessário que seja configurado no modulo administrativo as moedas a serem utilizadas e para cada moeda, definir o código que é utilizado no ERP Protheus. Para isso, acesse nas configurações do menu Administrativo a opção Moedas (Administrativo > Configurações > Moedas), e cadastre (ou edite) as moedas a serem utilizadas.

No cadastro da moeda, para que o cálculo de impostos seja realizado, deve ser informado no campo "Código" o código da moeda que é utilizado no ERP, sendo ele em formato texto (veja figura 3).

3. Configurar o código do Produto e Serviço

Nos cadastros de produtos e serviço, menu Produtos e serviços, conforme o que é utilizado na sua empresa, deve ser informado em cada cadastro de produto o campo "Código" que é o código utilizado pelo ERP para identificar o produto ou serviço (veja figuras 4 e 5).

4. Configurar o código do tipo de Ordem de Venda

Nas configurações do módulo Ordens de Venda, a configuração dos Tipos de ordens de venda  (Ordens de venda > Configurações > Tipos de ordens de venda) deve ter em cada registro a informação de código que é utilizada no ERP, sendo esta informada no campo "Código" (veja figura 6).

4. Configurar código da Empresa

Configurar no módulo Administrativo nas configurações de Empresa (Administrativo > Empresas), para cada registro, o código da empresa utilizado no ERP, informando este código no campo "Código" (veja figura 7).

5. Configurar código da Condição de pagamento

Configurar no módulo Ordens de Venda as Condições de pagamento (Ordens de venda > Configurações > Condições de pagamento), o campo "Código" para o código utilizado no ERP (veja figura 8).

6. Configurar o código do Endereço nos Clientes

Para cada Cliente cadastrado (Contas > Clientes), nas suas informações de endereço, configurar o código do endereço de faturamento e do endereço de entrega para o mesmo código utilizado no ERP (veja figura 9).

7. Realizando o calculo de impostos de uma ordem de venda

Para realizar o calculo de uma ordem de venda, é necessário que além de todas as configurações mencionadas anteriormente estejam corretas, na ordem de venda é necessário que seja informado as informações de entrega que se encontram na aba "Resumo". Será por meio do endereço de entrega que o ERP irá determinar o Diferencial de Alíquota (Difal) do ICMS a serem aplicadas a aquela venda. O endereço de entrega a ser selecionado deve ser um endereço que possui o código configurado conforme o item 6. Veja a figura 9 para localizar onde informar o endereço de entrega.

Após informado o endereço de entrega e os produtos, deverá ser possível realizar o cálculo do impostos a partir do botão "Calcular impostos" (veja figura 10), os quais são apresentados individualmente nos produtos (figura 11) e no diálogo de edição do item (figura 12).

04. DEMAIS INFORMAÇÕES

Não há.

05. ASSUNTOS RELACIONADOS

Não há.