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

Para que a integração entre o Importador XML e TOTVS Transmite funcione 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]



[Imagem para ilustrar a integração de forma macro entre o Importador XML e o TOTVS Transmite]


(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 prévio conhecimento dos processos que são envolvidos nesta integração e que estão listados abaixo.


SIGACFG

Configurador

SIGACOM

Compras

SIGAFIN

Financeiro

SIGAEST

Financeiro

TOTVS

Transmite

Usuários.

Aprovadores.

Condição de Pagamento.



Parâmetro MV_APRPCEC.

Perfil de Aprovação.




Parâmetro MV_PCAPROV.

Compradores.




Parâmetro MV_ALTPDOC.Grupo de Aprovação.




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. 

  • 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

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

Link: IX09 - Wizard Configuração

  • 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
Índices:
DHY_FILIAL+DHY_CODFIL+DHY_TPXML+DHY_ID                                                                                                                          


  • 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)
Índices:
DHZ_FILIAL+DHZ_CODFIL+DHZ_TPXML+DHZ_ID                                                                                                                          


  • 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
  • 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 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_XMLHISTL.F.Salva histórico de Ids importados e/ou com erros.O histórico é salvo na tabela DHZ.
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

Obs: Ambientes Linux deixar nomenclatura minúscula

MV_APITRANCproductionIndica ambiente do Totvs Transmite (production / staging / development)Default: production
MV_TRAEXPLTT = Somente documentos não integrados com o ERP / F = Todos documentos.Default: T
MV_TRAXMLC\transmite\Diretório que será criado dentro da pasta in (MV_NGINN) para leitura dos XML importados via TOTVS Transmite.

Obrigatório ter preenchido parâmetro MV_NGINN.

Obs: Ambientes Linux deixar nomenclatura minúscula


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

 




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

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.
      Observação: 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

Materiais Auxiliares

Importador XML - Guia de Referencia (SIGACOM)


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