Histórico da Página
CONTEÚDO
Índice | ||||
---|---|---|---|---|
|
01. VISÃO GERAL
O aplicativo Meu Check List permite que sistemas externos produzam Check Lists (listas de verificações) para serem apontados via mobile - na integração entre o Módulo TOTVS Logística TMS e o App Meu Check List, esta rotina permite complementar o processo de Apontamento do Comprovante de Entrega, possibilitando obter os dados obrigatórios para a transmissão do evento de comprovante de entrega para a SEFAZ (Secretaria da Fazenda).
Atualmente os dados considerados obrigatórios seguindo a NT 2019.001 para a transmissão do evento do comprovante de entrega são:
- Descrição do Evento;
- Número do protocolo de autorização do CT-e;
- Data e Hora da Conclusão da Entrega;
- Documento de identificação da pessoa que recebeu a entrega;
- Nome da pessoa que recebeu a entrega;
- HashEntrega: Refere-se a concatenação de Chave de acesso do CT-e + Base64 da imagem capturada da entrega (Exemplo: imagem capturada da assinatura eletrônica, digital do recebedor, foto, etc);
- Data e hora da geração do hash da entrega;
- Chave de acesso da NF-e que está sendo entregue.
Card documentos Informacao O evento exige CT-e autorizado. Desta forma, para que o envio de informações referentes ao comprovante de entrega seja transmitido a SEFAZ o documento CTe deve estar previamente autorizado. Titulo IMPORTANTE!
02. CONFIGURAÇÕES
Parâmetros
Para habilitar a integração do My Checklist com o Comprovante de Entrega, é necessário configurar os seguintes parâmetros:
- MV_TMAPCKL: com o valor .T. (Habilitado).
- MV_TMINTEV: com o valor 1-Fechamento da Viagem ou 2-Saída de Filial. Para definir quando será iniciada a integração com o Checklist.
- MV_OCORENT: define a ocorrência de entrega no apontamento automático de ocorrências. A integração utiliza esse parâmetro para apontar a ocorrência do tipo encerra processo, ao processar o retorno do documento entregue.
Schedule
Para o perfeito funcionamento do Checklist é necessário que haja a sincronização dos dados apontados via aplicação App Mobile do My Checklist.
O sincronismo ocorre por meio do Job localizado na rotina Sincronizador da Integração do My Checklist X Comprovante de Entrega (TMSAE81).
Para a configuração do Job, acesse o módulo Configurador (SIGACFG) do Protheus e execute os seguintes passos:
1. Configuração do Agente do Schedule
a. Acesse o Agente do Schedule via menu Ambiente > Schedule > Schedule.
b. No menu lateral, clique no ícone Agent e, em seguida, na opção Cadastro.
c. Na parte inferior da tela Detalhes, clique no ícone representado por uma página com o sinal de mais , preenchaos campos, conforme quadro Campos Agent Schedule detalhado logo abaixo.
d. Salve o cadastro, clicando no ícone representado pela imagem de check na cor verde .
Campos Agent Schedule | |
---|---|
Campo | Descrição |
Nome | Informe o nome do agente que faz o gerenciamento das execuções das threds/jobs agendados. Exemplo: |
IP | Informe o IP do servidor, que deve ser o mesmo que está executando o Appserver. Também pode ser o localhost ou o nome da máquina servidora. |
Porta | Informe a mesma porta de execução do Appserver que fará o controle de execução dos Jobs. |
Ambiente | Informe o ambiente configurado no Appserver.ini. |
Empresa | Informe o grupo da empresa. Utilize a lupa para selecionar o código da empresa. |
Nº de Threads | Informe a quantidade de Threads que será gerenciada pelo agente do Schedule. É permitido executar em paralelo uma ou mais rotinas. Exemplo: |
Habilitado | Quando assinalado, o Agente é habilitado na próxima vez que o Appserver for iniciado. |
2. Configuração do Job
a. Acesse o Cadastro de Agendamentos de Rotinas via menu Ambiente > Schedule > Schedule.
b. No menu lateral, clique no ícone com o título de Agendamentos para expandir;.
c. Ainda em Agendamentos, clique em Cadastro.
d. Na parte inferior da tela Detalhes, clique no ícone representado por uma página com o sinal de mais .
e. Para incluir um novo registro, preencha os campos, conforme o quadro Campos Cad. Job.
f. Salve o cadastro, clicando no ícone representado pela imagem de check na cor verde .
Campos Cad. Job | |
---|---|
Campo | Descrição |
Usuário | Código do usuário que tenha direitos de Administrador. Utilize o botão representado por uma lupa para abrir a lista de usuários. |
Rotina | Nome da rotina do Job. Informe a rotina TMSAE81B (rotina de sincronismo da Integração do My Checklist x Comprovante de Entrega). |
Data | Informe a data de início da execução do Job no formato DD/MM/YYYY. Exemplo: |
Hora | Informe a hora que será iniciada a execução da rotina, deve estar no formato HH:MM. Exemplo: 10:07. |
Ambiente | Informe o ambiente configurado do Appserver. |
Empresa/Filial | Informe o grupo de empresa e Filial. Utilize a lupa ao lado do campo para abrir a tela de Wizard, para seleção da empresa e filial. |
Módulo | Informe o código do Módulo que, neste caso, deve ser o 43 - TMS Gestão de Transporte. |
Habilitada | Quando assinalado, indica que o Job está habilitado. |
Descrição | Texto livre. Por sugestão pode ser informado "Job de sincronismo dos apontamentos realizados pelo App My Checklist para complementar os dados do Comprovante de Entrega". |
03. EXEMPLO DE UTILIZAÇÃO
No exemplo a seguir serão descritos os passos necessários para a utilização da integração do My Checklist x Comprovante de Entrega:
Card documentos Informacao O processo de integração com Check List ocorre somente em viagens de entrega. Titulo IMPORTANTE!
Configuração Inicial
- Habilite a integração por meio do parâmetro MV_TMAPCKL, alterando o seu valor para .T. (true=habilitado), conforme explicado na seção 02.CONFIGURAÇÕES. A integração pode ocorrer em dois momentos distintos e depende da configuração do parâmetro MV_TMINTEV mencionado na seção 02.CONFIGURAÇÕES, sendo: 1 - no Fechamento da Viagem ou 2 - na Saída de Filial.
- Certifique-se que o parâmetro MV_OCORENT está configurado com o código de Ocorrência do tipo Encerra processo e que a ocorrência também esteja configurada para gerar Comprovante de Entrega, campos Comp .Entrega DT2_CMPENT = '1' e Tipo DT2_TIPOCO='01'. Além disso a Categoria da ocorrência DT2_CATOCO = deverá ser "1 - Por Documento".
- Deverá existir ao menos um cadastro de motorista que esteja integrado ao Check List, para isto na rotina Cadastro de Motoristas (OMSA040), acessar a aba "Outros" e no campo Login App (DA4_APPLOG) vincular o ID de integração com Checklist
- 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 Check List, entre outras informações.
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 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 Check List, 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 o 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. Liste 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. Efetue 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.
Processo Transborde 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;
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. 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 Check List 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.
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 Check List 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).
04. TABELAS UTILIZADAS
- DLZ - Configurações Check List
- DLY - Eventos do Comprovante de Entrega
- DM0 - Imagens Comprovante de Entrega
- DT2 - Tabelas de Ocorrências
- DT6 - Documentos de Transporte
- DTQ - Viagens
05. ASSUNTOS RELACIONADOS
HTML |
---|
<!-- 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> |