Histórico da Página

...

• No ambiente deve estar funcional a utilização dos processos de viagem (coleta e/ou entrega);
• As configurações de integração com coleta entrega devem estar realizadas;
• Configurações do Portal Coleta Entrega devem estar realizadas (acesso, configurações dos motoristas, planejadores e organizações);
• Motoristas devem ter posse de celulares com aplicativo TOTVS Logística Minha Coleta e Entrega.

   IMPORTANTE - DESPACHA VIAGEM AO MOTORISTA

Antes de iniciar a leitura dos exemplos abaixo, informamos que os exemplos foram utilizados

com o código de registro 1150 - DESPACHA VIAGEM AO MOTORISTA = SIM no layout de integração TMS x Coleta Entrega, ou seja, o envio será de forma automática ao Portal e ao APP do Motorista (atividade de despacho ao motorista).

Sendo assim o despacho manual, dentro do Portal Logístico não precisará ser efetuado. Esta configuração contudo pode ser alterada caso o cliente deseje desta forma.

Image Added

   IMPORTANTE - ENDEREÇOS CLIENTES

Para a utilização do processo de integração entre SIGAFAT x COLETA ENTREGA, recomendamos atenção ao cadastro de clientes, tabela Protheus SA1 (Clientes) com respeito as informações de Endereço.

Para correta integração, o endereço dos clientes (campo A1_END)  devem estar preenchidos conforme exemplo abaixo:

Use vírgula para separar os números e escreva-os sempre que possível em algarismos arábicos, exemplo: AVENIDA BRAZ LEME , 1000                                    

Nome do logradouro, Número, Complemento - (campo A1_END)
Nome do Bairro -  (campo A1_BAIRRO)
CEP - ( campo A1_CEP)
Nome da localidade (Cidade/Município) - (campo A1_MUN)
UF - (campo A1_EST)

Image Added

Nos casos, onde o cliente não possua numeração em seu logradouro utilizar "SN", exemplo: ROD ARTHUR BERNARDES, SN                                   

Nome do logradouro, SN, Complemento - (campo A1_END)
Nome do Bairro -  (campo A1_BAIRRO)
CEP - ( campo A1_CEP)
Nome da localidade (Cidade/Município) - (campo A1_MUN)
UF - (campo A1_EST)

Image Added

02. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM SUCESSO

2.1

...

Inclusão de Documentos

a.  Inclua um Documento de Entrada via menu Atualizações > Recebimento > Documento Entrada Clientes.

...

d. Inclua uma solicitação de coleta via menu  Atualizações > S.A.C.> Solicitações de Coleta.

2.2 Inclusão

...

da Viagem

a.  Inclua uma viagem:

Do tipo Coleta por meio do menu Atualizações > Viagens > Rodoviário Coleta> Viagens (modelo 2).
Ou do tipo Entrega por  meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2) ou ainda Atualizações > Viagens > Viagem Mod. 3> Viagem Mod. 3.

...

j. O processo de integração ocorrerá de acordo com a configuração da rotina Configuração das Integrações (TMSAI80 - SIGATMS), ou seja, de acordo com campo Envio Reg = 1=Fechamento da Viagem ou 2=Operação de Saída.  Configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 2.3. abaixo, já quando o campo estiver configurado como 2 a integração ocorrerá no Saída da Viagem sendo detalhada no item 2.4. abaixo:

2.3

...

Fechamento da Viagem e Integração

...

Com Coleta Entrega

a.  Quando a Configuração das Integrações (TMSAI80 - SIGATMS) estiver configurada: Campo Envio Reg (DN1_ENVREG) = 1=. Fechamento da Viagem.

b.  Através da viagem Rodoviário Coleta> Viagens (modelo 2) ou  Rodoviário Entrega > Viagens(modelo 2), posicione sobre a viagem incluída e acesse o menu Outras Ações > Manutenção > Fechamento > Fechar. Na tela de confirmação, clique em OK.

