Histórico da Página

Informações Gerais

Objetivo

Permitir a identificação automática do tipo de documento, (Nota Fiscal de Serviço de Transporte ou Conhecimento de Transporte), a ser gerado no cálculo do frete e retirada da obrigatoriedade do campo de tipo de documento no cadastro de serviço de negociação.

Definição da Regra de Negócio

Atualmente, na entrada da nota fiscal do cliente, vinculamos o documento do cliente a um serviço de negociação (DTC_SERVIC), este serviço determina o tipo de documento que será gerado, Nota Fiscal de Serviço de Transporte ou Conhecimento de Transporte. Desta forma, fica a critério do usuário determinar qual o tipo de documento será gerado, porém, temos condições de uso para cada um destes documentos. Nota Fiscal de serviço de Transporte deve ser gerado quando a prestação de serviço for dentro do mesmo município e Conhecimento de Transporte quando a prestação for intermunicipal. Desta forma o usuário poderá escolher incorretamente o serviço, gerando um tipo de documento incorreto e criando impactos nos impostos gerados.

Esta melhoria tem o objetivo de verificar qual a origem e destino da prestação do serviço, e determinar qual o tipo de documento será gerado automaticamente CTRC / CTE ou NFST, evitando assim possíveis falhas de geração de documentos. Com esta implementação iremos retirar a obrigatoriedade do campo "Doc. Transp" (DC5_DOCTMS) na configuração do serviço de negociação, permitindo ao cliente a configurar apenas um único serviço de negociação para a geração dos documentos de transportes do tipo 2 (CTRC) e 5 (NFST). Para os demais tipos de documentos como por exemplo documento "Docto de Apoio" ainda será necessário informar o tipo do documento na configuração do Serviço de Negociação e na digitação do serviço será realizado o gatilho para o novo campo DTC_DOCTMS. 

Será criado o campo DOCTMS nas rotinas:

• Cotação de Frete (TMSA040)
• Entrada Documento Cliente (TMSA050)
• Agendamento (TMSAF05)

Uma vez informado um serviço de negociação configurado com o tipo de documento em branco, na digitação da nota fiscal do cliente ou na cotação de frete ou agendamento, ao informar a região de origem e de cálculo, será verificado se existe o tipo de documento 2 ou 5 configurados para a filial na tabela de “Configuração de Documentos” (DUI) e de acordo com as regiões informadas será sugerido a geração de um CTE ou de uma NFST.

Assim será gatilhado no novo campo DOCTMS o tipo de documento a ser emitido, estes novos campos serão fechados para edição. 

1 - Entrada Documento Cliente (TMSA050) 

Para a região de origem o sistema irá verificar o campo "Selec.Origem" na digitação da nota fiscal. São possíveis três opções: 

• Transportadora - O sistema irá considerar como região de origem o parâmetro MV_CDRORI da filial que está conectada.
• Cliente Remetente - O sistema irá considerar o campo A1_CDRDES que está no cadastro do cliente remetente da nota fiscal.
• Local de Coleta - Se existir uma solicitação de coletas vinculada à nota, o sistema irá localizar o local de coletas vinculado a esta solicitação, e considerar o campo DUE_CDRSOL (Quando não existir endereço de coleta), ou DUL_CDRDES (Quando existir endereço de coleta).

Para a região de destino o sistema irá considerar o campo DTC_CDRCAL (região de cálculo da Nota Fiscal). Este campo já contempla o endereço de entrega, caso ele esteja indicado na nota fiscal.

Em seguida serão analisados os campos DUY_EST + DUY_CODMUN (UF da região + código do município da região) das regiões de origem e cálculo descritas acima. Sendo iguais, o sistema irá sugerir a geração de um documento do tipo Nota Fiscal de Serviço de Transporte. Sendo diferentes, o sistema irá sugerir a geração de um Conhecimento de Transporte. 

Irá existir uma validação que não permita salvar a digitação do documento caso o tipo de documento não exista na tabela DUI (Configuração de documentos). 

Quando informado um serviço de negociação qual o DOCTMS esteja vazio e no campo DTC_TIPNFC seja informado a opção 1 = Devolução, será realizado o gatilho para o campo DTC_DOCTMS igual a 6 - Devolução.  

Ao selecionar uma cotação de frete na digitação do documento do cliente, será realizado o gatilho do DOCTMS da cotação de frete. 

Os ajustes deverão ser realizados nas funções: 

• A050FrtInf
• TMSA050TudOK
• SeleItCF
• TMSA050Vld
• TMSA050Ser
• A050PesCub
• A050WhTpNf    

2 - Cotação de Frete (TMSA040) 

