ER PCREQ-2524 - Identificação do Tipo de Documento

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á gerada, 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 gerada 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 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á sugerida 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 informada 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    
• TM050GerAg

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á realizada 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. 

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

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

• TmsA040Atz 
• TMSA040Vld
• TmsA040Frt 
• TmsPesCub
• TMSA040Whe

3 - Cálculo de Frete (TMSA200)

O tipo de documento a ser gerado na rotina Cálculo de Frete será baseado no informado (sugerido) na digitação do documento do cliente, por meio 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 o 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 as funções 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 por meio 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 cálculo. Esta função deverá receber dois parâmetros, sendo as regiões de origem e cálculo 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 por meio 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).
• Por meio da rotina "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á gatilhado automaticamente o tipo de documento 2 (CTRC) ou 5 (NFST), de acordo com as regiões de origem e cálculo informados na digitação da nota fiscal do cliente, desde que informado um serviço no qual esteja configurado com o campo "Docto.Transp" vazio. 
• Ao realizar o cálculo do frete, o sistema irá identificar o tipo do documento identificado 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.

Protótipo de Tela

Campo Documento Transporte que será criado na rotina Digitação de Documentos do Cliente (TMSA050).

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