...

• Caso exista layout pré-definido pela TOTVS importado no ambiente e job de envio ativo (ou executado de forma manual), ocorrerá gravação da tentativa de integração com Coleta Entrega na rotina de de Histórico de Integrações (TMSAI84 - SIGATMS).

...

d.  Após Haverá a inclusão dos registros na tabela DLY - Eventos do Comprovante de Entrega será realizada a tentativa de integração com o My Checklist.

e.  A integração será disparada para cada documento , uma vez que cada checklist representa um CT-e que existente na viagem, e será enviado para o  Portal Coleta Entrega (acesso planejador) assim como para o App Mobile do  Checklist.

f. Será apresentado alerta informando que a integração ocorreu com sucesso, listando os documentos que foram integrados.

4.  Saída da Viagem e Integração Com My Checklist

a.  Quando MV_TMINTEV = 2-Saída da Viagem.

Minha Coleta Entrega (Motorista):

f. Apontar o operação de saída de viagem.

Através da viagem Rodoviário Coleta> Viagens (modelo 2) ou  Rodoviário Entrega > Viagens(modelo 2), posicione b.  Posicione sobre a viagem incluída e acesse o menu  Outras Ações > Manutenção > Operações. 

c.  Na tela de de Apontamento de Operações, selecione  selecione a operação de de Saída de Viagem e clique em Apontar.

d.  Informe os campos de de Dt. Início/Hr .Início e  e Dt. Realizada/Hr. Realizada.

Clique em Confirmar para registrar o apontamento de Saída.

Ou

Caso utilizado a Viagem Mod. 3., através da rotina principal de Viagem Modelo 3 acesse a Aba Operações da Viagem, posicione na operação de Saída de Viagem e clique no botão Apontar.

Informe os campos de Dt. Início/Hr .Início e Dt. Realizada/Hr. Realizada.

Clique em Confirmar para .  Clique em Confirmar para registrar o apontamento de Saída.

f.  Após a confirmação do apontamento será realizada a tentativa de integração com o My Checklist, ocorrendo primeiro a inclusão de registros na tabela DLY - Evento do Comprovante de Entrega para cada documento de CT-e.

g.  Em seguida, as informações do CT-e serão enviadas para o My Checklist;.

h.  A integração será disparada para cada documento, uma vez que cada checklist representa um CT-e que será enviado para o App Mobile do Checklist.

i.   Será apresentado alerta informando que a integração ocorreu com sucesso, listando os documentos que foram integrados.

5. Atualização dos Dados do Comprovante de Entrega Via JOB

a.  A sincronização dos dados via Job é realizada ao configurar a rotina TMSAE81B - Sincronizador Checklist x Comprovante de Entrega via módulo Configurador (SIGACFG).

b.  Uma vez no módulo Configurador, acesse a interface do Schedule pelo caminho Ambiente > Schedule > Schedule.

c.  Siga os passos descritos na seção 02.CONFIGURAÇÕES > Schedule.

d.  O Job se encarrega de realizar as seguintes tarefas: 

i.  Lista os registros da tabela DLY - Eventos do Comprovante de Entrega com o status=0-Integrado, verificando se existem apontamentos realizados via App My Checklist;

ii.  Efetua a integração com o Checklist, caso não tenha ocorrido a integração no momento da fechamento da viagem ou na saída de viagem de acordo com a configuração do parâmetro MV_TMINTEV.

iii. Efetua o apontamento de ocorrências de entrega no Módulo TOTVS Logística TMS e por fim atualiza as informações de recebedor, documento e imagem da tabela DLY Evento do Comprovante de Entrega para cada documento de CT-e.

03. TABELAS UTILIZADAS

2.4 VISÃO MOTORISTA

