INTEGRAÇÃO TMS

E GFE - VIAGEM

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Objetivo

Implementar a integração de Viagens de Transporte, Entrega e Coleta (modelo 2) do SIGATMS ao SIGAGFE.

Foram implementadas as seguintes melhorias:

• Funcionalidade para tratamento de pagamento do frete de carreteiro via GFE, da transportadora de redespacho, do tipo de frete no redespacho, da origem e do destino de cálculo de frete a ser utilizado no GFE, na tela da viagem modelo 2 de transporte de entrega e coleta.

• Funcionalidade de interface de dados de notas transportadas e CTe subcontratante do TMS e dados de documento de carga, trechos do documento de carga e romaneio no GFE ao fechar a viagem ou apontar a saída ou apontar a chegada da viagem no TMS.

• Funcionalidade de cálculo de frete GFE considerando classificação, operação e tipo de veículo do trecho do documento de carga.

• Funcionalidade de interface de dados para atualizar trechos do documento de carga ao apontar a chegada de viagem.

• Funcionalidade de tratamento na geração de contrato de carreteiro impedindo a geração de contrato para viagem com indicação de pagamento via GFE.

• Funcionalidade de geração de movimento de custo de transportes TMS via documento de frete do GFE.

• Funcionalidade de tratamento de custo de transporte por fornecedor.

• Funcionalidade de tratamento de custos de transporte via documento de frete TMS.

• Funcionalidade de faturamento de serviço adicional. 

    

Procedimento para Utilização

Viagem Modelo 2

A integração da viagem TMS com o GFE, será definida via parâmetro com as seguintes opções:

• F - Fechamento da Viagem: Ao fechar a viagem indicando conclusão da parte administrativa do processo.

• S - Saída da viagem: Ao apontar a saída da viagem indicando o veículo em trânsito.

• C - Chegada da viagem: Ao apontar a chegada da viagem indicando o retorno do veículo.

• N - Não integra: Integração desabilitada.

Na Viagem Modelo 2, os campos utilizados na integração com o GFE, serão habilitados para digitação somente quando os parâmetros estiverem configurados:

• MV_TMS3GFE
• MV_INTGFE
• MV_INTGFE2 
• Quando o parâmetro MV_ERPGFE indicar uso de ERP Datasul, o parâmetro MV_EMITMP deve indicar uso de numeração própria para emitente.

Na Viagem Mod.2 (DTQ), foram criados os campos para informe de pagamento via GFE (DTQ_PAGGFE), Tipo do Veículo (DTQ_TIPVEI), Classificação de Frete (DTQ_CDCLFR), Tipo de Operação (DTQ_CDTPOP), UF de Origem (DTQ_UFORI), Município de Origem (DTQ_CDMUNO), CEP de Origem (DTQ_CEPORI), UF de Destino (DTQ_UFDES), Município de Destino (DTQ_CDMUND), CEP de Destino (DTQ_CEPDES) de cálculo de frete GFE.

No Movimento da Viagem (DUD), foram criados campos para informe de Tipo do Veículo (DUD_TIPVEI), Tipo de Operação (DUD_CDTPOP), Classificação de Frete (DUD_CDCLFR), UF de Origem (DUD_UFORI), Município de Origem (DUD_CDMUNO), CEP de Origem (DUD_CEPORI), UF de Destino (DUD_UFDES), Município de Destino (DUD_CDMUND), CEP de Destino (DUD_CEPDES) de cálculo de frete no GFE, e o Redespacho Adicional da Viagem de Entrega (DJN).

Quando for indicado o Pagamento da Viagem via GFE (DTQ_PAGGFE):

• Todos os documentos da viagem serão obrigatoriamente pagos via GFE (DUD). Caso contrário, somente os documentos da viagem vinculados a um Redespacho Adicional serão pagos via GFE.
• Não será possível gerar contrato de carreteiro para viagem. 
• O informe da UF e Município de destino na viagem será obrigatório no documento da viagem (DUD), exceto para a viagem de Transporte, onde os dados serão preenchidos automaticamente no carregamento da viagem (UF e o código de município da região de descarga do documento).

Quando informada a UF ou o municipio de origem na viagem (DTQ), os dados serão consistidos com os dados da UF e municipio da região de origem da rota utilizada na viagem. Em não havendo coincidência, será solicitada a confirmação da digitação dos dados.

