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

PASSO 1

Image RemovedO TOTVS Transmite recebe do Importador XML as requisições/solicitações de quais XMLs devem ser “baixados” usando como base os parâmetros e informações da tabela (DHW) abaixo:
Parâmetros:
MV_XMLDIAS;
MV_DOCIMP.Campos tabela (DHW):
- Código da Filial (CodFil).
E no TOTVS Transmite todos os arquivos que estejam com STATUS:
(Ciência de Operação;

YZAB;

IFHZ).

Painel

title	Objetivo

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.

Painel

title	Descrição das Etapas do Processo

Etapas do Processo
TOTVS Transmite

Descrição do Processo

TOTVS Transmite

Perfil de Aprovação.

Compradores.

Grupo de Aprovação.

Deck of Cards

effectDuration	0.5
id	cabecalho
effectType	slide

Card

default	true
effectDuration	0.5
id	transmite
label	Importador XML x TOTVS Transmite
title	Transmite
effectType	slide

Deck of Cards

effectDuration	0.5
id	tudo-sobre
effectType	slide

Card

default	true
effectDuration	0.5
id	Introducao
label	Introdução
title	Introdução
effectType	slide

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

Painel

title	Processo 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]

*Clique na imagem para ampliar.

Painel

title	Integraçã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]

*Clique na imagem para ampliar.

Card

default	true
effectDuration	0.5
id	Fluxograma
label	Fluxograma / Etapas do Processo
title	Fluxograma
effectType	slide

Deck of Cards

effectDuration	0.5
id	Fluxo
effectType	slide

Card

default	true
effectDuration	0.5
id	Fluxograma
label	Fluxograma
title	Fluxograma
effectType	slide

Painel

title	Descrição das Etapas do Processo

Observação:

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

Image Modified

Card

default	true
effectDuration	0.5
id	Etapas
label	Etapas
title	Etapas
effectType	slide

Painel

title	Descrição das Etapas do Processo

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 do Processo TOTVS Transmite	Descrição do Processo TOTVS Transmite
PASSO 1 Image Added	O TOTVS Transmite recebe do Importador XML as requisições/solicitações de quais XMLs devem ser “baixados” usando como base os parâmetros e informações da tabela (DHW) abaixo: Parâmetros: MV_XMLDIAS; MV_DOCIMP. Campos tabela (DHW): - Código da Filial (CodFil). E no TOTVS Transmite todos os arquivos que estejam com STATUS: (Ciência de Operação; YZAB; IFHZ).
Perfil de Aprovação.
Compradores.
Grupo de Aprovação.

Card

effectDuration	0.5
id	Tabelas
label	Tabelas / Fontes
title	Tabelas
effectType	slide

Tabelas:

Tabela	Descrição
DHW	Configuração Grupo/Empresa que integra com o Totvs Transmite
DHY	Grava os Ids para consulta dos XML importados do Totvs Transmite
DHZ	Histórico de Ids com erros e já importados no Importador XML
CKOCOL	Registros do XMLs importados
SDS	Cabeçalho do documento no monitor
SDT	Itens do documento no monitor

Fontes envolvidos:

Fontes	Descrição
COLXCFG	Wizard de configuração TOTVS Colaboração / Importador XML
COLAUTOREAD	Rotina para importar XMLs na CKOCOL
COMTRANSMITE	Classe/Objeto para importação dos XML originados via TOTVS Transmite
COMXCOL	Monitor
MATA140I	Importa NFE/NFS do TOTVS Colaboração / Importador XML
MATA116I	Importa CTE/CTEOS do TOTVS Colaboração / Importador XML

Card

effectDuration	0.5
id	Configuração
label	Configuração
title	Configuração
effectType	slide

Deck of Cards

effectDuration	0.5
id	Funcionalidades
effectType	slide

Card

default	true
effectDuration	0.5
id	Wizard
label	Wizard
title	Wizard
effectType	slide

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

Link: IX09 - Wizard Configuração

Card

default	true
effectDuration	0.5
id	Dicionario
label	Dicionário
title	Dicionario
effectType	slide

Tabela DHW