Após o recebimento da tarefa  (Entrega / Coleta)	Confirmação do App  para deslocamento	Será disponibilizado opções de apps de  navegação	Em caso de cancelamento de apps de navegação, liberadas ações	Cheguei no local	Confirmação chegada no local	Para o caso de entrega: 3 fotos, nome do recebedor, documento, relato, assinatura. Para o caso de Coleta: 3 fotos e relato.	Assinatura no aplicativo mobile A coleta d assinatura não é obrigatória.	Processo finalizado.	Confirmação final.
Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added

2.5 VISÃO PLANEJADOR PORTAL

g. No Protheus, com o job de retorno ativo (ou executado de forma manual), ocorrerá gravação das ocorrências definidas na rotina de  Configuração das Integrações (TMSAI80 - SIGATMS).

Image Added

2.4  Saída da Viagem e Integração Com Coleta Entrega

Ao realizar o processo de integração com integração no apontamento da operação de saída, o processo será o mesmo descrito anteriormente contudo:

a. Quando a Configuração das Integrações (TMSAI80 - SIGATMS) estiver configurada: Campo Envio Reg (DN1_ENVREG) = 2. Saída de Viagem.

b. A integração ocorrerá no apontamento de operação de saída de viagem.
Caso exista layout pré-definido pela TOTVS importado no ambiente e job de envio ativo (ou executado de forma manual), ocorrerá gravação da tentativa de integração com Coleta Entrega na rotina de Histórico de Integrações (TMSAI84 - SIGATMS).

c. Demais informações permaneceram as mesmas detalhadas no item 2.3.Fechamento da Viagem e Integração Com Coleta Entrega.

03. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM INSUCESSO

Diferente da integração predecessora SIGATMS x Meu Checklist, a integração SIGATMS x Coleta Entrega permite o registro de insucesso nas viagens para documentos do tipo solicitação de coleta e entrega.

Ocorrerá a integração e processos de forma idêntica até o item f. da documentação anterior, ou seja, criação de documentos, viagem, fechamento de viagem ou operação de saída para integração, execução de job de envio e deslocamento do motorista ao cliente.

A partir disto, segue abaixo uma simulação de insucesso:

3.1 VISÃO MOTORISTA

2.5 VISÃO PLANEJADOR PORTAL

Além disso, o portal manterá o registro do documento com insucesso (3.) para consulta m Menu lateral Col.Ent (1.), aba Finalizadas com insucesso (2.):

Image Added

No Protheus, com o job de retorno ativo (ou executado de forma manual), ocorrerá gravação das ocorrências definidas para insucesso na rotina de  Configuração das Integrações (TMSAI80 - SIGATMS).

Image Added

04. EXEMPLOS DE UTILIZAÇÃO - ESTORNO DE VIAGEM INTEGRADA E NÃO INICIADA

O processo de estorno da integração também ocorrerá de acordo com a configuração do campo Envio Reg (DN1_ENVREG) = 1. Fechamento ou u 2. Saída de Viagem na rotina Configuração das Integrações (TMSAI80 - SIGATMS).

4.1 PROCEDIMENTO

Quando há utilização do layout pré-definido pela TOTVS importado no ambiente, o código de registro 1150 - DESPACHA VIAGEM AO MOTORISTA envia de forma automática ao Portal e ao APP do Motorista a atividade de despacho ao motorista.

Nesta situação, para prosseguir com estorno no SIGATMS, deve ser realizado inicialmente no Portal o procedimento a seguir:

1. Acessar o Portal Coleta Entrega e e o menu lateral Acompanhamento de Viagens;
2. Posicionar sobre o registro que deve estar com status "Aguardando confirmação de despacho";
   Image Added
   
   
3. Posicionar sobre os três pontos (a.) e depois clicar na opção "Estornar despacho";
   Image Added
   
   
4. Confirmar. A partir deste momento, pode ser realizado o estorno do Fechamento da Viagem ou estorno da Operação de Saída no SIGATMS Protheus.
   

Image Added

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

Demonstraremos neste tópico - exemplos de uso dos campos  Busca Entrega Realizada e Busca Entrega Não Realizada configuradas com as opções: 

