Histórico da Página

Image Modified

CONTEÚDO

01. VISÃO  VISÃO GERAL

Foi realizado a inclusão de melhorias para o processo da Integração entre TOTVS Logística TMS e Coleta Entrega (SAAS).

Desta maneira, o processo de integração conta com as novas funcionalidades:

• Envio de latitude/longitude do local de entrega, constante no envio do comprovante de entrega ao TSS.
• Leitura de chaves ou QRCode da DANFE na coleta.
• Envio de PDF de documentos eletrônicos ao Portal Coleta Entrega (DACTE e DAMDFE).

02. ENVIO LATITUDE - LONGITUDE LOCAL DE ENTREGA

Rotina ajustada para tratar corretamente os dados de latitude e longitude e enviar ao SEFAZ, constante  constante no envio do comprovante de entrega ao TSS.

Pré-requisitos:

• Ambiente atualizado com fontes de integração TMS x Coleta Entrega;
• Ambiente atualizado com as configurações de captura e armazenagem de posicionamento GPS nas tabelas de Posicionamento (DAV) e Entidade x Coordenada Geoproc (DAR), além de validar parâmetro MV_CHKMAPA e configurações de WebService para acesso do arquivo "openstreet.html";

Exemplo de utilização:

• Possuir uma viagem criada e integrada com coleta entrega, onde já exista a ocorrência de entrega para documento eletrônico:

  * Clique para ampliar as imagens:

  Viagem	Portal SAAS
  Image Modified	Image Modified

• Com a viagem encerrada no Portal Coleta Entrega e com Ocorrência registrada no SIGATMS, realizar o processo de monitoramento comprovante de entrega (TMSAE71A).
  
  Image Modified
  
  Selecione o documento e clique na opção "transmitir":
  Image Modified
• Aguarde alguns instantes e acione o botão de "Refresh" para verificar se o comprovante está autorizado. 
  
  Image Modified
  
  
• Com o comprovante com  Status “Autorizado” acione o botão “Obter XML” para conferir que o comprovante foi enviado com os dados de latitude e longitude.

           Image Modified

• No Portal Coleta Entrega, ao consultar localização também será possível verificar latitude e longitude do local de entrega:
  
  Image Modified

03. LEITURA CHAVE OU QRCODE DANFE NA COLETA

A Leitura de chaves DANFE na coleta, possibilitará:

• • Baixar os dados de DANFE do apontamento de Coleta realizada no SaaS.
  • Gravar os dados na tabela (DMH) complementar de prévia de coleta (Conferência de Coleta - rotina TMSA461).

Pré-requisitos:

• • Ambiente atualizado com fontes de integração TMS x Coleta Entrega.
  • Configuração Busca de XML de NF-e (TMSAC17 - SIGATMS);
    
    

Configuração Opcional:

• MP - TMS - TMSAE80 Importação de Notas Fiscais - XML

Exemplo de utilização:

