Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Image Added


Painelinfo
titleImportante

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

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

Painel
borderStylenone
Image Removed
Objetivo

(informação) O objeto deste documento é trazer as informações necessárias para a configuração e o uso da integração entre o Importador XML e o TOTVS Transmite.

Aviso
titleImportante - Integração Importador x TOTVS Transmite
Integração Importador XML x TOTVS Transmite

Novos agendamentos separando processos e melhoria de performance:

  • SCHEDIMPTRA: Responsável pela requisição e leitura do recibos enviado pelo TOTVS Transmite
  • SCHEDUPDTRA: Responsável pela atualização de status no TOTVS Transmite

Obs: Ao configurar os 2 novos agendamentos o COLAUTOREAD ficara responsável apenas pela importação de XMLs via pasta IN, caso contrario continua responsável pela leitura da pasta IN e todo processo de requisição, leitura e atualização do TOTVS Transmite.

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. 

Image Removed

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.
Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.
Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide

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.
Card
defaulttrue
effectDuration0.5
idtransmite
labelImportador XML x Totvs TOTVS Transmite
titleTransmite
effectTypeslide

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.
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
slide
Card
defaulttrue
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide
Column

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 TOTVS Transmite.   

Aqui você verá:

  • Configuração.
  • Funcionalidades e Interfaces.
Card


Painel
titleProcesso de Check-list

Para que a integração entre o Importador XML e TOTVS Transmitefuncione corretamente, preparamos um Checklist dos requisitos mínimos que devem ser validados para o correto funcionamento da integração. 


[Imagem para ilustrar as etapas do Checklist]
Image Added

*Clique na imagem para ampliar.

Painel
titleIntegração (Processo macro):

Abaixo uma imagem ilustrativa do processo de integração entre o Importador XML e TOTVS Transmite.


[Imagem para ilustrar a integração Importador XML e TOTVS Transmite]

Image Added

*Clique na imagem para ampliar.

effectDuration0.5
idSobre
labelSobre
titleSobre
effectType

WizardWizardWizardcarddefault
Card
defaulttrue
effectDuration0.5
id
Fluxograma
label
Fluxograma / Etapas do Processo
title
Fluxograma
effectType
slide
true
Deck of Cards
Wizard
effectDuration0.5
idWizardFluxo
labeleffectTypeWizardtitleslide
Card
defaulttrue
effectDuration0.5
idFluxograma
labelFluxograma
titleFluxograma
effectTypeslide

Os eventos possuem descrição e o nome da rotina acionada, facilitando a identificação da ação que foi disparada ao realizar determinado evento e, consequentemente, o que foi realizado na atividade.

Eles podem ser divididos em duas modalidades: 

  • Pré-definidos

São os eventos padrões configurados por meio da inscrição na rotina do Event Viewer.

Utilizando o aplicativo Meu Protheus os eventos registrados são recebidos por meio de notificações para celular (Push notifications).  

  • Personalizados

São eventos que podem ser criados especificamente para uso em rotinas customizadas.  

Escopo

O Meu Protheus é um aplicativo da companhia TOTVS que possui integração com o ambiente do ERP PROTHEUS.

O escopo do aplicativo pode ser dividido entre duas funcionalidades principais: Aprovações e eventos.

Aprovações

O aplicativo Meu Protheus possibilita ao usuário realizar aprovações de processos ocorridos no ERP através do smartphone e abaixo estão listados os processos aderentes a este mecanismo de aprovações.

Pedido de Compras

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de pedidos de compras de forma aderente ao processo padrão de liberação de documentos (MATA094).

Prestação de Contas

O aplicativo Meu Protheus permite a análise (Aprovação / Reprovação) de prestação de contas (Controle de Viagens).

Eventos

O objetivo dos eventos é permitir que o usuário possa ser informado sobre eventos e interagir com aprovações que ocorrem no seu ambiente do ERP PROTHEUS por meio de notificações recebidas pelo aplicativo. 