Será sugerida como UF e municipio de origem do documento da viagem ou a UF e o código de municipio da região de origem do documento, quando a filial do documento for igual a filial da viagem ou a UF e o código de municipio da região de origem da filial (MV_CDRORI), quando a filial do CTe for diferente da filial da viagem.

Nas viagens de entrega e coleta será sugerido, como UF e município de destino do movimento da viagem, a UF e o código de município da região de cálculo do documento e, na viagem de entrega quando indicada filial de descarga será adotada a UF e o código de município da região de descarga do documento.

Na viagem de transporte não será permitida alteração da UF e do município de destino. A UF e o código de município da região de descarga do documento, serão preenchidos automaticamente no carregamento da viagem. 

As notas fiscais ou a solicitação de coleta transportadas e vinculadas ao documento da viagem, dará origem a um documento de carga no GFE, quando houver a indicação de pagamento via GFE.

O cadastro de documento de carga é exclusivo por filial no GFE e assim, uma mesma NF ou solicitação de coleta do TMS poderá gerar mais de um documento de carga no GFE, quando a carga for processada em filais distintas, porém, serão tratados individualmente por filial da viagem na qual se originou a integração.

Ao vincular uma solicitação de coleta a uma viagem de entrega em trânsito, com serviço adicional de entrega habilitado e sendo indicado o pagamento via GFE (DTQ_PAGGFE), a integração do documento de carga ao GFE ocorrerá respeitando o parâmetro MV_TMS3GFE, ou seja, se indicada a integração no fechamento ou em trânsito, a integração será no momento da confirmação da alteração da viagem e, em sendo indicado no parâmetro a integração na chegada da viagem, a integração ocorrerá posteriormente ao apontar a chegada da viagem.

Foi disponibilizada uma funcionalidade de visualização dos documentos de carga (GFE) vinculados ao Documento da Viagem. Essa opção está disponivel na visualização da Viagem em Outras Ações / Docto Carga. 

Viagem Modelo 2 com Redespacho Adicional

Na Viagem de Entrega (Mod 2), foi disponibilizada nova funcionalidade para vínculo de redespacho do documento da viagem. O objetivo dessa funcionalidade é atender operações, nas quais ocorra a contratação de redespacho do documento em sua origem.

No redespacho adicional (DJN) poderão ser informados os dados de tipo de veículo, classificação de frete, tipo de operação, código e loja de fornecedor distintos entre si, tipo de frete, UF, municipio e CEP de origem e destino.

O vínculo de redespacho será integrado como um novo trecho no documento de carga no GFE.

Cadastro de Fornecedores:

Ao cadastrar um fornecedor, cujo pagamento seja efetuado pelo SIGAGFE não é necessário informar o Transportador (A2_TRANSP), basta apenas informar o campo A2_PAGGFE como 'SIM'. Neste caso, no momento da integração do Cadastro do Fornecedor (SA1) com o Cadastro de Emitentes (GU3), o emitente será automaticamente configurado como 'Transportador' (GU3_TRANSP).

Solicitação de Coleta

No momento da integração (Fechamento, Saida ou Chegada) se a solicitação de coleta já estiver vinculada a uma nota (DTC_NUMSOL), será criado o registro na tabela GXP informando o vínculo da chave da NFe (DTC_NFEID).

Na Entrada do Documento de Cliente (TMSA050), se vinculada a uma Solicitação de Coleta (DTC_NUMSOL) e caso a solicitação de coleta esteja integrada ao GFE (GW1), será incluído o vínculo da chave da NFe (DTC_NFEID).

Movimento de Custo de Custos

Disponibilizado o controle de despesas em aberto por fornecedor sem informe de veículo ou viagem.

O objetivo é atender as operações nas quais o agregado possui mais de um veículo envolvido e os descontos de frete não tem relação direta com o veículo utilizado na viagem. 

Exemplo: Fornecimento de peças para desconto em fretes futuros independentemente do veículo envolvido na manutenção.

Regras para Despesa:

• A despesa utilizada no controle não poderá movimentar banco ou estoque.
• A despesa poderá ser baixada parcialmente contra veículos e viagens distintas.
• As viagens com indicação de pagamento via GFE (DTQ_PAGGFE), não poderão ser vinculadas as despesas de movimento de custo de transporte TMS e não terão opção de adiantamento de frete via TMS.
  
  

Geração Cobrança Serviço Adicional

Disponibilizada uma nova funcionalidade para geração de documento fiscal relacionado ao cadastro de notas (DTC), vinculado a um documento fiscal original que possui uma ocorrência específica apontada.

O objetivo é gerar a cobrança de valores adicionais de serviço sobre notas fiscais transportadas.

Exemplo: Descarga e Paletização.

Os parâmetros de processamento serão:

1. Cliente pagador de frete?
2. Loja pagador de frete?
3. Data de emissão NFe de?
4. Data de emissão NFe até?
5. Cliente remetente de?
6. Loja remetente de?
7. Cliente remetente até?
8. Loja remetente até?
9. Cliente destinatário de?
10. Loja destinatário de?
11. Cliente destinatário até?
12. Loja destinatário até?
13. Ocorrência?
14. Negociação?
15. Serviço?

A ocorrência indicada no parâmetro 13 é obrigatória e deve considerar somente as notas transportadas vinculadas a CTe original que possua registro de ocorrência com o código indicado no parâmetro. O registro da ocorrência para o CTe possibilitará o gerenciamento da indicação de cobrança do serviço adicional.

O serviço indicado no parâmetro 15 deve ser do tipo negociação, vinculado a documento fiscal TMS tipo 5 (nota fiscal de serviço), e possuir indicação de critério de rateio para posterior visualização de receita rateada entre as notas selecionadas.

A TES que será utilizada na geração do documento fiscal, será a indicada na regra de tributação do documento fiscal TMS 5 e o produto fiscal será o indicado na regra de tributação do documento fiscal TMS 5. Porém, estas informações poderão ser especificadas durante a execução da rotina por meio de uma opção em Outras Ações / Informações Fiscais. Esta opção somente estará disponível caso o parâmetro MV_IFISSER esteja ativo. Quando a TES e/ou o Produto forem indicados nesta opção, serão utilizados na geração do documento fiscal.

Ao processar os dados das notas selecionadas, será verificado se o cliente pagador informado nos parâmetros 1 e 2 possui em seu contrato, a negociação e serviço indicados nos parâmetros 14 e 15 e sua respectiva tabela de frete TMS.

Em caso afirmativo, serão apresentados os dados abaixo, acumulados das notas selecionadas, a serem utilizados como base de cálculo do valor do serviço adicional, permitindo o ajuste do conteúdo pelo operador:

1. Quilometragem total das notas processadas;
2. Valor total de mercadoria das notas processadas;
3. Peso real total das notas processadas;
4. Peso cubado total das notas processadas;
5. Metragem cúbica total das notas processadas;
6. Quantidade total de volumes das notas processadas;
7. Valor base de risco rodoviário total das notas processadas;
8. Quantidade total de unitizadores total das notas processadas;
9. Total de valores informados nas notas processadas, para componentes de frete tipo "Valor Informado", que constem do layout da tabela de frete vinculada ao serviço no contrato do cliente pagador.
10. Total de valores informados nas notas processadas, para tipos de veículos que constem dos componentes de frete do layout da tabela de frete vinculada ao serviço no contrato do cliente pagador.

Caso o cliente pagador não conter a negociação e serviço indicado nos parâmetros 14 e 15 no seu contrato, será apresentada uma tela com o código e o nome do componente de frete informado no parâmetro MV_COMPSER, e campo para informe de valor a ser cobrado pelo serviço adicional não permitindo valor zerado.

Ao confirmar os valores será gerado o documento fiscal de serviço adicional vinculado as notas fiscais selecionadas e a ocorrência originadora.

Deverá existir apenas um documento de serviço adicional vinculado a uma ocorrência, ou seja, caso a nota selecionada esteja vinculada a um documento original que possua a ocorrência indicada no parâmetro, e para esta ocorrência já exista um documento de serviço adicional gerado, não deve permitir a geração de um novo documento. Para que seja possível gerar um novo documento, será necessário incluir uma nova ocorrência para o documento original.

Os clientes remetente e destinatário do documento fiscal, serão iguais ao cliente pagador do frete dos parâmetros 1 e 2.

Na visualização de documento de frete TMS (DT6), foi disponibilizada uma opção de visualização dos documentos de Cobrança de Serviço Adicional, rateando o valor do serviço adicional entre todas as notas vinculadas conforme o critério de rateio indicado no serviço do frete adicional. 