Campo:	Tipo:	Tamanho:	Formato:	Contexto:	Propriedade:	Usado:	Descrição:
DHW_GRPEMP	C	2 (Tamanho da Grupo de Empresa)	@!	Real	Alterar	Sim	Grupo Empresa
DHW_FILEMP	C	8 (Tamanho da Filial)	@!	Real	Alterar	Sim	Filial Empresa
DHW_CGC	C	14	@!	Real	Alterar	Sim	CGC (CNPJ/CPF)
DHW_IE	C	14	@!	Real	Alterar	Sim	Inscrição Estadual
DHW_UF	C	2	@!	Real	Alterar	Sim	Estado
DHW_CODFIL	C	40	@!	Real	Alterar	Sim	Có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_CODFIL	C	40	@!	Real	Alterar	Sim	Código Filial no Transmite
DHY_TPXML	C	5	@!	Real	Alterar	Sim	Tipo XML (NFE/NFS/CTE/CTEOS)
DHY_ID	C	36	@!	Real	Alterar	Sim	Id Recibo Transmite
DHY_STATUS	C	1	@!	Real	Alterar	Sim	Status (0-Pendente/1-Ok/2-Erro)
DHY_DTID	D	8		Real	Alterar	Sim	Data 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_CODFIL	C	40	@!	Real	Alterar	Sim	Código Filial no TOTVS Transmite
DHZ_TPXML	C	5	@!	Real	Alterar	Sim	Tipo XML (NFE/NFS/CTE/CTEOS)
DHZ_ID	C	36	@!	Real	Alterar	Sim	Id Recibo Transmite
DHZ_STATUS	C	1	@!	Real	Alterar	Sim	Status (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_CHVDOC	C	44	@!	Real	Visualizar	Sim	Chave Documento
CKO_ORIGEM	C	10	@!	Real	Alterar	Sim	Origem
CKO_STRAN	C	1	@!	Real	Alterar	Sim	Status Transmite (1-Pendente/2-CKO/3-SF1)
CKO_ERRTRA	M			Real	Alterar	Sim	Erro status Transmite

Card

effectDuration	0.5
id	Parâmetros
label	Parâmetros
title	Parâmetros
effectType	slide

Parâmetros utilizados na integração.

Parâmetro	Tipo	Conteúdo	Descrição	Observação
MV_IMPXML	L	T	Habilita integração Importador XML	Parâmetro deve ser T para que integração com o TOTVS Transmite funcione.
MV_DOCIMP	C	NFE/NFS/CTE	Tipo de XML a serem importados pela integração Importador XML x TOTVS Transmite
MV_XMLCID	C		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 Opção - Obter Credenciais
MV_XMLCSEC	C		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 Opção - Obter Credenciais
MV_XMLDIAS	N	30	Range dias para importar documentos do TOTVS Transmite.	Data Inicio: Data de hoje - MV_XMLDIAS (30) Data Final: Data de hoje
MV_XMLHIST	L	.F.	Salva histórico de Ids importados e/ou com erros.	O histórico é salvo na tabela DHZ.
MV_NGINN	C		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_NGLIDOS	C		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_APITRAN	C	production	Indica ambiente do Totvs Transmite (production / staging / development)	Default: production
MV_TRAEXP	L	T	T = Somente documentos não integrados com o ERP / F = Todos documentos.	Default: T
MV_TRAXML	C	\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:

Card

effectDuration	0.5
id	Empresa
label	Grupo/Filial
title	Empresa
effectType	slide

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.

Card

default	true
effectDuration	0.5
id	Agendamento
label	Agendamento
title	Agendamento
effectType	slide

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
  COLAUTOREAD Para 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.

Card

effectDuration	0.5
id	DocImportados
label	Documentos Importados
title	Documentos Importados
effectType	slide

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

Documento	Código	Tipo Requisição
NF-e	109	Recebimento
NFS-e	319	Recebimento
CT-e	214	Recebimento
CTEOS	273	Recebimento

Aviso

title	Importante

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

default	true
effectDuration	0.5
id	Suporte
label	Suporte
effectType	slide

Materiais Auxiliares

Importador 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

Árvore de páginas

Versões comparadas

Versão antiga 49

Nova versão 50

Chave

Conteúdo

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

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

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 49

Nova versão 50

Chave

Conteúdo

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

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