Para a rotina de cotação de frete se aplica o mesmo conceito da rotina de entrada de documento do cliente quanto a região de origem.

Para a região de destino será considerado o campo  DT4_CDRDES. Na sequência será realizado a mesma verificação da entrada de documento do cliente avaliando os campos DUY_EST+DUY_CODMUN para a sugestão do tipo de documento a ser gerado. 

As alterações deverão ser realizadas nas funções:

• TmsA040Atz 
• TMSA040Vld
• TmsA040Frt 
• TmsPesCub

3 - Cálculo de Frete (TMSA200)

O tipo de documento a ser gerado na rotina de cálculo de frete será baseado no informado (sugerido) na digitação do documento do cliente através do novo campo DTC_DOCTMS. Assim sendo não será avaliado o campo DC5_DOCTMS do serviço para a geração do documento de frete. 

As alterações deverão ser realizadas nas funções: 

• TMSA200Prc
• TMSA200NfC
• TMSA200Ctr
• TmsA200Agr
• TmsA200Grv

4 - Contrato de Carreteiro (TMSA250)

Devido a retirada da obrigatoriedade do campo DC5_DOCTMS do cadastro de serviço faz-se necessário realizar ajuste na função TMA250Oper, na montagem do XML da operadora de frotas REPOM. Devido ao envio do tipo do documento, atualmente a pesquisa é realizado na tabela DC5.

5 - Encerramento de Viagem (TMSA340)

Devido a retirada da obrigatoriedade do campo DC5_DOCTMS do cadastro de serviço faz-se necessário realizar ajuste na função TMA340Oper, no encerramento da viagem quando existe a integração com a operadora de frota REPOM. Devido ao envio do tipo do documento no XML para baixa do controle de viagem, atualmente a pesquisa é realizado na tabela DC5.

6 - Fatura automática (TMSA491) 

Ajustar a função TMSA491Doc e TMSA491VlrC, na passagem de parâmetro de pesquisa para gravação do documento de transporte (DT6). 

7 - Agendamento (TMSAF05 )

Ajustar a função TMSAF05Vld com a criação do novo campo DF1_DOCTMS para posicionamento na configuração de documentos para obter a série do documento através da tabela DUI. 

8 - Serviços x Tarefas (WMSA070) 

Ajustar a função WMA70TudOk, para permitir gravar um serviço de negociação com o campo DC5_DOCTMS vazio. 

Ajustar a função TMSValField.

9 - TMSXFUNB

Ajustar as funções: 

• TMSPesqServ
• TmsRetServ

10 - TMSXFUNC

Criar a nova função TMSTipDoc que irá identificar qual o tipo de documento deverá ser gerado, de acordo com as regiões de origem e calculo. Esta função deverá receber dois parâmetros sendo as regiões de origem e calculo e seu retorno deverá ser o tipo de documento 2 (CTRC) ou 5 (NFST). 

Ajustar a função TMSCalcRat, para realizar o posicione da variável cDocTMS através do novo campo DTC_DOCTMS.  

11 - Manutenção de Documentos (TMSA500)

Ajustar a função TmsA500Tot.

Exemplo de Aplicação:

• ^{Criar a configuração do documento a ser emitido para a filial na rotina "Configuração de Documentos" tabela DUI, necessário criar pelo menos a configuração dos documentos 2 (CTRC) e 5 (NFST)}

• ^{Através da rotina de "Serviços x Tarefas" incluir um serviço de negociação sem informar o campo "Docto.Transp".}

• ^{Criar o campo "Tipo de Documento"” (DTC_DOCTMS) onde será gatilho automaticamente o tipo de documento 2 (CTRC) ou 5 (NFST) de acordo com as regiões de origem e calculo informados na digitação da nota fiscal do cliente, desde que informado um serviço qual esteja configurado com o campo "Docto.Transp" vazio.} 

• ^{O usuário poderá informar um outro tipo de documento caso decida por exemplo utilizar um documento de apoio desde que exista a configuração na tabela DUI para a filial.}

• ^{E ao realizar o calculo do frete o sistema irá identificar o tipo do documento informado na digitação da NF.}

Tabelas Utilizadas

• DC5 - Serviços x Tarefas

• DT4 - Cotação de Frete

• DTC - Entrada Dc. Cliente
  

• DF1 - Itens de agendamento

Opcional

Protótipo de Tela

Campo Documento Transporte que será criado na rotina de digitação de documentos do cliente (TMSA050).

Opcional

Dicionário de Dados

Arquivo ou Código do Script: DTC – Doc Cliente para Transporte 

Arquivo ou Código do Script: DT4 – Cotação de Frete

Arquivo ou Código do Script: DF1 - Itens do Agendamento