Campo: Busca Entrega Realizada = MOTORISTA

Neste exemplo: Para uma determinada organização, as ocorrências ou tarefas concluídas com sucesso precisam ser registradas em tempo real. Ou seja, assim que o motorista sinaliza a conclusão da tarefa, a ocorrência é imediatamente retornada ao Protheus SIGATMS. No entanto, para essa mesma organização, as ocorrências de insucesso devem passar por uma auditoria ou avaliação de um planejador, a fim de revisar e melhorar os processos operacionais, visando reduzir os índices de falha na conclusão das entregas.

Inicialmente acessar: Miscelânea > Integrações > Configuração das Integrações

A rotina de Configuração das Integrações trata-se de um centralizador de integrações.

Image Added

Após a configuração, seguir com processo de viagem. 

O processo de viagem com sucesso esta detalhado no tópico 02. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM SUCESSO desta documentação.

Após o processo de integração com Coleta Entrega (integração no fechamento da viagem ou na operação de saída), seguir para o passo de conclusão de tarefas no app do motorista:

A integração será disparada para cada documento existente na viagem, e será enviado para o Coleta Entrega (acesso planejador) assim como para o App Mobile do Minha Coleta Entrega (Motorista):

VISÃO MOTORISTA

Após a finalização da tarefa pelo motorista.

Retornar ao Protheus SIGATMS, e após a execução do JOB de Retorno (JOBS: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS), mesmo sem efetuar Prestação de Contas ou Encerramento da Viagem no Coleta Entrega, a ocorrência retornará em tempo de execução:

Sendo assim,  proporcionará maior agilidade no processamento de retorno das ocorrências da integração, não engessando operação logística com obrigatoriedade de execução dos demais passos.

Campo: Busca Entrega Não Realizada = SUPERVISOR

Dando continuidade ao exemplo, onde uma determinada organização, as ocorrências ou tarefas concluídas com sucesso precisam ser registradas em tempo real. Ou seja, assim que o motorista sinaliza a conclusão da tarefa, a ocorrência é imediatamente retornada ao Protheus SIGATMS. No entanto, para essa mesma organização, as ocorrências de insucesso devem passar por uma auditoria ou avaliação de um planejador, a fim de revisar e melhorar os processos operacionais, visando reduzir os índices de falha na conclusão das entregas.

O processo de viagem com sucesso esta detalhado no tópico 03. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM INSUCESSO desta documentação.

Após o processo de integração com Coleta Entrega (integração no fechamento da viagem ou na operação de saída), seguir para o passo de conclusão de tarefas no app do motorista:

A integração será disparada para cada documento existente na viagem, e será enviado para o Coleta Entrega (acesso planejador) assim como para o App Mobile do Minha Coleta Entrega (Motorista):

VISÃO MOTORISTA

Após a finalização da tarefa de insucesso pelo motorista.

Neste cenário, como o campo Busca Entrega Não Realizada = SUPERVISOR, será necessário a ação do planejador do Coleta Entrega, realizando prestação de contas para que o retorno da ocorrência possa retornar ao Protheus SIGATMS.

Desta forma:

Neste momento, mesmo sem encerrar a viagem no Coleta Entrega, no Protheus SIGATMS após a execução do JOB de Retorno (JOBS: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS), a ocorrência do tipo retorna documento será registrada:

Image Added

Neste cenário, existe 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.

06. TABELAS UTILIZADAS

• 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 do Histórico

07. ASSUNTOS RELACIONADOS

• Integração Coleta Entrega (SIGATMS)
• Fontes de Integração (TMSAI81 - 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)
• JOBS: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS)
• Exporta e Importa Layout (TMSAI88A / TMSAI88B - SIGATMS)
• Exemplos de Utilização - Viagens Integradas SIGATMS x Coleta Entrega (SIGATMS)
• Pontos de Entrada da Integração (SIGATMS)
• Melhorias na Integração TMS x Coleta Entrega (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>