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âmetro
Descrição
MV_TMAPCKL
Habilita 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;
Por meio do menu lateral clicar no icone com o titulo de "Agent" e em seguida na opção Cadastro
Na parte inferior da tela "detalhes" click no icone representado por uma página com o sinal de mais, preencha os campos conforme quadro "Campos Agent Schedule" logo abaixo;
Salve o cadastro clicando no icone representado pela imagem de check na cor verde.
Campos
Como Preencher
Nome
Informe o nome do agent que faz o gerenciamento das execuções das threds/jobs agendados. Com por exemplo: Agente de Execução Empresa T1
IP
Informe o Ip do servidor, deve ser o mesmo que está executando o appserver, aceita também localhost ou o nome da máquina servidora.
Porta
Deve ser informado 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 use a lupa para selecionar o código da empresa.
Nº de Threads
Informe 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.
Habilitado
Marque a caixa do checkbox para que o Agente fique habilitado na próxima vez que o appserver for iniciado.
2. Configuração do Job.
Acessar o Cadastro de Agendamentos de Rotinas via menu Ambiente > Schedule > Schedule
Por meio do menu lateral clicar no icone com o titulo de Agendamentos para expandir;
Ainda em Agendamentos clicar na opção cadastro;
Na parte inferior da tela em "detalhes" click no icone representado por uma paginal com o sinal de mais para incluir um novo registro, preencha os campos, conforme quadro Campos Cad. Job;
Salve o cadastro clicando no icone representado pela imagem de check na cor verde.
Campo
Como preencher
Usuário
preencha 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.
Rotina
Deve 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:
Hora
Informe a hora que será iniciada a execução da rotina e 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 use a lupa ao lado do campo para abrir a tela de wizard de seleção da empresa e filial.
Módulo
Informe o código do módulo que deve ser o código 43 - TMS Gestão de Transporte
Habilitada
Este campo deve estar marcado para que o job seja habilitado
Descrição
Texto 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:
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:
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;