Boletim Técnico: Taxa de Difícil Acesso – TDA
Ocorrência
Melhoria
Resumo
Implementada melhoria nas rotinas “Tabela de Frete (TMSA010), Ajuste da Tabela de Frete (TMSA011), Cotação de Frete (TMSA040), Configuração da Tabela de Frete (TMSA130), Cálculo do Frete (TMSA200), Reajuste de Preços por Cliente (TMSA750) disponibilizando a funcionalidade Taxa de Difícil Acesso – TDA que possibilitará aos transportadores efetuarem a cobrança de taxas adicionais, quando o Remetente (coleta) e/ou Destinatário (entrega) estiverem localizados em regiões de difícil acesso.O cálculo desta taxa será apurado com base no valor total do frete, considerando um valor mínimo e máximo por tabela de frete.
ID do Chamado
SBJWP7
Produtos
Microsiga 10
Módulos
- SIGATMS
Portais
- nenhum
Países
- Brasil
Sistema Operacional
todos
Nome + Fonte
Tabela de Frete - TMSA010, Ajuste da Tabela de Frete - TMSA011, Cotação de Frete - TMSA040, Configuração da Tabela de Frete - TMSA130, Cálculo do Frete - TMSA200, Reajuste de Preços por Cliente - TMSA750, TMSXFUNA e TMSXFUNB.
Número da FNC
000000101642009
Ajustes no Compatibilizador
Sim
Integridade Referencial
Sim
Aplicação de Patch
Não
Compatibilizador 1
- TMSP10R1
Procedimentos para Implementação
Para implementação do processo, deve ser executado o compatibilizador “TMSP10R1”. Esse compatibilizador efetua o ajuste necessário no dicionário e base de dados
Importante:
Antes de executar o compatibilizador “TMSP10R1”, é imprescindível:
a) Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório “\PROTHEUS_DATA\DATA”) e dos dicionários de dados "SXs" (diretório “\PROTHEUS_DATA\ SYSTEM”);
Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
b) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
c) Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá ocasionar a sobregravação de índices personalizados caso não estejam identificados pelo nickname.
d) O compatibilizador deve ser executado com a Integridade Referencial desativada*.
ATENÇÃO: O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA), ou equivalente! * A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir: i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção “Integridade/Verificação” (APCFG60A). ii. Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema, e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções. iii. Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela de “Verificação de relacionamento entre tabelas”. Confirme a mensagem para que a verificação seja concluída, ou; iv. Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema, e somente a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada, e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso departamento de Framework para informações quanto a um arquivo que contém essa informação). v. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção “Integridade/ Desativar” (APCFG60D). vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções. vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção “Integridade/Ativar” (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação. Contate o departamento de Framework CASO TENHA DÚVIDAS! |
- Acesse o TOTVS SmartClient, e no campo “Programa Inicial”, digite “TMSP10R1”.
- Clique no botão “Ok” para continuar.
- Será apresentada uma janela na qual são visualizados todos os updates disponíveis.
- Selecione com duplo clique a opção TMS10R133. Observe que a opção ficará marcada.
- Para confirmar a execução da atualização, clique no botão “Processar”.
- Após atualizar o sistema, será apresentada a janela de LOG das atualizações realizadas.
- Clique no botão “Gravar” para salvar o histórico (log) apresentado.
- Clique no botão “Cancelar” para sair.
Descrição de Ajustes
1. No SX3 (Dicionário de Dados – Campos da Tabela) foram criados os seguintes campos.
· Tabela SA1 – “Clientes”
Campo | A1_TDA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | TDA |
Descrição | Taxa de Difícil Acesso |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | 1=Sim;0=Não |
When | |
Relação | “2” |
· Tabela DTC – “Documento do Cliente para Transporte”
Campo | DTC_EXCTDA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Descon. TDA |
Descrição | Desconsidera Calculo TDA |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | 1=Coleta;2=Entrega;3=Ambas |
When | |
Relação | |
· Tabela DTK – “Complemento da Tabela de Frete”
Campo | DTK_VALMAX |
Tipo | Numérico |
Tamanho | 14 |
Decimal | 2 |
Formato | @E 999,999,999.99 |
Título | Valor Máximo |
Descrição | Valor Máximo Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
· Tabela DUL – “Endereços do Solicitante”
Campo | DUL_TDA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | TODA |
Descrição | Taxa de Difícil Acesso |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | 1=Sim;0=Não |
When | |
Relação | “2” |
· Tabela DUO – “Perfil do Cliente”
Campo | DUO_PGTDA |
Tipo | Caracter |
Tamanho | 1 |
Decimal | 0 |
Formato | @! |
Título | Paga TDA |
Descrição | Paga TDA |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | 1=Coleta;2=Entrega;3=Coleta e Entrega;4=Coleta ou Entrega |
When | |
Relação | |
· Tabela DVO – “Complemento de Ajuste”
Campo | DVO_VALMAX |
Tipo | Numérico |
Tamanho | 14 |
Decimal | 2 |
Formato | @E 999,999,999.99 |
Título | Valor Máximo |
Descrição | Valor Máximo Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | |
Opções | |
When | |
Relação | |
Campo | DVO_VLRMAX |
Tipo | Numérico |
Tamanho | 14 |
Decimal | 2 |
Formato | @E 999,999,999.99 |
Título | Vlr.Max.Ajus. |
Descrição | Valor Maximo do Ajuste |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | |
Opções | |
When | |
Relação | |
Campo | DVO_PERMAX |
Tipo | Numérico |
Tamanho | 14 |
Decimal | 8 |
Formato | @E 99,999.9999999 |
Título | Per.Max.Aju. |
Descrição | Perc. Máximo do Ajuste |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
· Tabela DVY – “Base de Cálculo Componente TDA”
Campo | DVY_FILIAL |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Filial |
Descrição | Filial do Sistema |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Campo | DVY_TABFRE |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Tabela de Frete |
Descrição | Tabela de Frete |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DVY_TIPTAB |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Tp.Tab.Frete |
Descrição | Tipo Tabela de Frete |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DVY_CDRORI |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cód.Reg.Ori |
Descrição | Código Região Origem |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DVY_CDRDES |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cód.Reg.Des |
Descrição | Código Região Destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DVY_CODPRO |
Tipo | Caracter |
Tamanho | 15 |
Decimal | 0 |
Formato | @! |
Título | Produto |
Descrição | Produto |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DVY_CODPAS |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Cód.Compone. |
Descrição | Código do Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | If( Type( "cFolder" ) == "U","",cFolder) |
Campo | DVY_DESPAS |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | @! |
Título | Componente |
Descrição | Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | |
Opções | |
When | |
Relação | If( Type( "cFolder" ) == "U","",Posicione("DT3", 1,xFilial("DT3")+cFolder, "DT3->DT3_DESCRI" )) |
Campo | DVY_VLBASE |
Tipo | Numérico |
Tamanho | 6 |
Decimal | 0 |
Formato | @E 999.99 |
Título | % Base Calç |
Descrição | % Base de Cálculo |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | |
Opções | |
When | |
Relação | |
· Tabela DWZ – “Ajuste Base de Cálculo Componente TDA”
Campo | DWZ_FILIAL |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Filial |
Descrição | Filial do Sistema |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Opções | |
When | |
Relação | |
Campo | DWZ_TABFRE |
Tipo | Caracter |
Tamanho | 4 |
Decimal | 0 |
Formato | @! |
Título | Tabela de Frete |
Descrição | Tabela de Frete |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_TIPTAB |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Tp.Tab.Frete |
Descrição | Tipo Tabela de Frete |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_CDRORI |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cód.Reg.Ori |
Descrição | Código Região Origem |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_CDRDES |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cód.Reg.Des |
Descrição | Código Região Destino |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_CODCLI |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 0 |
Formato | @! |
Título | Cód.Cliente |
Descrição | Código do Cliente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_LOJCLI |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Loja Cliente |
Descrição | Loja do Cliente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_SEQTAB |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Seq.Tab.Fre |
Descrição | Seqüência Tabela Frete |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_CODPRO |
Tipo | Caracter |
Tamanho | 15 |
Decimal | 0 |
Formato | @! |
Título | Produto |
Descrição | Produto |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_SERVIC |
Tipo | Caracter |
Tamanho | 3 |
Decimal | 0 |
Formato | @! |
Título | Serviço |
Descrição | Código do Serviço |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_CODPAS |
Tipo | Caracter |
Tamanho | 2 |
Decimal | 0 |
Formato | @! |
Título | Cód.Compone. |
Descrição | Código do Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | If( Type( "cFolder" ) == "U","",cFolder) |
Campo | DWZ_DESPAS |
Tipo | Caracter |
Tamanho | 20 |
Decimal | 0 |
Formato | @! |
Título | Componente |
Descrição | Componente |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | |
Opções | |
When | |
Relação | If( Type( "cFolder" ) == "U","",Posicione("DT3", 1,xFilial("DT3")+cFolder, "DT3->DT3_DESCRI" )) |
Campo | DWZ_VLBASE |
Tipo | Numérico |
Tamanho | 6 |
Decimal | 2 |
Formato | @E 999.99 |
Título | % Base Calç |
Descrição | % Base de Cálculo |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_VLAJUS |
Tipo | Numérico |
Tamanho | 6 |
Decimal | 2 |
Formato | @E 999.99 |
Título | % Ajuste |
Descrição | % de Ajuste |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Campo | DWZ_VLBAJU |
Tipo | Caracter |
Tamanho | 6 |
Decimal | 2 |
Formato | @E 999.99 |
Título | Vlr.Ajustado |
Descrição | Valor Base Ajustado |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
2. Criação de Pastas no arquivo SXA – Folders.
Chave | Ordem | Descrição |
DUO | 6 | TODA |
3. Criação de tabela no arquivo SX2 – Tabelas.
Chave | Nome | Modo | PYME |
DVY | Base de Calc.Componente TODA | C | N |
Chave | Nome | Modo | PYME |
DWZ | Ajuste Base Cal.Componente TODA | C | N |
4. Criação de Índices no arquivo SIX – Índices.
Índice | DUY |
Ordem | 1 |
Chave | DVY_FILIAL + DVY_TABFRE + DVY_TIPTAB + DVY_CDRORI + DVY_CDRDES + DVY_CODPRO + DVY_CODPAS |
Descrição | Filial + Tabela Frete + Tp.Tabela Frete + Cod.Reg.Origem + Cod.Reg.Destino + Produto + Cod.Componente |
Proprietário | S |
Índice | DWZ |
Ordem | 1 |
Chave | DWZ_FILIAL + DWZ_CODCLI + DWZ_LOJCLI + DWZ_TABFRE + DWZ_TIPTAB + DWZ_CDRORI + DWZ_CDRDES + DWZ_SEQTAB + DWZ_CODPRO + DWZ_SERVIC + DWZ_CODPAS |
Descrição | Filial + Código + Loja + Tabela Frete + Tp.Tabela Frete + Reg.Origem + Reg.Destino + Seq.Tab.Frete + Produto + Serviço + Cod.Componente |
Proprietário | S |
Procedimentos para Utilização
1. Acesse o Módulo SIGATMS – Gestão de Transportes, opção Atualizações/Cadastros/Clientes”.
2. Clique em “Incluir” para cadastrar um cliente novo.
3. Observe que a tela está dividida em pastas: Cadastrais / Adm.Fin / Fiscais / Vendas / Outros.
4. Os campos identificados na cor azul, são obrigatórios. O Sistema não confirmará a inclusão de algum deles em qualquer uma das pastas não for preenchido.
5. Observe que foi criado o campo “TDA” no final da tela de inclusão de novos registros, na pasta Cadastrais. Informe SIM se o Remetente e/ou Destinatário está estabelecido em local de difícil acesso ou NÃO se não se aplica esta condição.
6. Ainda no módulo TMS, acesse “Atualizações/Comercial/Perfil do Cliente” observe que a tela de inclusão também está separada em pastas, sendo: Comercial, Financeiro, Reentrega, Refaturamento, Armazenagem e TDA.
7. Acesse a pasta TDA e informe no campo “Paga TDA” em que momento o sistema deverá efetuar o calculo da taxa de difícil acesso.
As opções disponibilizadas são: 1-Coleta; 2-Entrega; 3-Coleta e entrega; 4-Coleta ou entrega.
Importante
O Sistema efetuará o cálculo da taxa com base nas informações armazenadas neste campo. Vale ressaltar que se o campo estiver preenchido como “Coleta e Entrega”, o cálculo da taxa será realizado duas vezes uma para a Coleta e outra para a Entrega. Já no caso de estar preenchido como “Coleta ou Entrega”, o cálculo será realizada apenas uma vez.
8. Acesse “Atualizações/Comercial/Componentes de Frete”, clique em incluir para criar um componente que faça o cálculo da TDA.
O campo “Calc.Sobre” deve ser preenchido com a opção 13 – Dificuldade de acesso com base no total do frete sem imposto.
Importante
O cálculo destes componentes será baseado nos valores apurados para os demais componentes da tabela de frete. Estes componentes serão calculados após a apuração dos demais componentes da que compõem a tabela de frete utilizada.
9. Em “Atualizações/Comercial/Tabela de Frete”, selecione algum dos registros existentes. Clique em Visualizar.
10. Observe na barra de ferramentas a disponibilização do botão “Base Componente Tx. Dif. Acesso” que permite compor a base para cálculo (Total do Frete) do componente TDA.
11. Clique no botão, o Sistema exibe a tela para inclusão dos percentuais dos demais componentes da tabela que irão compor a base de cálculo para o componente TDA.
Importante
O botão para composição da base da taxa de difícil acesso somente é habilitado se o componente corrente estiver configurado para a tabela em uso. Para tanto, é necessário que o usuário esteja posicionado sobre a aba do componente que irá calcular o TDA para que o botão seja habilitado.
12. Visualize na barra de ferramentas o botão “Complemento Tabela de Frete” utilize-o para definir os limites (Máximo e Mínimo) dos valores cobrados para a taxa de difícil acesso (TDA).
13. A tela está separada por acessos, sendo: Cod.Compone.; Componente; Mínimo Exces.; Val.Minimo; Vlr Excedent.; Fração Exced ; Valor Mínimo; Alias WT; Recno WT.
Ainda nesta rotina, através do botão “Complemento Tabela de Frete” é possível definir os limites (Máximo e Mínimo) dos valores cobrados para a taxa de difícil acesso (TDA). Conforme Imagem abaixo.
14. Em “Atualizações/Recebimento/Entrada Doc. Cliente” clique em Incluir.
15. Observe nesta tela de inclusão, o campo “Descon TDA”, as opções disponibilizadas são:
· 1-Coleta
· 2-Entrega
· 3-Ambas
16. Desta forma o usuário poderá inclusive praticar a isenção da taxa em eventuais negociações comerciais.
17. Em “Atualizações/SAC/Cotação de Frete”, observe que a tela está dividida em pastas, sendo:
Dados da empresa; Serviço; Aprovação; Outros.
18. Para utilizar esta rotina para calcular o componente TDA, clique no botão “Valor Fechado” para zerar o componente TDA, este recurso, possibilita a isenção desta taxa em eventuais negociações comercias.
Exemplo:
Após ter acessado a opção Valor Fechado basta efetuar os seguintes passos:
· 1º Passo - Marcar a opção Valor Fechado;
· 2º Passo - Selecionar o componente ao qual deseja mudar o valor;
· 3º Passo - Informar qual o novo valor do componente.
19. Em “Atualizações/Comercial/Ajuste Tab. Frete” pode-se criar uma nova tabela “ajustada” gerada com base na tabela mãe (padrão) de um determinado cliente.
20. Observe que a gravação do ajuste é feita por meio de um percentual ou valor em relação à tabela mãe.
21. Acesse “Atualizações/Recebimento/Cálculo de Frete”, é nesta rotina, onde após o término do cálculo de todos os componentes existentes na tabela, o sistema irá verificar também se os valores apurados da TDA (sendo de coleta e/ou de entrega) estarão dentro dos valores estipulados como mínimo e máximo para cobrança deste componente.
Na parte inferior da tela está definido a “Composição do frete”, observe que um dos itens na coluna “Composição” refere-se ao TDA.
Informações Técnicas
Tabelas Utilizadas | SA1 – Clientes, DTC – Documento do Cliente para Transporte, DTK – Complemento da Tabela de Frete, DUL – Endereços do Solicitante, DUO – Perfil do Cliente, DVO – Complemento de Ajuste, DVY – Base de Cálculo Componente TDA, DWZ – Ajuste Base de Cálculo Componente TDA. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas