Histórico da Página

...

Informações

title	IMPORTANTE

O processo de Comprovante de Entrega (Manual) deve estar previamente funcional, pois a integração utiliza-se das tabelas pré-existentes, executando a atualização (criação de campos novos).

O processo de integração com Checklist ocorre somente em viagens de entrega.

...

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 Checklist, 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.

Informações

title	ImportanteIMPORTANTE

O motorista deverá estar integrado ao Portal do Checklist Checklist com perfil executor para que a integração ocorra corretamente.

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] :

...

Deverá existir na configuração do Portal do Checklist um roteiro/script denominado "Data_Entrega" o TMS Protheus não irá enviar o cadastro do roteiro para que o aplicativo crie automaticamente, essa inserção deve ser manual.

Segue abaixo demonstração:

Acessar a opção "Roteiro" no Portal do Checklist:
1.1 Inserir novo roteiro;
1.2 Após inserção é possível visualizar as versões incluídas, no ícone à direita da imagem:
1.3 É importante que o status do roteiro incluído esteja "Publicado" para o correto funcionamento.
Image Added
As perguntas do roteiro Data_Entrega devem ser configuradas conforme à seguir:
Image Added

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] :

MemoMega>1
TopMemoMega=2

Aviso

title	Importante

Existe uma Tag no arquivo Appserver.ini do Protheus denominada MaxStringSize. Esta Tag determina o tamanho máximo de uma variável do tipo character em megabytes. Assim quando esta Tag estiver configurada com "MaxStringSize = 10", por exemplo, o Protheus aceitará variáveis de no máximo 10 megabytes. Dependendo da configuração do aparelho mobile que irá registrar o checklist e sua evidência (foto), esta variável pode exceder seu tamanho causando erro fatal no sistema. Sendo assim, é necessário que se ajuste a configuração no aparelho mobile, do tamanho da foto que será registrada. Para isso acesse as configurações do aplicativo de foto de seu aparelho mobile, ajustando para um tamanho inferior ao da Tag MaxStringSize de seu Appserver.ini.

No caso de Envio de Imagem com Tamanho Incorreto:

Quando for detectado que houve o envio de imagem com tamanho incorreto (falha na configuração do tamanho da imagem) será necessário seguir os seguintes procedimentos para devida correção e para que o processo de integração não fique "travado", pois uma vez encaminhada imagem/foto com tamanho superior ao configurado no Appserver.ini , todos os demais Checklists encaminhados posteriormente na integração não serão atualizados no TMS Protheus até que a configuração seja corrigida.

Passo à passo:

Ajustar a configuração no Appserver.ini e no aparelho mobile (devem estar configurados com o mesmo tamanho de qualidade de imagem);
Deverá ser acessado o Portal Meu Checklist e localizado no histórico a integração efetuada com imagem com tamanho superior ao configurado no Appserver.ini - esse registro deverá ser excluído.

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_

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

...

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.

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

Aviso

title	Alerta de risco

Fique atento ao utilizar o parâmetro de configuração com a chave Security=0, pois isso fará com que as integrações (APIs) não exijam autenticação, consequentemente dados do seu ambiente poderão ser consultados sem qualquer controle de autorização.

Processo Básico de Viagem no Protheus

...

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.

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

Informações

title	Importante:

Se a viagem de socorro possuir o status "Em trânsito" o envio do Checklist dos documentos ainda não entregues para o motorista da nova viagem se dará no momento do apontamento da ocorrência do tipo 08 - Transferência de viagem, já que a viagem do tipo socorro não mais possuirá o processo de fechamento ou o apontamento da operação de saída.

Processo Estorno de Viagem no Protheus

O processo de estorno de viagem quando há a integração com o Checklist é o mesmo processo quando não há a integração ativa.

Desta forma, a única diferença é: quando ocorre o estorno do processo do fechamento da viagem ou da operação de saída, os documentos constantes na viagem são cancelados no Portal e no App Mobile do Checklist, passando assim a ficar aptos para inclusão em novo Checklist.

...

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

Informações

title	IMPORTANTE

Se a viagem de socorro possuir o status "Em trânsito" o envio do Checklist dos documentos ainda não entregues para o motorista da nova viagem se dará no momento do apontamento da ocorrência do tipo 08 - Transferência de viagem, já que a viagem do tipo socorro não mais possuirá o processo de fechamento ou o apontamento da operação de saída.

Processo Estorno de Viagem no Protheus

O processo de estorno de viagem quando há a integração com o Checklist é o mesmo processo quando não há a integração ativa.

Desta forma, a única diferença é: quando ocorre o estorno do processo do fechamento da viagem ou da operação de saída, os documentos constantes na viagem são cancelados no Portal e no App Mobile do Checklist, passando assim a ficar aptos para inclusão em novo Checklist.

Importante: o cancelamento no Portal e no App Mobile do Checklist, também segue o critério da configuração do parâmetro MV_TMINTEV, onde quando configurado como 1 o cancelamento ocorrerá no Fechamento da Viagem, já quando o parâmetro estiver configurado como 2 o cancelamento ocorrerá no Saída da Viagem.

Caso a configuração do parâmetro MV_TMINTEV = 1:

a. Posicione sobre uma viagem com o status "fechada" por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b. Clique em Outras Ações > Manutenção > Fechamento > Estornar

c. O status da viagem passará para em "aberto", documentos integrados no Portal ficarão com status "cancelado" e no App Mobile do Checklist são excluídos da listagem de entrega do motorista.

Caso a configuração do parâmetro MV_TMINTEV = 12:

a. Posicione sobre uma viagem com o status "fechadaem trânsito" por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b. Clique em Outras Ações > Manutenção > Fechamento > Estornar

(modelo 2).

b. Clique em Outras Ações > Manutenção > Operações

c. Na janela aberta de apontamento de operações, posicione sobre o apontamento da operação de saída e clique no botão "estornar" localizado no rodapé da janela.

d. Confirme na janela de estorno de operações.

ec. O status da viagem passará para em "abertofechado", documentos integrados no Portal ficarão com status "cancelado" e no App Mobile do Checklist são excluídos da listagem de entrega do motorista.

Caso a configuração do parâmetro MV_TMINTEV = 2:

a. Posicione sobre uma viagem com o status "em trânsito" por meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2).

b. Clique em Outras Ações > Manutenção > Operações

c. Na janela aberta de apontamento de operações, posicione sobre o apontamento da operação de saída e clique no botão "estornar" localizado no rodapé da janela.

d. Confirme na janela de estorno de operações.

e. O status da viagem passará para "fechado", documentos integrados no Portal ficarão com status "cancelado" e no App Mobile do Checklist são excluídos da listagem de entrega do motorista.

Visões: Portal e App Mobile(motorista)

Durante o processo de integração, ocorrerão as seguintes visões no Portal e na Tela do App Mobile Checklist:

Visão do Checklist (Portal):

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) :

Image Removed

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

No modo mobile apresentado ao motorista para execução de tarefas:

Image Removed

1. Apresentação do documento a ser realizado o Checklist;

2. Início do processo Checklist;

3. Primeira pergunta, documento entregue?

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

5. Segunda pergunta, informar o nome do recebedor;

6. Terceira pergunta, informar o nº de documento deste recebedor;

...

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

Durante o processo de integração, ocorrerão as seguintes visões no Portal e na Tela do App Mobile Checklist:

Visão do Checklist (Portal):

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 :

Image Added

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

No modo mobile apresentado ao motorista para execução de tarefas:

Image Added

1. Apresentação do documento a ser realizado o Checklist;

2. Início do processo Checklist;

3. Primeira pergunta, documento entregue?

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

5. Segunda pergunta, informar o nome do recebedor;

6. Terceira pergunta, informar o nº de documento deste recebedor;

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

Image Added

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

Image Added

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

Image Added

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

Image Added

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

Durante o processo de estorno da integração, ocorrerão as seguintes visões no Portal e na Tela do App Mobile Checklist:

Visão do Checklist (Portal):

Necessário que os documentos já estejam integrados e com status "pendente de execução".

Image Added

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":

Image Added