O aplicativo possui eventos pré-definidos na sua integração com o ERP, conforme alguns exemplos abaixo:

  • Visualizar eventos que iniciaram, terminaram ou que tiveram algum problema ao serem processados por meio de notificações.  
  • Filtrar visualização de eventos. 
  • Processamento da folha de pagamento.
  • Término do recálculo do custo médio.
  • Processamento de contabilização.
  • Aprovação de orçamento. 
  • Produto atingiu ponto de pedido.
  • Lote de produto vencido.

Entre muitos outros eventos que estão cadastrados na tabela genérica E3 - Eventos (SX5).

Nota: 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).

Se você utiliza essas funcionalidades do Protheus pelo SmartClient, por meio do Aplicativo você poderá acessar essas funcionalidades em qualquer lugar na palma da mão.

Para conhecer mais sobre o Meu Protheus assista ao vídeo: 

Painel
borderStylenone
titleConheça o Meu Protheus
Column
width500

Conector de Widget
width500
urlhttps://www.youtube.com/watch?v=JBf1ObCPLYE&t=7s
height500

A seguir você pode encontrar mais informações sobre o as funcionalidades do aplicativo.

Deck of Cards
effectDuration0.5
idFuncionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idEventos
labelEventos
titleEventos
effectTypeslide

Os eventos possuem descrição e o nome da rotina acionada, facilitando a identificação da ação que foi disparada ao realizar determinado evento e, consequentemente, o que foi realizado na atividade.

Eles podem ser divididos em duas modalidades: 

  • Pré-definidos

São os eventos padrões configurados por meio da inscrição na rotina do Event Viewer.

Utilizando o aplicativo Meu Protheus os eventos registrados são recebidos por meio de notificações para celular (Push notifications).  

  • Personalizados

São eventos que podem ser criados especificamente para uso em rotinas customizadas.  

Card
effectDuration0.5
idAprovacoes
labelAprovações
titleAprovações
effectTypeslide

Suponha que um colaborador tenha realizado o fluxo de prestação de contas e essa prestação está pendente para analise.

Pelo Meu Protheus, poderá ser analisado e escolher entre aprovar ou reprovar esse registro. 

Card
Painel
titleDescrição das Etapas do Processo

(aviso) Observação:   


[Imagem para ilustrar o Fluxo integração Importador XML e TOTVS Transmite]

Image Added

Card
defaulttrue
effectDuration0.5
idEtapas
labelEtapas
titleEtapas
effectTypeslide
Painel
titleDescrição das Etapas do Processo

(aviso) Observação: Para um melhor aproveitamento e entendimento da integração entre o Importador XML e TOTVS Transmite é importante que o usuário tenha o conhecimento prévio  



Etapas
Importador XML x TOTVS Transmite

Descrição do Processo

TOTVS Transmite

Descrição do Processo 

Importador XML

Descrição do Processo

TEC




PASSO 1

Configuração da integração Importador XML x Totvs Transmite


Parâmetros:

  • MV_IMPXML (Habilitado Importador XML)
  • MV_XMLCID (Client Id Transmite)
  • MV_XMLCSEC (Client Secret Transmite)
  • MV_APITRAN (Ambiente Transmite)
  • MV_NGINN (Pasta IN)
  • MV_NGLIDOS (Pasta Lidos)
  • MV_DOCIMP (Tipo documentos a serem importados)

Wizard:

Através do Wizard é possível configurar todos os parâmetros descritos acima e informar as filiais do Importador XML que serão integradas junto ao Totvs Transmite (Gravando na DHW)


PASSO 2

Agendamento COLAUTOREAD


  • Inicia verificando se possui XMLs na pasta IN (MV_NGINN)

PASSO 3

Agendamento SCHEDIMPTRA


  • Feita a chamado do EndPoint no Totvs Transmite para requisitar os XMLs "pendentes" para integração com Importador XML

