Histórico da Página

...

Apontamento do Comprovante de Entrega/Coleta, possibilitando obter os dados do recebedor Recebedor ou Expedidor (Nome, Documento e a Imagem do documento assinado);

...

4. Acessar Atualizações > Ocorrências > Configurações CheckList (TMSAC10), deverá ser incluído o cadastro de configuração para uso no app Meu Checklist - neste cadastro serão informados dados como filial para integração, URL's responsáveis pela conexão da integração, usuário e senha autorizados a validar e alterar dados no Portal Checklist, entre outras informações.

Configuração Appserver.ini

O arquivo appserver.ini deve conter as chaves abaixo:

Na sessão [Environment] :

...

4. Acessar Atualizações > Ocorrências > Configurações CheckList (TMSAC10), deverá ser incluído o cadastro de configuração para uso no app Meu Checklist - neste cadastro serão informados dados como filial para integração, URL's responsáveis pela conexão da integração, usuário e senha autorizados a validar e alterar dados no Portal Checklist, entre outras informações.

Os novos campos abaixo circulados foram criados para o processo dos documentos Não Fiscais:

• Roteiro Coleta;
• Roteiro Entrega;

Image Added

Configuração Appserver.ini

O arquivo appserver.ini deve conter as chaves abaixo:

Na sessão [Environment] :

MemoMega>1
TopMemoMega=2

Além disso segue abaixo exemplo de configuração REST que deverá ser configurada:

[ONSTART]
JOBS=FW_MANAGER,FW_QUEUE,REST_JOB

[FW_MANAGER]
MAIN=FWSCHDMANAG
ENVIRONMENT=P1227

[FW_QUEUE]
MAIN=FWSCHDQUEUE
ENVIRONMENT=P1227

[REST_JOB]
MAIN=HTTP_START
ENVIRONMENT=P1227

[HTTPV11]
ENABLE=1
Sockets=HTTPREST
MAXSTRINGSIZE=500

[HTTPREST]
Port=1225
SECURITY=0
URIs=HTTPURI1
IPsBind=

[HTTPURI1]
URL=/rest
PrepareIn=T1,M SP 01
Instances=1,2
ENVIRONMENT=P1227
CORSEnable=1
AllowOrigin=*                                                                                                 

[WebApp/webapp]
MPP=

Obs.: Os exemplos acima contém apenas os valores referentes a integração com Checklist.

Para melhor aproveitamento e em caso de dúvidas recomendamos a leitura da documentação sobre REST.

              Processo Básico de Viagem no Protheus

1. Inclusão de Documentos

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

b.  Calcule o Frete para gerar um ou mais documentos do tipo Não Fiscal CTRC (lote tipo normal).

2. Inclusão da Viagem

a.  Inclua uma viagem do tipo entrega

Além disso segue abaixo exemplo de configuração REST que deverá ser configurada:

[ONSTART]
JOBS=FW_MANAGER,FW_QUEUE,REST_JOB

[FW_MANAGER]
MAIN=FWSCHDMANAG
ENVIRONMENT=P1227

[FW_QUEUE]
MAIN=FWSCHDQUEUE
ENVIRONMENT=P1227

[REST_JOB]
MAIN=HTTP_START
ENVIRONMENT=P1227

[HTTPV11]
ENABLE=1
Sockets=HTTPREST
MAXSTRINGSIZE=500

[HTTPREST]
Port=1225
SECURITY=0
URIs=HTTPURI1
IPsBind=

[HTTPURI1]
URL=/rest
PrepareIn=T1,M SP 01
Instances=1,2
ENVIRONMENT=P1227
CORSEnable=1
AllowOrigin=*                                                                                                 

[WebApp/webapp]
MPP=

Obs.: Os exemplos acima contém apenas os valores referentes a integração com Checklist.

Para melhor aproveitamento e em caso de dúvidas recomendamos a leitura da documentação sobre REST.

Processo Básico de Viagem no Protheus

1. Inclusão de Documentos

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

