CONTEÚDO

  1. Visão Geral
  2. Configurações
    1. Parâmetros
    2. Schedule
  3. Exemplo de utilização
  4. Informações Complementares
  5. Tabelas utilizadas

01. VISÃO GERAL

A integração visa complementar o processo de Apontamento do Comprovante de Entrega permitindo obter os dados obrigatórios para a transmissão do evento de comprovante de entrega para a SEFAZ (Secretaria da Fazenda).


02. CONFIGURAÇÕES

a. Parâmetros:

Para habilitar a integração do My Checklist com o Comprovante de Entrega deve-se 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 de documento entregue;


Maiores detalhes referente aos parâmetros acima, verificar em: Parâmetros - SIGATMS: 

T -  https://tdn.totvs.com/pages/editpage.action?pageId=446705755

O -  https://tdn.totvs.com/pages/viewpage.action?pageId=446704583

b. 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 deve-se acessar o Módulo Configurador do Protheus- SIGACFG  e realizar os passos abaixo:

1.  Configuração do Agente do Schedule

Acessar o Agente do Schedule via menu Ambiente > Schedule > Schedule;


CamposComo Preencher
NomeInforme o nome do agente que faz o gerenciamento das execuções das threds/jobs agendados. Com por exemplo: Agente de Execução Empresa T1.
IPInforme o IP do servidor, deve ser o mesmo que está executando o Appserver, aceita também localhost ou o nome da máquina servidora.
PortaDeve ser informado a mesma porta de execução do Appserver que fará o controle de execução dos jobs.
AmbienteInforme o ambiente configurado no Appserver.ini.
EmpresaInforme o grupo da empresa use a lupa para selecionar o código da empresa.
Nº de ThreadsInforme a quantidade de Threads que será gerenciada pelo agente do Schedule. Permitindo que uma ou mais rotinas sejam executadas em paralelo. Por exemplo, se for informado 3 Threads o agente fara o gerenciamento da execução de até 3 rotinas em paralelo.
HabilitadoMarque a caixa do Checkbox para que o Agente fique habilitado na próxima vez que o Appserver for iniciado.


2. Configuração do Job

         
CampoComo preencher
UsuárioPreencha com o código do usuário que tenha direitos de administrador, use o botão representado por uma lupa para abrir a lista de usuários.
RotinaDeve ser preenchido com o 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:  

HoraInforme a hora que será iniciada a execução da rotina, deve estar no formato HH:MM. Exemplo: 10:07.
AmbienteInforme o ambiente configurado do Appserver.
Empresa/FilialInforme o grupo de empresa e filial use a lupa ao lado do campo para abrir a tela de Wizard de seleção da empresa e filial. 
MóduloInforme o código do Módulo, que neste caso deve ser o 43 - TMS Gestão de Transporte.
HabilitadaEste campo deve estar marcado para que o job seja habilitado.
DescriçãoTexto livre, por sugestão pode se informar "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á apresentado os passos necessários para a utilização da integração do My Checklist x Comprovante de Entrega:

1. 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 acima 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 de que o o parâmetro MV_OCORENT esteja configurado com o código de Ocorrência do tipo encerra processo e que esteja configurado para gerar Comprovante de Entrega, campos "Comp .Entrega" DT2_CMPENT = '1' e "Tipo" DT2_TIPOCO='01'

2. Processo básico de Viagem no Protheus:

a. Inclusão de Documentos

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

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

Faça a transmissão do CT-e e aguarde a autorização pela SEFAZ;

b. Inclusão da Viagem

Inclua uma viagem do tipo entrega por meio do menu Atualizações > Viagens > Rodoviario Entrega > Viagens(modelo 2);

Click no botão incluir para abrir a tela de cadastro de viagem;

Informe a rota que será utilizada e em seguida click no botão Outras Ações > Comp. via. para informar o(s) veículo(s) por meio da tela de complemento da viagem;

Ainda na tela de complemento de viagem clique em Outras Ações > Mot. Viag. para informar o motorista da viagem; confirme a tela de motorista clicando no botão Salvar; em seguida confirme a tela de complemento de viagem clicando no botão Salvar;

Na tela da viagem, inclua os documentos que serão entregues por meio do grid, pode-se usar 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.

Com os documentos informados na viagem clique no botão Salvar para confirmar os dados e gerar a viagem no sistema;

c. Fechamento da Viagem e Integração com My Checklist (quando MV_TMINTEV = 1-Fechamento da Viagem)

Posicione sobre a viagem incluída, acesse o menu Outras Ações > Manutenção > Fechamento > Fechar; Será apresentado uma janela de confirmação, clique no botão OK;

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;

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;

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;

d. Saída da Viagem e Integração com o My Checklist (quando MV_TMINTEV = 2-Saída da Viagem)

Posicione sobre a viagem incluída, acesse o menu Outras Ações > Manutenção > Operações; Será apresentado a tela de apontamento de operações;

Selecione a operação de Saída de Viagem e clique no botão Apontar, informe os campos de Dt. Início e Hr .Início, Dt. Realizada e Hr. Realizada; Clique no botão Confirmar para registrar o apontamento de Saída;

Após a confirmação do apontamento será realizado 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 e logo em seguida será o envio das informações do CT-e para o My-Checklist;

A integração sera disparada para cada documento uma vez que cada checklist representa um CT-e que será enviado para o App mobile do checklist;

e. Atualização dos dados do Comprovante de Entrega via JOB

A sincronização dos dados via job é realizada ao configurar a rotina TMSAE81B - Sincronizador Checklist x Comprovante de Entrega via modulo configurador (SIGACFG). Uma vez no Módulo Configurador, acesse a interface do Schedule pelo caminho Ambiente > Schedule > Schedule. Siga os passos descritos na seção 02.CONFIGURAÇÕES > b. Schedule.

O job se encarrega de realizar as seguintes tarefas: 

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

* Realizar 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;


04. INFORMAÇÕES COMPLEMENTARES 

05. TABELAS UTILIZADAS



<!-- 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>