Importante: Para correto funcionamento do EndPoint, é preciso ter:

  • Tabela DHW com o vinculo entre as filiais do Protheus e Totvs Transmite
  • Parâmetro: MV_DOCIMP e MV_DTINITR

PASSO 4

Agendamento SCHEDIMPTRA

Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus os "Recibos"

Importante: Totvs Transmite retorno um recibo por tipo de documento (MV_DOCIMP)



PASSO 5

Agendamento SCHEDIMPTRA


Protheus (Importador XML) recebe os "Recibos" do Totvs Transmite e os grava na tabela DHY

PASSO 6

Agendamento SCHEDIMPTRA


Com os "Recibos" na tabela DHY é feito a chamada de outro EndPoint no Totvs Transmite para gravar o XMLs no Importador XML (Tabela CKO) 

PASSO 7

Agendamento SCHEDIMPTRA

Totvs Transmite recebe requisição solicitada pelo Importador XML e retorna ao Protheus um arquivo em Encode64 com todos os XMLs daquele "Recibo"



PASSO 8

Agendamento SCHEDIMPTRA


Protheus (Importador XML) recebe o Encode64 com os XMLs e vai fazer o Decode64 (TEC)O Decode64 é feito e seu retorno gera um arquivo .ZIP

PASSO 9

Agendamento SCHEDIMPTRA


Com o arquivo .ZIP gerado através do Decode64, é necessário fazer a descompactação desse arquivo.A descompactação do arquivo .ZIP é feito pela função FUnZip

PASSO 10

Agendamento SCHEDIMPTRA


Os arquivos descompactados serão salvos dentro da pasta (\transmite\) e feita a leitura dos XMLs gravando na tabela CKO

PASSO 11

Agendamento SCHEDUPDTRA


Após a gravação na tabela CKO, o Importador XML chama o EndPoint do Totvs Transmite para fazer as atualizações de status do documento no Totvs Transmite

PASSO 12

Agendamento SCHEDUPDTRA

Totvs Transmite recebe requisição solicitada pelo Importador XML com a chave do documento e faz a atualização dos status no Totvs Transmite.

PASSO 12

Agendamento SCHEDCOMCOL


Protheus (Importador XML) lê os XMLs da tabela CKO e os envia para o Monitor, caso não encontre nenhuma inconsistência. 
Card
effectDuration0.5
idTabelas
labelTabelas / Fontes
titleTabelas
effectTypeslide
  • Tabelas:
TabelaDescrição
DHWConfiguração Grupo/Empresa que integra com o Totvs Transmite
DHYGrava os 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
MATA140I

Importa NFE/NFS do TOTVS Colaboração / Importador XML

MATA116IImporta CTE/CTEOS do TOTVS Colaboração / Importador XML
WIZIMPWizard Integração Importador XML x TOTVS Transmite
IMPTRATOOLFerramenta de Analise Integração Importador XML x TOTVS Transmite
SCHEDIMPTRAAgendamento requisição e leitura dos recibos
SCHEDUPDTRAAgendamento atualização status no TOTVS Transmite

Passo a passo de configuração

O Meu Protheus é mais uma forma que os usuários têm de conseguirem utilizar o ERP ProtheusSendo assim, são necessárias algumas configurações específicas para  integrar o aplicativo com o ambiente.

Para conhecer mais sobre a configuração necessária, assista ao vídeo.

Card
effectDuration0.5
idConfiguração
effectDuration0.5
idConfiguracao
labelConfiguração
titleConfiguração
effectTypeslide
Aviso
titlePré-Requisitos

Credenciais: É preciso um usuário e senha do Protheus (a partir da versão 12.1.17) para utilizá-lo.

Configurador: Ter a rotina Event Viewer no módulo implantada e funcional.

Lib: A lib com a funcionalidade precisa ser igual ou superior a 20180216.

Dica
titleSuporte

Para uso antes da liberação de janeiro/2018 do Protheus  entre em contato com o suporte da TOTVS e solicite o pacote para atualização do ambiente via UPDDISTR.