b.  Calcule o Frete para gerar um ou mais documentos de CT-e.

c.  Transmita o CT-e e aguarde a autorização pela SEFAZ;

2. Inclusão da Viagem

a.  Inclua uma viagem do tipo entrega por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b.  Clique em Incluir para abrir a tela de Cadastro de Viagem.

c.  Informe a rota que será utilizada.

d.  Clique em Outras Ações > Comp. via. para informar o(s) veículo(s) por meio da tela de Complemento da Viagem.

e.  Ainda na tela de Complemento da Viagem, clique em Outras Ações > Mot. Viag. para informar o motorista da viagem. Neste passo é importante incluir um motorista que esteja integrado ao processo do Checklist, conforme explicado na seção Configuração Inicial.

f.  Confirme a tela de Motorista, clicando em Salvar.

g.  Confirme a tela Complemento da Viagem, clicando em Salvar.

h.  Na tela da viagem, inclua os documentos que serão entregues por meio do grid. Pode ser utilizada a lupa pressionando a tecla F3, ao selecionar o campo Fil. Docto. Isso fará com que seja exibida a tela de seleção de documentos de transportes. Selecione os documentos que serão carregados na viagem.

i.  Com os documentos informados na viagem, clique em Salvar para confirmar os dados e gerar a viagem no sistema.

j. O processo de integração ocorrerá de acordo com a configuração do parâmetro MV_TMINTEV,  onde quando configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 3. abaixo, já quando o parâmetro estiver configurado como 2 a integração ocorrerá no Saída da Viagem sendo detalhada no item 4. abaixo:

3. Fechamento da Viagem e Integração Com My Checklist 

a.  Quando MV_TMINTEV = 1-Fechamento da Viagem.

b.  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.

c.  Neste momento será realizado o fechamento da viagem e, estando configurado a integração com o My Checklist, será realizado a inclusão de registros na tabela   DLY - Evento do Comprovante de Entrega para cada documento de CT-e.

d.  Após 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 será enviado 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.

b.  Posicione sobre a viagem incluída e acesse o menu Outras Ações > Manutenção > Operações. 

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

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

e.  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.

Processo Transbordo de Viagem no Protheus

A viagem de Socorro é utilizada para o trânsito de veículos sem carga, para situações de veículos quebrados ou na necessidade de transbordo, por exemplo.

Desta forma, no processo de viagem de transbordo quando há a integração com o Checklist, os passos 1 à 5 listados acima deverão ter sido executados previamente, entende-se que a viagem esteja com status "Em trânsito".

Neste cenário:

a. Deve existir previamente uma ocorrência cadastrada do tipo 08 - Transferência de Viagem com categoria "Por documento";

b. Mais de um cadastro de motorista vinculado ao Checklist;

1. Viagem de transbordo - entregas parciais realizadas