Integração viagem TMS x GFE

Na tabela de relacionamento de documento de carga GFE e documento de frete TMS (GWE) será gravada a identificação de origem TMS, quando da inclusão do documento de carga (GW1): Viagem e Filial de Origem.

A viagem TMS incluirá um único romaneio GFE adotando os seguintes critérios de gravação:

• O proprietário do veículo tracionador será o emitente do romaneio.
• O tipo de veículo, o tipo de operação, a classificação de frete, os municípios e o CEP de origem e destino e o veículo do romaneio serão os informados na viagem. 
• A distância do romaneio será:
  • Ou a distância (DVA) entre a região de origem da rota e a região do último documento sequenciado na viagem de entrega ou coleta.
  • Ou a distância (DVA) entre a região de origem da rota e a região da última filial de descarga sequenciada na rota da viagem de transporte.

O documento de carga GFE (GW1) será:

• Ou a solicitação de coleta, quando for viagem de coleta - tipo de documento COL.
• Ou a nota fiscal vinculada ao CTe, quando for viagem de entrega ou transporte - tipo de documento definido no parâmetro MV_TPDCTMS.
• Ambos os documentos devem ser indicados com sentido indiferente em seu cadastro.  

Somente documentos de viagem com indicação de pagamento via GFE (DTQ_PAGGFE) e/ou documentos com Redespacho Adicional (DJN) serão integrados. Quando o documento de carga já existir para a filial da viagem será incluído apenas o trecho.

Na integração de documento de carga via solicitação de coleta serão adotados os seguintes critérios:

• O remetente será ou o cliente indicado na solicitação de coleta. 
  • Ou, quando não indicado, será o cliente indicado no cadastro do solicitante da coleta.
  • Ou, quando não indicado cliente no solicitante, será a filial emitente da solicitação de coleta.
  • O destinatário será ou o cliente indicado na solicitação de coleta. 
    • Ou, quando não indicado, o destinatário será a filial emitente da solicitação de coleta.
    • O tipo do documento será fixado como 'COL', sendo exigido o cadastro prévio de tipo de documento de carga com o código especifico 'COL' no GFE.
    • A série será fixada como 'COL'.
    • O número será o número da solicitação de coleta.
    • Os itens do documento de carga serão herdados dos produtos da solicitação de coleta.
    • Ao vincular a solicitação de coleta a uma NFe, a chave da NFe será vinculada ao documento de carga GFE para processamento posterior ou do XML do CTe ou do CONEMB.

Na gravação do trecho do documento de carga serão adotados os seguintes critérios:

• Viagem de Transporte:
  • O tipo de veículo, o tipo de operação e a classificação de frete, não serão preenchidos no trecho sendo considerados, no cálculo, os dados do romaneio, pois trata-se de carga fechada de transferência entre filiais.
  • O proprietário do veículo tracionador será o transportador do trecho.
  • Os municípios de origem e destino e o CEP de origem serão os informados no movimento da viagem.
  • O CEP de destino será o indicado no movimento da viagem, ou quando não informado, será o CEP de entrega da carga, ou quando não informado o último, será o CEP do destinatário do documento de carga.
  • O trecho será pago.
  • Será gravada a filial origem e o número da viagem no trecho para identificar sua origem.

• Viagem de Entrega/Coleta:
  • Quando a viagem indicar não pagamento via GFE (DTQ_PAGGFE), ou seja, apenas o redespacho adicional (DJN), será pago via GFE, será incluído um primeiro trecho não pago para o proprietário do veículo tracionador.
  • Quando a viagem indicar pagamento via GFE (DTQ_PAGGFE):
    • O proprietário do veículo tracionador será o transportador do trecho.
    • Os municípios de origem e destino e o CEP de origem serão os informados no movimento da viagem.
    • O CEP de destino será o indicado no movimento da viagem, ou quando não informado, será o CEP de entrega da carga, ou quando não informado o último será o CEP do destinatário do documento de carga.
    • O trecho será pago.
    • O tipo de veículo, o tipo de operação e a classificação de frete não serão gravados, pois o cálculo considerará os dados do romaneio, pois trata-se de uma negociação única para todos os documentos transportados.
    • Será gravada a filial origem e o número da viagem no trecho para identificar sua origem.