Deck of Cards
effectDuration0.5
idContainer
effectTypeslide
Card
defaulttrue
effectDuration0.5
idpadrao
labelPadrão
titlePadrão
effectTypeslide
Deck of Cards
effectDuration0.5
idconfiguracao-2
effectTypeslide
Card
defaulttrue
effectDuration0.5
idambiente-protheus
labelAmbiente Protheus
titleAmbiente Protheus
effectTypeslide
Dica

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

Painel
borderStylenone
titlePreencha o parâmetro MV_MINGKEY

Image Removed

Card
defaulttrue
effectDuration0.5
idconfiguracao-usuario
labelConfiguração do usuário
titleConfiguração do usuário
effectTypeslide
Painel
borderStylenone
titleValide a permissão 174 do usuário

Image Removed

Card
defaulttrue
effectDuration0.5
idevent-viewer
labelEvent Viewer
titleEvent Viewer
effectTypeslide
Painel
borderStylenone
titleInscrição do Event Viewer
Card
defaulttrue
effectDuration0.5
idcustomizado
labelCustomizado
titleCustomizado
effectTypeslide
Deck of Cards
effectDuration0.5
idconfiguracao
effectTypeslide
Card
defaulttrue
effectDuration0.5
idambiente-protheus
labelAmbiente Protheus
titleAmbiente Protheus
effectTypeslide
Dica

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

Painel
borderStylenone
titlePreencha o parâmetro MV_MINGKEY

Image Removed

Card
defaulttrue
effectDuration0.5
idcriacao-evento
labelCriação do evento
titleCriação do evento
effectTypeslide

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.

Card documentos
InformacaoPara eventos customizados, recomenda-se utilizar o padrão de nomear o código do evento iniciando com a letra <b>Z</b>
TituloImportante

Painel
borderStylenone
titleCrie o evento

Image Removed

Card
defaulttrue
effectDuration0.5
idconfiguracao-usuario
labelConfiguração do usuário
titleConfiguração do usuário
effectTypeslide

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.
Painel
borderStylenone
titleValide permissão 174 do usuário

Image Removed

Card
defaulttrue
effectDuration0.5
idevent-viewer
labelEvent Viewer
titleEvent Viewer
effectTypeslide

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. 

Painel
borderStylenone
titleInscrição do Event Viewer

Image Removed

Card
defaulttrue
effectDuration0.5
idnotificacao
labelNotificação
titleNotificação
effectTypeslide

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. 

Aviso

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. 

Deck of Cards
effectDuration0.5
idnotificacoes
effectTypeslide
Card
defaulttrue
effectDuration0.5
idCompilando
labelCompilando
titleCompilando
effectTypeslide

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

Dica

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

Bloco de código
languagejs
themeRDark
firstline0
titleExemplo para envio de notificação.
linenumberstrue
#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

Dica

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 CHAVESIGNIFICADOCORFW_EV_LEVEL_INFOMENSAGEM DE INFORMACÃOCINZAFW_EV_LEVEL_ERRORMENSAGEM DE ERROVERMELHOFW_EV_LEVEL_WARNINGMENSAGEM DE ATENÇÃOAMARELO Card
defaulttrue
effectDuration0.5
idchamando-evento
labelChamando o evento
titleChamando o Evento
effectTypeslide

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

Dica

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

Painel
borderStylenone
titleDISPARE A FUNÇÃO

Image Removed

Card
effectDuration0.5
idinstalacao
labelInstalação
titleInstalação
effectTypeslide

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. 

Painel
borderStylenone
titleDisponível em Android e IOS
Column
width250

Image Removed

Column
width250

Image Removed

Deck of Cards
effectDuration0.5
idFuncionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idWizard
labelWizard
titleWizard
effectTypeslide

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

Link: IX09 - Wizard Configuração