Supondo neste cenário a existência de uma viagem inicial integrada com processo de Checklist, onde o carregamento inicial de 5 documentos (CTe's) e no trajeto seguido ocorreram 3 entregas com sucesso, restando a assim a execução de 2 entregas para o motorista vinculado ao Checklist;

a. Inclua uma viagem do tipo Socorro por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b.  Clique em Incluir para abrir a tela de Cadastro de Viagem.

c.  Informe a rota que será utilizada.

cd.  Clique   Clique em Outras Ações > Comp. via. para informar o(s) veículo(s) por meio da tela de Complemento da Viagem.

de. Ainda   Ainda na tela de Complemento da Viagem, clique em Outras Ações > Mot. Viag. para informar o motorista da viagem. Neste passo é importante incluir um motorista que esteja integrado ao processo do Checklist e diferente do motorista da primeira viagem, conforme explicado na seção Configuração Inicial.

ef. Confirme   Confirme a tela de Motorista, clicando em Salvar.

fg. Confirme   Confirme a tela Complemento da Viagem, clicando em Salvar.

g. Retorne e posicione a viagem inicial, que continha inicialmente 5 documentos para entrega, Outras Ações > Manutenção > Reg. de Ocorrência realize o apontamento da ocorrência do tipo 08 - Transferência de Viagem para os documentos não entregues, informando a nova viagem de socorro que executará o processo de entrega dos documentos faltantes.

h. Estes documentos não ficarão pendentes para o motorista da primeira viagem na integração Checklist, sendo assim cancelados no Portal de Integração.

i. Retornando a viagem de socorro, estará com status "em aberto" e com os documentos não entregues adicionados a viagem.

j. O processo de integração ocorrerá de acordo com a configuração do parâmetro MV_TMINTEV,  onde quando configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 3. acima, já quando o parâmetro estiver configurado como 2 a integração ocorrerá no Saída da Viagem, sendo detalhada no item 4. acima.

k. Neste cenário, os documentos constantes na viagem de socorro passarão a constar no Portal e no App Mobile do Checklist vinculados ao segundo motorista e veículo (registrados no complemento da viagem de socorro).

2. Viagem de transbordo - entregas não realizadas

Supondo neste cenário a existência de uma viagem inicial integrada com processo de Checklist, onde o carregamento inicial de 5 documentos (CTe's), no trajeto seguido ocorre a quebra do veículo (viagem inicial) sendo neste cenário nenhuma entrega realizada com sucesso.

a. Inclua uma viagem do tipo Socorro por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b. Informe a rota que será utilizada.

c.  Clique em Outras Ações > Comp. via. para informar o(s) veículo(s) por meio da tela de Complemento da Viagem.

d. Ainda na tela de Complemento da Viagem, clique em Outras Ações > Mot. Viag. para informar o motorista da viagem. Neste passo é importante incluir um motorista que esteja integrado ao processo do Checklist e diferente do motorista da primeira viagem.

e. Confirme a tela de Motorista, clicando em Salvar.

f. Confirme a tela Complemento da Viagem, clicando em Salvar.

g. Retorne e posicione a viagem inicial, que continha inicialmente 5 documentos para entrega, Outras Ações > Manutenção > Reg. de Ocorrência realize o apontamento da ocorrência do tipo 08 - Transferência de Viagem para os documentos não entregues (neste cenário, todos os documentos da viagem).

h. Estes documentos não ficarão pendentes para o motorista da primeira viagem na integração Checklist, sendo assim cancelados no Portal de Integração.

i. Retornando a viagem de socorro, estará com status "em aberto" e com os documentos não entregues adicionados a viagem.

j. O processo de integração ocorrerá de acordo com a configuração do parâmetro MV_TMINTEV,  onde quando configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 3. acima, já quando o parâmetro estiver configurado como 2 a integração ocorrerá no Saída da Viagem, sendo detalhada no item 4. acima.

k. Neste cenário, os documentos constantes na viagem de socorro passarão a constar no Portal e no App Mobile do Checklist vinculados ao segundo motorista e veículo (registrados no complemento da viagem de socorro).

...

...

da Viagem, clicando em Salvar.

h.  Na tela da viagem, inclua os documentos que serão entregues por meio do grid. Pode ser utilizada a lupa pressionando a tecla F3, ao selecionar o campo Fil. Docto. Isso fará com que seja exibida a tela de seleção de documentos de transportes. Selecione os documentos que serão carregados na viagem.

i.  Com os documentos informados na viagem, clique em Salvar para confirmar os dados e gerar a viagem no sistema.

j. O processo de integração ocorrerá de acordo com a configuração do parâmetro MV_TMINTEV,  onde quando configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 3. abaixo, já quando o parâmetro estiver configurado como 2 a integração ocorrerá no Saída da Viagem sendo detalhada no item 4. abaixo:

3. Fechamento da Viagem e Integração Com My Checklist 

a.  Quando MV_TMINTEV = 1-Fechamento da Viagem.

b.  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.

c.  Neste momento será realizado o fechamento da viagem e, estando configurado a integração com o My Checklist, será realizado a inclusão de registros na tabela DM0 - Imagens Comprovante de Entrega, contudo, e diferentemente da integração com documentos eletrônicos não haverá registro na tabela DLY - Evento do Comprovante de Entrega para cada documento de CT-e.

d.  Após a inclusão dos registros na tabelaDM0 - Imagens 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 documento que será enviado 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.

b.  Posicione sobre a viagem incluída e acesse o menu Outras Ações > Manutenção > Operações. 

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

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

e.  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 DM0 - Imagens Comprovante de Entrega para cada documento.

g.  Em seguida, as informações dos documentos serão enviadas para o My Checklist;.

h.  A integração será disparada para cada documento, uma vez que cada checklist representa um documento 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 DM0 - Imagens Comprovante de Entrega com o status=1-Enviado, 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 DM0 - Imagens Comprovante de Entrega, para todos os  tipos de documentos, e na tabela DLY Evento do Comprovante de Entrega para cada documento de CT-e (eletrônico/fiscal).

Processo Estorno de Viagem no Protheus

...

Documentos são apresentados no Portal para o usuário responsável pelo acompanhamento (isso ocorrerá a partir da confirmação da integração - após o fechamento ou após a operação de saída de viagem, definidos de acordo com a configuração do parâmetro MV_TMINTEV ::

Importante: No caso de documentos do tipo Coleta a coluna de Roteiro apresentará os dados de "Data_Coleta".

Telas – Visão do Motorista (etapas no app):

...

2. Início do processo Checklist;

3. Primeira pergunta, documento entregue? No caso de documento tipo Coleta, a mensagem apresentada será: Coleta Efetuada?

4. Caso, positivo incluir evidência, neste passo o motorista deverá incluir uma foto do comprovante de entrega/coleta;

5. Segunda pergunta, informar o nome do recebedor Recebedor. No caso de documento tipo Coleta, a mensagem apresentada será: Expedidor;

6. Terceira pergunta, informar o nº de documento deste recebedor;deste Recebedor, ou no caso de Coleta deste Expedidor.

7. Tela para confirmação da finalização do Checklist.

Neste momento, após o registro do motorista:

1. O documento aparecerá com status de “Finalizado” no Portal do Checkliststatus de “Finalizado” no Portal do Checklist, tanto para os casos de entrega como para os casos de coleta.

Importante: No caso de documentos do tipo Coleta a coluna de Roteiro apresentará os dados de "Data_Coleta".

2. Ocorrerá o apontamento automático da ocorrência cadastrada no parâmetro MV_OCORENT (entrega) ou MV_OCORCOL (coleta) para os documentos constantes na viagem TMS;

...

3. Será atualizada a tabela DLY ( Eventos do Comprovante de Entrega) gravando os dados do nome, documento e a imagem inserida no Checklist.

Image Removed

Image Removed

4. Documento apto para transmissão a SEFAZ.
Podendo seguir o processo de envio do comprovante de entrega padrão.

...

, para os casos de documentos eletrônicos/fiscais, a tabela DM0 - Imagens Comprovante de Entrega, será atualizada para todos os  tipos de documentos, neste momento.

...

05. ESTORNO INTEGRAÇÃO - VISÕES: PORTAL e  APP MOBILE (MOTORISTA)

...

1. Necessário que os documentos já estejam integrados e com status "pendente de execução".
   Importante: No caso de documentos do tipo Coleta a coluna de Roteiro apresentará os dados de "Data_Coleta".

2. Após o  processo de estorno do fechamento da viagem ou estorno da operação de saída de viagem, definidos de acordo com a configuração do parâmetro MV_TMINTEV, o status do documento passará para "Cancelado":
   Importante: No caso de documentos do tipo Coleta a coluna de Roteiro apresentará os dados de "Data_Coleta".

Telas – Visão do Motorista (etapas no app):

...

Configurações CheckList (TMSAC10 - SIGATMS)

Integração Checklist x Ocorrência de Entrega Automática x Comprovante Entrega (Integrações - SIGATMS)

Automação do Apontamento de Ocorrências (TMSA360 - SIGATMS)

...