Informações sobre configuração e usabilidade da ferramenta.

Obs: A partir da 12.1.27 (data XX/XX/2022)

Conteúdo

Este documento possui o intuito de ser um guia para os clientes, analistas e desenvolvedores, que utilizam ou que querem aderir na sua rotina de trabalho as funcionalidades que são disponibilizadas pelo integração do Importador XML x Totvs Transmite. 

Aqui você verá:

  • Configuração.
  • Funcionalidades e Interfaces.
  • Tabelas:
TabelaDescrição
DHWConfiguração Grupo/Empresa que integra com o Totvs Transmite
DHYGrava dos Ids para consulta dos XML importados do Totvs Transmite
DHZHistórico de Ids com erros e já importados no Importador XML
CKOCOLRegistros do XMLs importados
SDS

Cabeçalho do documento no monitor

SDTItens do documento no monitor


  • Fontes envolvidos:
FontesDescrição
COLXCFGWizard de configuração Totvs Colaboração / Importador XML
COLAUTOREADRotina para importar XMLs na CKOCOL
COMTRANSMITEClasse/Objeto para importação dos XML originados via Totvs Transmite
COMXCOLMonitor
MATA140IImporta NFE/NFS do Totvs Colaboração / Importador XML

Pode-se utilizar o Wizard como facilitador da configuração.

Link: IX09 - Wizard Configuração

  • Parâmetros utilizados na integração.
ParâmetroTipoConteúdoDescriçãoObservação
MV_IMPXMLLTHabilita integração Importador XMLParâmetro deve ser T para que integração com o Totvs Transmite funcione.
MV_DOCIMPCNFE/NFS/CTETipo de XML a serem importados pela integração Importador XML x Totvs Transmite
MV_XMLCIDC
Client ID do Totvs TransmiteInformação virá do Totvs Transmite
MV_XMLCSECC
Client Secret do Totvs TransmiteInformação virá do Totvs Transmite
MV_XMLDIASN30Range dias para importar documentos do Totvs Transmite  

Data Inicio: Data de hoje - MV_XMLDIAS (30)

Data Final: Data de hoje


MV_XMLHISTL.F.Salva historico de Ids importados e/ou com erros
MV_NGINNC
Caminho para importar XMLs pelo Importador XMLTratamento continuara funcionando mesmo com a integração com o Totvs Transmite ativa
MV_NGLIDOSC
Caminho para onde o XMLs lidos da pasta IN serão armazenadosTratamento continuara funcionando mesmo com a integração com o Totvs Transmite ativa


  • Imagens da configuração dos parâmetros no Wizard:

 




  • Deve-se informar qual Grupo/Filial estara integrada com o Totvs Transmite. Para que assim somente XMLs pertencentes ao mesmo Grupo/Filial sejam importados.

Obs: Ao selecionar Grupo/Filial, o mesmo devera conter o seu Codigo Filial do Totvs Transmite. Informação esta na tabela DHW (DHW_CODFIL)


  • Imagem da configuração de Grupo/Filial no Wizard.

No Importador XML é necessário criar agendamentos das rotinas responsáveis pela importação e gravação do XML no Monitor (Protheus).

Para realizar o cadastro dos agendamentos é necessário o seguinte:

  • SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agendamento -> Cadastro): 
    • Informar usuário (Ex: 000000 - Administrador)

    • Rotina (tabela abaixo)

      Agendamento

      Descrição

      COLAUTOREADPara importar XML's e gravar informações na tabela CKO
      SCHEDCOMCOL

      Ler os XML's da CKO e importar para o monitor (SDS e SDT)

    • Empresa/Filial: Empresa que serão utilizadas para importarem os XML's
    • Modulo: (Ex: 02 - Compras)
    • Deixar habilitado
    • Informar recorrência: Definir o tempo em que os XML serão importados e gravados. Obs: Sugerimos que não deixa sempre ativo, defina a execução de tempo em tempo, Ex: 30 minutos

  • SIGACFG -> AMBIENTE -> SCHEDULE -> SCHEDULE (Agent -> Cadastro): 
    • Incluir o Grupo de empresa/Empresa que contem configurado os agendamentos.

Para que funcione corretamente os agendamentos é necessário que após toda configuração, o Agent e o Schedule sejam ativados.

Lista de documentos importados pela integração Totvs Transmite x Importador XML

DocumentoCódigoTipo Requisição

NF-e

109

Recebimento

NFS-e

319

Recebimento

CT-e

214

Recebimento

CTEOS273Recebimento

Importador XML integrado com Totvs Transmite: Documentos NFS serão importados.

Importador XML NÃO integrado com Totvs Transmite: Documentos NFS NÃO serão importados




Aprovações

Para o escopo de aprovações (Pedido de Compras e Prestação de Contas) não existe nenhuma configuração adicional, bastando apenas que o ambiente esteja provisionado (REST configurado e ALIAS do Mingle gerado). 

Após o ambiente configurado, basta que o usuário que é um Aprovador acesse o aplicativo e o mesmo irá visualizar os itens que estão pendentes de sua análise, podendo ser Pedido de Compras ou Prestação de Contas.


Para configurar o envio de notificações do ERP para o aplicativo, siga as instruções abaixo. Observando que os passo abaixo NÃO SÃO obrigatórios para o funcionamento do escopo de aprovações.


Configurando o seu ambiente

  1. Configure o Rest Protheus
  2. Se você é cliente solicite um alias pelo Mingle. Se você é Totver crie um alias pelo AppLinker.
  3. Preencha com o Token de acesso o parâmetro MV_MINGKEY.

    1. Acesse o módulo Configurador (SIGACFG)

    2. Acesse a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clique sobre o ícone + para expandir as opções e clique em Parâmetros.
    4. Clique sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token.


O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Verificar a permissão de usuário

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Usuário > Senhas > Usuários. 
  3. Pesquise pelo usuário que será alterado.
  4. Selecione o usuário e clique em alterar.
  5. Selecione a aba Restrições de Acesso > Aba Acessos.
  6. Habilite a permissão 174 - Acesso a inscrição nos Eventos do Event Viewer.


Inscrever no Event Viewer

  1. Acesse  Miscelânea > Inscr. Event Viewer em qualquer módulo.
  2. Clique em Incluir.
  3. Selecione o canal 002.
  4. Selecione categoria 001.
  5. Selecione o evento desejado.
  6. Selecione Sim no campo Json.

Para informações sobre o Event Viewer, clique aqui. 



Configurando o seu ambiente

  1. Configure o Rest Protheus
  2. Se você é cliente solicite um alias pelo Mingle. Se você é Totver crie um alias pelo AppLinker.
  3. Preencha com o Token de acesso o parâmetro MV_MINGKEY.

    1. Acesse o módulo Configurador (SIGACFG)

    2. Acesse a rotina Base de Dados > Dicionário > Base de Dados. 
    3. Clique sobre o ícone + para expandir as opções e clique em Parâmetros.
    4. Clique sobre a lupa e pesquisar por MV_MINGKEY.
    5. Preencha nos campos Cont. Por, Cont. Ing, Cont. Esp com o Token.


O Token será encaminhado ao solicitar o alias pelo Mingle ou pelo AppLinker .

Criando o evento

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Ambiente > Cadastro > Tabelas.
  3. Pesquise pela tabela (E3).
  4. Clique no botão Editar.
  5. Inclua o novo Evento.


Verificar a permissão de usuário

  1. Acesse o módulo Configurador (SIGACFG)
  2. Acesse a rotina Usuário > Senhas > Usuários. 
  3. Pesquise pelo usuário que será alterado.
  4. Selecione o usuário e clique em alterar.
  5. Selecione a aba Restrições de Acesso > Aba Acessos.
  6. Habilite a permissão 174 - Acesso a inscrição nos Eventos do Event Viewer.


Inscrever no Event Viewer

  1. Acesse  Miscelânea > Inscr. Event Viewer em qualquer módulo.
  2. Clique em Incluir.
  3. Selecione o canal 002.
  4. Selecione categoria 001.
  5. Selecione o evento desejado.
  6. Selecione Sim no campo Json.

Para informações sobre o Event Viewer, clique aqui. 


Compilando e enviando notificação

Para que você receba uma notificação no Meu Protheus inserir a função EventInsert na rotina que realize o disparo da notificação. 

A seguir você verá um exemplo de como realizar esses passos. 


Os exemplos a seguir são apenas modelos para fins de estudo e visualização rápida das notificações. Procure implantar os passos se adequando ao seu negócio e necessidade. 

Para funções customizadas você deverá adicionar algumas linhas de código. 


O código a seguir é apenas um exemplo e você poderá customizar ele da melhor forma. Segue a um exemplo do Event Insert.  

#include 'PROTHEUS.CH'

#include 'FWEVENTVIEWCONSTS.CH'

/**
* AUTOR: GABRIEL GAMELEIRA DOS SANTOS
* DATA: 29/09/2020
* HORA: 12:19
* FINALIDADE DO PROGRAMA: CRIAR EVENTO CUSTOMIZADO. LEMBRANDO QUE ESTE FONTE PRECISA SER ADIONADO NA SUA FUNCAO CUSTOMIZADA PARA QUE NO MOMENTO QUE FUNCAO SER CHAMADA EXECUTE O EVENTO  
*/

User Function MOBILE0000()

    Local cEventId := "Z00"

    Local cMensagem := "Evento enviado!"

    Local cTitulo := "Teste do Evento" + Time() //FUNCAO TIME PEGA O HORARIO ATUAL BASEADO NO S.O

    RPCSETENV("99", "01") //ABERTURA DO AMBIENTE PASSANDO OS ARGUMENTOS EMPRESA E FILIAL RESPECTIVAMENTE
    
    EventInsert(FW_EV_CHANEL_ENVIRONMENT, FW_EV_CATEGORY_MODULES, cEventId, FW_EV_LEVEL_INFO, "", cTitulo, cMensagem, .T.) //CHAMADA DO EVENTO

Return Nil

Você poderá alterar o quarto argumento passado na função EventInsert por qualquer um dos valores listados abaixo. As outras constantes mantenha pois é padrão.  

PALAVRA CHAVESIGNIFICADOCOR
FW_EV_LEVEL_INFOMENSAGEM DE INFORMACÃOCINZA
FW_EV_LEVEL_ERRORMENSAGEM DE ERROVERMELHO
FW_EV_LEVEL_WARNINGMENSAGEM DE ATENÇÃOAMARELO

Após o código fonte compilado acione a rotina. A seguir segue um exemplo para acionar a função compilada no RPO.


Existem inúmeras formas de executar uma função. Execute ela do jeito que achar melhor. 

Instalando no seu celular

O Meu Protheus  está disponível nas duas principais lojas de distribuição de aplicativos.

Você poderá ir na loja pesquisar por Meu Protheus, clicar sobre o mesmo e instalar.

Clique sobre o ícone do seu sistema operacional para ser encaminhado para a loja. 


Acesse o seu ambiente

Para realizar o seu acesso utilize: 

  • Usuário 
  • Senha
  • Alias

Nos campos Usuário e Senha,  informe os mesmos dados que você utiliza quando acessa o seu ambiente no ERP Protheus via SmartClient.

No campo Alias, informe o seu identificador no Mingle ou AppLinker. 





Peça um alias

Por meio do aplicativo, na tela de acesso é possível solicitar um alias. Para solicitar um alias clique sobre Solicitar Alias. Será exibido uma tela solicitando: 

  • Nome
  • Nome da empresa
  • E-mail
  • Telefone

Todos os campos solicitados serão utilizados para entrarmos em contato com os clientes que precisam de um alias e que não fizeram seu cadastro por meio do Mingle. 



Escolha a filial

Após o acesso, escolha uma filial.

Caso deseje filtrar uma filial da lista de filiais, você poderá encontrar uma filial pesquisando pelo código ou pelo nome no campo de busca.



{

Visualize e interaja com eventos

Com a filial escolhida, você terá acesso aos eventos que ocorrem no seu ambiente do ERP Protheus. Para acessar os Eventos clique na guia de Eventos.


Caso o usuário logado esteja integrado ao Active Directory (usuário de rede), as notificações não estarão disponíveis. Atualmente esse recurso não é suportado pelo serviço responsável por gerenciar as notificações (Push Notification).



Para apresentar mais informações sobre um evento clique sobre a seta para expandir mais informações sobre o evento. 



{

Para filtrar um evento clique sobre o funil e escolha a sua condição. É possível realizar o filtro de eventos pelas seguintes condições:

  • Nome da rotina
  • Mensagem
  • Titulo
  • Período
  • Criticidade
  • Tipo do evento



{

Para compartilhar um Evento, clique sobre o ícone de compartilhar. Assim que realizar o clique  será apresentada a tela de aplicativos que podem ser utilizados para compartilhá-lo.


{

Caso existam links envolvidos no corpo do evento, você poderá clicar sobre o link desejado e ser redirecionado para a página. 


{

Aprove ou reprove

Com a filial escolhida, você terá acesso aos registros de aprovações  que aguardam por sua ação no ambiente do ERP Protheus. Para ter acesso a lista de aprovações clique na guia Aprovações. 

Ao clicar sobre um item na lista de itens Pendentes, você pode aprovar ou reprovar a operação.

Independente da ação selecionada, uma tela solicitando uma justifica será apresentada.

É possível também visualizar os pedidos de compras que foram aprovados ou reprovados nas respectivas guias Aprovados e Reprovados.

Anexos

Nas aprovaçōes de pedido de compra é possível ter acesso aos documentos e imagens anexos ao item. 

Esteja atualizado com a versão mais recente da expedição continua do mobile. 

Para apresentar os anexos clique sobre "Anexos" para visualizar a lista de documentos do item. 


{

{

Perfil

Apresenta dados importantes sobre a conexão do aplicativo com o ambiente Protheus.

  • Usuário
  • Cliente
  • Empresa
  • Set
  • filial


Perguntas Frequentes (FAQs)


Correspondem ao mesmo usuário e senha que você utiliza para fazer acesso no Protheus via SmartClient.

Existe! Porém, a limitação é para arquivos com mais de 5MB.

Um alias é um identificador único do cliente na TOTVS. Cada cliente pode ter mais de um alias e cada alias corresponde a um Protheus instalado.

O alias é a chave para que o aplicativo consiga encontrar o Protheus e assim realizar a comunicação.

Se você ainda não possui um alias, solicite o seu através da abertura de um chamado no Portal do Cliente ou acesse AQUI.

Sua senha pode ser redefinida somente através do Protheus.

No aplicativo são visualizados somente os eventos a que o usuário do Protheus está cadastrado na inscrição do Event Viewer.

Os eventos são enviados para o aplicativo através da notificação e também na home do aplicativo.

Os status dos Eventos são:

  • Cinza: Informação
  • Amarelo: Alerta
  • Vermelho: Erro

Na tela do Meu Protheus, selecione o evento e clique no botão compartilhar.

Não existe nenhuma configuração específica para que os pedidos de compra possam ser analisados pelo aplicativo. Com o provisionamento do ambiente (REST e Mingle), basta que o usuário com perfil de Aprovador acesso o aplicativo. 

Observando que a aprovação de pedido de compras é aderente ao processo padrão de liberação de documentos (MATA094).

No aplicativo existe uma área chama "Ver mais" onde é possível inserir informações customizadas que sejam relevantes para a tomada de decisão do aprovador. É possível inserir novas informações nesta área através do Ponto de Entrada MT094CPC (https://tdn.totvs.com/x/gXAPEQ), onde os campos informados no Ponto de Entrada serão exibidos no aplicativo.

Não necessariamente um limite, mas arquivos com tamanho maior de 5MB podem não ser visualizados dependendo da infraestrutura em que o ambiente Protheus se encontra.

Na tela de Configurações, clicar no botão Sair.

Materiais Auxiliares

Os materiais abaixo dizem respeito ao Event Viewer do Protheus e ao TOTVS Mingle:

Configurar Event Viewer

Como adicionar uma rotina de usuário no Event Viewer

Acesso Aplicativos Móveis


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



<style>

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:link, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:visited, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:focus, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:hover, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:active {
color: white;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: white; !important}
deck.tab.inactive.background = #e7e7e7
deck.tab.active.background = #252626