Card
defaulttrue
effectDuration0.5
idDicionario
labelDicionário
titleDicionario
effectTypeslide
  • Tabela DHW
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHW_GRPEMPC2 (Tamanho da Grupo de Empresa)@!RealAlterarSimGrupo Empresa            
DHW_FILEMPC8 (Tamanho da Filial)@!RealAlterarSimFilial Empresa
DHW_CGC   C14@!RealAlterarSimCGC (CNPJ/CPF)
DHW_IE    C14@!RealAlterarSimInscrição Estadual
DHW_UF    C2@!RealAlterarSimEstado
DHW_CODFILC40@!RealAlterarSimCódigo Filial no Transmite
Índices:
DHW_FILIAL+DHW_GRPEMP+DHW_FILEMP                                                                                                                                

DHW_FILIAL+DHW_CGC+DHW_IE                                                                                                                                       

DHW_FILIAL+DHW_CODFIL                                                                                                                                           
  • Tabela DHY
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHY_CODFILC40@!RealAlterarSimCódigo Filial no Transmite         
DHY_TPXML C5@!RealAlterarSimTipo XML (NFE/NFS/CTE/CTEOS)
DHY_ID       C36@!RealAlterarSimId Recibo Transmite
DHY_STATUS   C1@!RealAlterarSimStatus (0-Pendente/1-Ok/2-Erro)
DHY_DTID   D8
RealAlterarSimData Importação ID Recibo
DHY_FILTROC200@!RealAlterarSimFiltro requisição
DHY_TENTN14@999,999,999,999,99RealAlterarSimTentativas
DHY_MESSAGC220@!RealAlterarSimMensagem de retorno do TOTVS Transmite
Índices:
DHY_FILIAL+DHY_CODFIL+DHY_TPXML+DHY_ID                                                                                                                          
DHY_FILIAL+DHY_TPXML+DHY_FILTRO


  • Tabela DHZ
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
DHZ_CODFILC40@!RealAlterarSimCódigo Filial no TOTVS Transmite         
DHZ_TPXML C5@!RealAlterarSimTipo XML (NFE/NFS/CTE/CTEOS)
DHZ_ID       C36@!RealAlterarSimId Recibo Transmite
DHZ_STATUS   C1@!RealAlterarSimStatus (0-Pendente/1-Ok/2-Erro)
DHZ_DTIDD8
RealAlterarSimData Importação
DHZ_FILTROC200@!RealAlterarSimFiltro requisição
DHZ_TENTN14@999,999,999,999,99RealAlterarSimTentativas
DHZ_DTLIDD8
RealAlterarSimData Lido Recibo
DHZ_MESSAGC220@!RealAlterarSimMensagem de retorno do TOTVS Transmite
Índices:
DHZ_FILIAL+DHZ_CODFIL+DHZ_TPXML+DHZ_ID                                                                                                                          
DHZ_FILIAL+DHZ_TPXML+DHZ_FILTRO


  • Tabela CKO
Campo:Tipo:Tamanho:Formato:Contexto:Propriedade:Usado:Descrição:
CKO_CHVDOCC44@!RealVisualizarSimChave Documento      
CKO_ORIGEMC10@!RealAlterarSimOrigem
CKO_STRAN C1@!RealAlterarSimStatus Transmite (1-Pendente/2-CKO/3-SF1)
CKO_ERRTRAM

RealAlterarSimErro status Transmite
CKO_RECIBOC36@!Real AlterarSimRecibo do TOTVS Transmite
Card
effectDuration0.5
idParâmetros
labelParâmetros
titleParâmetros
effectTypeslide
  • 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/CTE/CTOTipo de XML a serem importados pela integração Importador XML x TOTVS Transmite
MV_XMLCIDC
Client ID do TOTVS Transmite

Informação virá do TOTVS Transmite. Para obter a credencial:

  • Na página Inicial do Transmite
  • Clicar no símbolo (interrogação) 
  • Opção - Obter Credenciais
MV_XMLCSECC
Client Secret do TOTVS Transmite

Informação virá do TOTVS Transmite

