CONTEÚDO
01. VISÃO GERAL
Para facilitar o vínculo do arquivo de imagem, assim como a atualização na tabela DLY (Eventos do Comprovante de Entrega) foi criada uma função que pode ser utilizada com o uso do Schedule do Protheus.
Ao executar o Schedule será verificado, na aba Origem, se há arquivos cuja nomenclatura atende aos requisitos necessários, em caso positivo moverá para a aba Destino e atualizará o vínculo da imagem na tabela DLY (Eventos do Comprovante de Entrega).
A função que deverá ser utilizada periodicamente (tempo a ser definido pelo usuário) será a TMSAE81C.
02. CONFIGURAÇÕES
Pode ser incluído via Schedule pelo módulo Configurador (SIGACFG) a atualização da aba Imagens e registro na tabela DLY (Eventos do Comprovante de Entrega), a fim de evitar que seja necessário o vínculo manual da imagem referente ao comprovante de entrega.
Devem ser definidas as abas Origem e Destino, obedecidos uma nomenclatura padrão do arquivo de imagem conforme exemplo:
CTE_XXXXX, onde XXXXX é a chave eletrônica do CT-e.
Parâmetros
MV_TMSIMGS: define a aba de Origem das imagens do comprovante de entrega. Parâmetro de Imagens não vinculadas;
MV_TMSIMGC: define a aba de Destino das imagens do comprovante de entrega. Os arquivos de imagens, após serem vinculados e seu registro atualizado na tabela DLY (Eventos do Comprovante de Entrega).
Mais informações sobre os parâmetros podem ser obtidas em: Parâmetros - SIGATMS.
IMPORTANTE!
- As informações registradas nos parâmetros mencionados se referem aos diretórios que existem ou serão criados abaixo do RootPath, configurado no Appserver do Protheus (normalmente Protheus_Data).
- Os diretórios informados nos parâmetros, caso não existam, serão criados automaticamente no momento da primeira execução do Job.
- Por se tratar de um Job, ou seja, uma rotina que roda no servidor, este não faz leitura de diretórios localizados na máquina de usuário, sendo necessário o uso de mapeamentos para enviar a imagem para a pasta localizada abaixo do rootPath do Appserver do Protheus.
03. VINCULO DE IMAGEM VIA JOB - CHECK LIST
Ao configurar o Job de imagens, apontando para a execução da rotina TMSAE81C - JOB Vinculo de imagens do comprovante de entrega, o Job verificará de tempos em tempos (conforme configuração do Schedule) se existe imagem na aba Imagens não vinculadas, que é definida pelo parâmetro MV_TMSIMGS.
Existindo imagens respeitando a nomenclatura CTE_<Chave_do_Conhecimento_Eletrônico>, o Job da rotina tentará vincular essa imagem ao registro da tabela DLY - Eventos do Comprovante de Entrega correspondente a chave do CT-e que faz parte do nome do arquivo da imagem.
Ocorrendo o vínculo, o arquivo de imagem é movido para a aba Imagens vinculadas, que é definida pelo parâmetro MV_TMSIMGC.
O Job somente fará o vinculo da imagens que estão com o status integrado, observando o campo DLY_STATUS, status da tabela DLY - Eventos do Comprovante de Entrega, que deverá estar com o valor 0-Integrado.
Informações adicionais podem ser obtidas na documentação da rotina Integração Checklist X Comprovante Entrega (TMSAE81).
04. EXEMPLO DE UTILIZAÇÃO
O exemplo de utilização está destacado na documentação da rotina: Integração Checklist X Comprovante Entrega (TMSAE81).
05. TABELAS UTILIZADAS
- DLY - Eventos do Comprovante de Entrega
06. ASSUNTOS RELACIONADOS
- Schedule - Como agendar a execução de rotinas;
- Comprovante de Entrega Eletrônico (TMSAE71 - SIGATMS)
- Integração Checklist x Comprovante de Entrega (TMSAE81 - SIGATMS)