• • Possuir uma viagem criada e integrada com coleta entrega, onde existam uma ou mais solicitações de coleta atribuídas ao motorista.
    Image Added
    
    

  • Processo de integração executado (Job de Envio (TMSAI86).
  • No Portal Coleta Entrega SAAS, realizar as coletas com a leitura dos códigos de barras ao final do processo.
    Image Added
    
    
  • Executar o Job de Retorno (TMSAI87).
  • Quando encontrado o XML da NFe na SEFAZ, através do Job (TMSAC17) ou do processo manual, automaticamente o arquivo será gravado na pasta XMLNFE\NEW referente a importação do EDI (Clique aqui para saber mais sobre configuração do EDI). Este arquivo ficará disponível para ser importado para a tabela DE5 (EDI - Notas Fiscais).
  • Na rotina de Conferência de Coleta (TMSA461), todas as coletas que tiveram código de DANFE lidos devem estar registradas.
    Image Added
    
    
  • Em visualizar podemos conferir os códigos lidos. 
    Image Added

04. ENVIO DE PDF's DE DOCUMENTOS ELETRÔNICOS AO PORTAL COLENT (DACTE/DAMDFE)

Melhoria disponibilizada para o envio ao portal SaaS Coleta Entrega associando o DACTe às tarefas e o DAMDFe à viagem.

Documentos DACTe e DAMDFe serão disponibilizados quando corretamente configurados como:

1. Anexos PDF;
2. Código de barras;
3. QR CODE 

Pré-requisitos:

• Ambiente atualizado com fontes de integração TMS x Coleta Entrega;
• RDMAKES de impressão (DACTE e DAMDFE) atualizados e compilados no ambiente;
• Layouts 01 (TMS Coleta Entrega) e 06 (TMS Manifesto X Coleta Entrega) atualizados no ambiente.
  
  

Exemplo de utilização:

• Possuir uma viagem criada e integrada com coleta entrega (para motorista vinculado à integração) com um ou mais documentos eletrônicos (CTe), carregar e fechar a viagem.
  Image Added
  
  
• Gerar e autenticar/autorizar o MDFe na viagem:
  Image Added
  
  Image Added
  
  
• Para conferir o processo acessar: Miscelânea> Integrações> Histórico de Integrações.
  Conferindo o histórico, foram gerados dois processos que serão integrados:
  
  1. A viagem;
  2.Manifesto da Viagem
  
  Image Added
  
  
• Processo de integração executado (Job de Envio (TMSAI86 - verificar se não há erros na execução).
  
  

• Após a execução do JOB sem erros, será possível consultar a viagem no Portal Coleta Entrega com todos anexos:
  
  DACTE
  
  Image Added
  
  

• Acesse a sessão "Anexos Tarefas":
  Image Added
  
  Detalhes do anexo (DACTE):
  Image Added

• QRCode:
  Image Added
  
  
• Código de Barras:
  Image Added

DAMDFE

Para consulta de uma viagem que possua MDFE / DAMDFE:

• Acesse a sessão "Anexos da Viagem":
  Image Added
  
  
• Clique em visualizar:
  Image Added
• Serão disponibilizados detalhes dos anexos:

           Image Added

• QRCode:
  Image Added
  
• Código de Barras:
  Image Added

DOWNLOAD DE ANEXOS:

Para a realização de download de anexos o procedimento será o mesmo para DACTE e DAMDFE.

Na sessão de "Detalhes anexo" de cada documento (Dacte ou Damdfe), haverá o botão/opção "Visualizar Anexo" ao selecionar esta opção o arquivo estará disponível para gravação em disco.

05. NOVA TELA DE HISTÓRICO DE INTEGRAÇÕES

A tela da rotina Histórico de Integrações foi reestruturada para melhorar sua eficiência e oferecer uma experiência mais amigável e intuitiva ao usuário.

Para conferir a nova tela, acessar: Miscelânea> Integrações> Histórico de Integrações.

A tela foi dividida em 02 Grids sincronizados, onde:

• Grid superior seleciona o processo;
• Grid inferior demonstra os registros deste processo.

Image Added

Utilizando-se do botão visualizar na tela principal da rotina ou realizando um duplo click em uma linha do grid  superior será apresentada a tela legada da rotina de Histórico de Integrações:

Image Added

Porém, ao realizar um duplo click no grid inferior será apresentada a nova tela de detalhes dos registros (clique na imagem para ampliar).

Onde:

1. Número do registro e sequência;
2. Chave do registro;
3. Descrição do registro posicionado.
4. Campo MEMO com retornos SaaS do registro.
5. Demonstrativo do arquivo Json montado para este registro.

Image Added

DEMOSTRATIVO DE PROCESSO GERADO, SEM ENVIO

Processos não integrados permanecerão com status Azul - Não integrado.

Image Added

Image Added

DEMOSTRATIVO DE REGISTRO COM ERRO NA INTEGRAÇÃO

Ao selecionar um processo com erro no envio da integração, será mais fácil identificar o registro responsável pelo problema.

Posicionando no processo com status Erro envio no grid superior e validando no grid inferior o registro com o mesmo status, ou seja, Erro envio.

Image Added

Ao utilizar o duplo clique sobre o registro, é possível ver diretamente os detalhes sobre o erro no campo MEMO de Histórico da Integração:

Image Added

DEMOSTRATIVO DE REPROCESSO

O reprocesso mantêm-se na tela principal, botão Outras Ações.

Com um registro de processo com erro é possível acionar a opção de reprocesso direto na tela principal, clicando no botão Outras Ações > Reprocessa.

Image Added

Acesse a opção Visualizar de um processo com erro:

Image Added

Duplo clique em registro com erro e Editar Registro.

Esta opção de editar o registro não foi redesenhada nem facilitada pois deve ser utilizada apenas em casos específicos.

Corrigir o campo com erro, digitando no campo e confirmando.

Image Added

Campos são abertos para edição e correção, ajuste.

Clique em Confirmar.

Image Added

Image Added

Clique em SIM, caso o problema seja corrigido com a alteração efetuada o registro será enviado e integrado com sucesso.

Image Added

06. DISPONIBILIZADAS NOVAS OPÇÕES PARA O MOMENTO DE BUSCA DE OCORRÊNCIAS

Foram disponibilizadas novas opções para o momento de busca de ocorrências na rotina de Configuração das Integrações (TMSAI80 - SIGATMS).

Campos alterados e com todas as opções liberadas para uso:

1. Bsc E Real -  Busca Entrega Realizada. Indica o momento de busca das entregas realizadas.
   

   São aceitos:

   1=Motorista,

   2=Supervisor,

   3=Encerramento.

   Além da opção 3 = Encerramento as novas opções 1=Motorista e 2=Supervisor também foram liberadas para uso.  Sendo demonstradas o uso no item 07. desta documentação.
   
   Image Added
   

   
   
2. Bus Ent N Re - Busca Entrega Não Realizada.  Indica o momento de busca das entregas não realizadas. 
   
   São aceitos:

1=Motorista,

2=Supervisor,

3=Encerramento.

Além da opção 3 = Encerramento as novas opções 1=Motorista e 2=Supervisor também foram liberadas para uso.  Sendo demonstradas o uso no item 07.

...

desta documentação.

Image Added

Em resumo, o primeiro campo configura a confirmação de entrega e define o momento em que as ocorrências das tarefas marcadas como sucesso no Coleta Entrega serão registradas. Já o segundo campo determina o mesmo para as tarefas classificadas como insucesso.

AÇÕES x CONFIGURAÇÕES

Quando os campos deBusca Entrega Realizada e Busca Entrega Não Realizada estão configuradas como:

1. MOTORISTA - Indica que, o retorno da ocorrência no processo da integração ocorrerá no momento em que o motorista apontar o sucesso ou insucesso na conclusão de sua tarefa, ou seja, não haverá validação/obrigatoriedade da execução do processo de Prestação de Contas ou do Encerramento da Viagem no Coleta Entrega. 
   
   Vantagem: Retorno das ocorrências em tempo de execução, proporcionando maior agilidade no processamento de retorno das ocorrências da integração.
   
   
2. SUPERVISOR - Indica que, o retorno da ocorrência no processo da integração ocorrerá após a avaliação de um 'Planejador' no Coleta Entrega. Desta maneira, após  o motorista apontar o sucesso ou insucesso na conclusão de sua tarefa, haverá validação/obrigatoriedade da execução do processo de Prestação de Contas no Portal do Coleta Entrega, somente após esta etapa/aprovação haverá o retorno da ocorrência no processo da integração.
   
   Vantagem: Maior segurança na avaliação das evidências de conclusão das tarefas e da sua qualidade, após o envio pelo motorista à Central de Acompanhamento de Tarefas e Entregas do portal Coleta Entrega.
   
   
3. ENCERRAMENTO - Indica que, o retorno da ocorrência de  sucesso ou insucesso no processo da integração ocorrerá somente após o encerramento da viagem por um  'Planejador'  no Coleta Entrega. 

Vantagem: Garantia que o processo de viagem e ocorrência estarão devidamente encerrados no Portal do Coleta Entrega antes do efetivo envio das ocorrências ao Protheus SIGATMS. 

É importante lembrar que a configuração dos campos inicialmente foi desenvolvida com a opção de ENCERRAMENTO por padrão.

07. EXEMPLO DE USO NOVAS OPÇÕES PARA O MOMENTO DE BUSCA DE OCORRÊNCIAS

Despenalizamos na documentação de Exemplos de Utilização - Viagens Integradas SIGATMS x Coleta Entrega (SIGATMS) exemplos de uso dos campos Busca Entrega Realizada e Busca Entrega Não Realizada configuradas com as opções: 

MOTORISTA → Campo: Busca Entrega Realizada = MOTORISTA

SUPERVISOR →Campo: Busca Entrega Não Realizada = SUPERVISOR

08. EXEMPLO DE UTILIZAÇÃO - INSERÇÃO DE DOCUMENTOS COM VIAGEM EM TRÂNSITO

Neste exemplo, haverá uma viagem já integrada, com status em trânsito tanto para o SIGATMS como para o Coleta Entrga:

Image Added

No Protheus SIGATMS, acessar a viagem alterando e adicionando uma nova coleta.

Image Added

Na confirmação da viagem haverá um novo processamento de integração:

Image Added

No Coleta Entrega, ao atualizar a viagem, deverá apresentar a nova coleta na viagem:

Image Added

APP MOTORISTA

Segue exemplo da atualização no app do motorista:

09

...

. TABELAS UTILIZADAS

• DM0 - Imagens Comprovante de Entrega
• DA4 - Motoristas
• DN0 - Configuração das Integrações  
• DN1 - Config Integr Coleta/Entrega  
• DN2 - Tipos de Registro             
• DN3 - Layout dos Registros  
• DN4 - Relacionamento entre Registros
• DN5 - Histórico de Integrações      
• DN6 - Fontes de Integração  
• DN7 - Integrações do Motorista
• DN8 - Filiais Externas          
• DNB - Herança  Herança ID Externo
• DNC - Cabeçalho  Cabeçalho do Histórico

...

10. ASSUNTOS RELACIONADOS

• Integração Coleta Entrega (SIGATMS)

• Configuração das Integrações (TMSAI80 - SIGATMS)
• Filiais de Integração (TMSAI85 - SIGATMS)

• Layouts de Integrações (TMSAI82 - SIGATMS)

• Chaves Protheus e Portal (TMSAI83 - SIGATMS)

• Histórico de Integrações (TMSAI84 - SIGATMS)

• Exporta e Importa Layout (TMSAI88A / TMSAI88B - SIGATMS)

• JOBS: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS)
• Cadastros de Motoristas - Integração SIGATMS x Coleta Entrega (OMSA040 - SIGATMS)
• Exemplos de Utilização - Viagens Integradas SIGATMS x Coleta Entrega (SIGATMS)
• Pontos de Entrada da Integração (SIGATMS)

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>