Para obter a credencial:

  • Na página Inicial do Transmite
  • Clicar no símbolo (interrogação) 
  • Opção - Obter Credenciais
MV_XMLDIASN30Range dias para importar documentos do TOTVS Transmite.

Data Inicio: Data de hoje - MV_XMLDIAS (30)

Data Final: Data de hoje


MV_NGINNC
Caminho para importar XMLs pelo Importador XML

Tratamento continuara funcionando mesmo com a integração com o TOTVS Transmite ativa

Obs: Ambientes Linux deixar nomenclatura minúscula

MV_NGLIDOSC
Caminho para onde o XMLs lidos da pasta IN serão armazenados.

Tratamento continuara funcionando mesmo com a integração com o Totvs Transmite ativa

Obs1: Ambientes Linux deixar nomenclatura minúscula

Obs2: Documentos originados via Totvs Transmite, não serão salvos na pasta LIDOS, pois XML's já são armazenados no Totvs Transite.

MV_APITRANCproductionIndica ambiente do Totvs Transmite (production / staging / development)Default: production
MV_DTINITRD20230101Data de inicio da integração do Importador XML x TOTVS Transmite

Obs: Se não informar será solicitado TODOS documentos no TOTVS Transmite, caso tenha informado, somente a partir da data será selecionado documentos no TOTVS Transmite


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

Image Added

Image Added  

Card
effectDuration0.5
idEmpresa
labelGrupo/Filial
titleEmpresa
effectTypeslide
  • Deve-se informar qual Grupo/Filial estará integrada com o TOTVS Transmite. Para que assim somente XMLs pertencentes ao mesmo Grupo/Filial sejam importados.

Observação: Ao selecionar Grupo/Filial, o mesmo devera conter o seu Código Filial do TOTVS Transmite. Informação estará na tabela DHW (DHW_CODFIL)


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

Image Added

Card
effectDuration0.5
idfuncionalidades-interfaces
labelFuncionalidades e Interfaces
titleFuncionalidades e Interfaces
effectTypeslide

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 Aliasinforme o seu identificador no Mingle ou AppLinker. 

Image Removed

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

Image Removed

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.

Image Removed{

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.

Deck of Cards
effectDuration0.5
idtodas-funcionalidades
effectTypeslide
Card
defaulttrue
effectDuration0.5
idacesso
labelAcesso
titleAcesso
effectTypeslide
Painel
borderStylenone
titleAcesso
Column
width500
Card
defaulttrue
effectDuration0.5
idsolicite-alias
labelSolicite um alias
titleSolicite um Alias
effectTypeslide
Painel
borderStylenone
titleSolicite um alias
Column
width500
Card
defaulttrue
effectDuration0.5
idfilial
labelFilial
titleFilial
effectTypeslide
Painel
borderStylenone
titleEscolha uma filial
Column
width500
Card
defaulttrue
effectDuration0.5
idEventos
labelEventos
titleEventos
effectTypeslide
Aviso
titleImportante

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).

Deck of Cards
effectDuration0.5
idteste
effectTypeslide
Card
defaulttrue
effectDuration0.5
idvisualize
labelVisualize
titleVisualize
effectTypeslide

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

Column
width500
Image Removed{ Card
defaulttrue
effectDuration0.5
idFiltros
labelFiltros
titleFiltros
effectTypeslide

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
Column
width500
Image Removed{ Card
defaulttrue
effectDuration0.5
idCompartilhe
labelCompartilhe
titleCompartilhe
effectTypeslide

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.

Column
width500

Image Removed

{
Card
defaulttrue
effectDuration0.5
idLinks
labelLinks
titleLinks
effectTypeslide

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

Column
width500

Image Removed

{
Card
defaulttrue
effectDuration0.5
idaprovacoes
labelAprovações
titleAprovações
effectTypeslide

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.

Painel
borderStylenone
titleAprovações
Column
width500

Image Removed

Anexos

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

Card
defaulttrue
effectDuration0.5
idAnexos
labelAnexos
titleAnexos
effectTypeslide
Aviso
titleExpedição continua

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

Deck of Cards
effectDuration0.5
idteste
effectTypeslide
Card
defaulttrue
effectDuration0.5
id
visualize
Agendamento
label
Visualizando os anexos
Agendamento
title
Visualize os anexos
Agendamento
effectTypeslide

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

Column
width500

Image Removed

{
Column
width500

Image Removed

{
Card
defaulttrue
effectDuration0.5
idusuario
labelUsuário
titleUsuário
effectTypeslide

Perfil

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

  • Usuário
  • Cliente
  • Empresa
  • Set
  • filial
Painel
borderStylenone
titleAcesso Perfil
Column
width500

Image Removed

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

      RecorrênciaConfiguraçãoConsumo Licença
      COLAUTOREADPara importar XML's através da pasta IN (MV_NGINN) e gravar informações na tabela CKO48 (00:30 min)

      Configurar apenas uma filial por grupo de empresa que ocorrera a importação

      Ex: T1 / D MG 01
            T2 / D SP 01

      Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa.

      Por Empresa
      SCHEDIMPTRAPara requisitar e ler recibos retornados do TOTVS Transmite144 (00:10 min)

      Configurar apenas uma filial por grupo de empresa que ocorrera a importação

      Ex: T1 / D MG 01
            T2 / D SP 01

      Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa.

      Por Empresa
      SCHEDUPDTRAPara atualizar status de documentos no TOTVS Transmite72 (00:20 min)

      Configurar apenas uma filial por grupo de empresa que ocorrera a importação

      Ex: T1 / D MG 01
            T2 / D SP 01

      Obs: Dessa forma ao atualiza status será analisado toda a CKO, com documentos de todos grupos e filiais importados.

      Por Empresa
      SCHEDCOMCOL

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

      288 (00:05 min)

      Configurar TODOS os grupos e filiais que documentos possam pertencer para que sera importado para o monitor no grupo e filial correto

      Ex: T1 / D MG 01

            T1 / D MG 02

            T2 / D SP 01

            T2 / D SP 02

      Por Filial
    • Modulo: (Ex: 02 - Compras)
    • Deixar habilitado
  • 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.


Card
effectDuration0.5
idDocImportados
labelDocumentos Importados
titleDocumentos Importados
effectTypeslide

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



Aviso
titleImportante

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

Card
effectDuration0.5
idFAQs
labelFAQs
titleFAQs
effectTypeslide

FAQs - Integração Importador XML x Totvs Transmite

IX08013 - Importador XML x Totvs Transmite - Performance



Card
defaulttrue
effectDuration0.5
idSuporte
labelSuporte
effectTypeslide

Materiais Auxiliares

Card
defaulttrue
effectDuration0.5
idSuporte
labelSuporte
effectTypeslide
Perguntas Frequentes (FAQs)
Expandir
titleQual o meu Usuário e Senha?

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

Expandir
titleExiste limite de tamanho para PDF nos anexos do pedido de compra?

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

Expandir
titleO que é o Alias?

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.

Expandir
titleEsqueci o meu Usuário e/ou Senha. O que faço?

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

Expandir
titleQuais eventos eu visualizo?

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.

Expandir
titleQuais os status dos eventos?

Os status dos Eventos são:

  • Cinza: Informação
  • Amarelo: Alerta
  • Vermelho: Erro
Expandir
titleComo compartilho um Evento?

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

Expandir
titleQual configuração é necessária para aprovar pedidos de compras no aplicativo?

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).

Expandir
titleÉ possível customizar a aprovação de pedido de compras?

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.

Expandir
titleHá limite no tamanho de arquivo na visualização de anexo de pedido de compra?

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.

Expandir
titleComo sair do Aplicativo?

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óveisImportador XML - Guia de Referencia (SIGACOM)


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



HTML
<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}
Composition Setup
deck.tab.inactive.background = #e7e7e7
deck.tab.active.background = #252626