• Quando houver indicação de redespacho adicional (DJN), na viagem será incluído um trecho adicional pago:
• O fornecedor do redespacho adicional (DJN) será o transportador do trecho.
• O tipo de veículo, o tipo de operação, a classificação de frete, os municípios de origem e destino e o CEP de origem, serão os informados no movimento da viagem.
• O CEP de destino será o indicado no movimento da viagem, ou quando não informado, será o CEP de entrega da carga, ou quando não informado o último será o CEP do destinatário do documento de carga.
• O trecho será pago quando indicado frete CIF e não pago quando indicado frete FOB.
• Será gravada a filial origem e o número da viagem no trecho para identificar sua origem. 

Documento da carga (GFE)

No trecho do documento de carga (GWU) foram criados campos para informe de classificação de frete, tipo de operação, município, CEP de origem, CEP de destino e para identificação de origem dos dados via TMS.

Ao processar o cálculo do romaneio será verificado se o trecho possui informe de tipo de veículo, classificação de frete, tipo de operação, município de origem, CEP de origem e destino e quando houver informe, considerar o conteúdo do trecho no agrupador de cálculo, caso contrário, considerar o conteúdo do romaneio.

Quando o transportador do trecho pago for o mesmo transportador do romaneio e houver apenas um trecho pago para esse fornecedor, será adotado, quando informado, os municípios e os CEPs de origem e destino do romaneio no cálculo. 

Documento de frete (GFE) x Custos de Transportes (TMS)

Criada funcionalidade de geração de movimento de custo de transportes TMS (SDG) para documentos de frete auditados no GFE.

O objetivo é apurar o custo total final de transportes no módulo TMS, pois, esse módulo concentrará todas as despesas relacionadas ao documento de frete TMS, quer sejam as geradas no próprio módulo, quanto as geradas no GFE. 

Ocorrência GFE x Ocorrência TMS

Criada a funcionalidade de integração online das ocorrências aprovadas para o TMS - parâmetro MV_GFEI22.

Ao aprovar a ocorrência GFE, será verificada se a mesma possui indicação de integração com o TMS. Em caso positivo e estando o parâmetro MV_GFEI22 setado para integração automática, será gerada a respectiva ocorrência no TMS.

Procedimento para Utilização

Exemplo Integrando uma viagem com o GFE

1. Em Gestão de Transportes (SIGATMS) acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod.2) (TMSA144D).
2. Selecione a opção Incluir.
3. Informe a Rota (DTQ_ROTA).
4. No campo Pagto GFE (DTQ_PAGGFE) informe '1-Sim'.
5. Preencha os demais campos conforme orientação dos helps de campo.
6. Informe os Documentos da Viagem.
   Ao informar o documento, os campos referente a integração com o SIGAGFE serão preenchidos automaticamente.
7. No campo Redespacho (DUD_REDESP), tecle <ENTER>, ou em Outras Ações clique em Redespachos da Viagem.
   Será aberta uma tela para informar os Redespachos adicionais da Viagem.
8. Selecione o código do fornecedor conforme opções disponíveis e em seguida, preencha os demais campos conforme orientação dos helps de campo.
9. Confirme os dados do Redespacho Adicional.
10. Clique em Outras Ações e selecione a opção Comp.Via.
11. Informe o veículo e o motorista da viagem.
12. Confirme os dados do complemento da viagem.
13. Confirme os dados da viagem.
14. Acesse Atualizações / Viagens / Rodoviário Entrega / Fechamento da Viagem (TMSA310).
15. Posicione na viagem e selecione a opção Fechar.
    Caso o parâmetro MV_TMS3GFE esteja configurado com o conteúdo 'F' (Fechamento da viagem), neste momento os documentos da viagem serão integrados ao SIGAGFE, gerando o Documento de Carga e vinculado a um Romaneio de Carga.
    
    

Exemplo Visualizando os documentos da viagem integrados ao GFE

1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod.2) (TMSA144D).
2. Selecione a viagem e clique na opção Visualizar.
3. Clique em Outras Ações e selecione a opção Docto Carga.
4. Serão listados os Documentos de Cliente (DTC) vinculados à viagem.
5. Posicione no Documento do Cliente, clique na opção Docto Carga.
   Serão apresentados os dados do Documento de Carga gerados no SIGAGFE.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf