CONTEÚDO

  1. Visão Geral
  2. Configurações
    1. Parâmetros
    2. Schedule
  3. Exemplo de utilização
  4. 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:

ParâmetroDescrição
MV_TMAPCKLHabilita a integração com o My Checklist X Comprovante de Entrega. Assume os valores .T. (Habilitado) ou .F. (Desabilitado)
MV_TMINTEV

Permite definir em qual momento será realizada a integração do My Checklist e pode assumir a seguinte configuração:

1-Integração ocorre ao realizar o fechamento da viagem;

2-Integração ocorre ao realizar a saída da filial;

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.


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 TMSAE81 - Sincronizador da Integração do My Checklist X Comprovante de Entrega.

Para a configuração do Job deve-se acessar o modulo SIGACFG - Configurador do Protheus 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 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 inicio da execução do job no formato DD/MM/YYYY exemplo:  

HoraInforme a hora que será iniciada a execução da rotina e 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 deve ser o código 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 02.CONFIGURAÇÕES;

A integração pode ocorrer em dois momentos distintos e depende de como foi configurado o parâmetro MV_TMINTEV mencionado na seção 02.CONFIGURAÇÕES sendo 1-No Fechamento da Viagem e 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 click em outras ações > motoristas, para informar o motorista da viagem; confirme a tela de motorista; confirme a tela de complemento de viagem;

Na tela da viagem, inclua os documentos que serão entregues por meio do grid, pode-se usar a lopa pressionando a tecla F3 ao selecionar o campo Fil. Doc.

Com os documentos informados na viagem click na opção confirmar para salvar os dados da viagem;

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ções > Fechamento > Fechar; Será apresentado uma janela de confirmação, click 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 sera 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 > Manutencao > Operações; Será apresentado a tela de apontamento de operações;

Selecione a operação de SAÍDA DE VIAGEM informe os campos de Dt.Inicio e Hr.Inicio, Dt.Realizada e Hr.Realizada; Click 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


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>