Importador XML x TOTVS Transmite no Protheus
Mastersiga Consultoria — Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.
🧭 Resumo
O Importador XML simplifica a entrada de notas no Protheus (NFe/NFSe* conforme cenários suportados), reduzindo digitação e erros. Com o TOTVS Transmite, o ganho é maior: os XMLs são sincronizados automaticamente a partir da SEFAZ/Prefeituras e seguem direto para o Importador XML, eliminando o download manual. Sem o Transmite, o usuário precisa baixar os XMLs manualmente no portal da SEFAZ/Prefeitura e alimentar o processo. TOTVS Developer Network+1
🎯 Aplicabilidade
Empresas que utilizam Protheus (SIGACOM) para recebimento fiscal.
Operações com grande volume de NFe/NFSe que buscam automatização de coleta e integração assistida de XMLs. Central de Atendimento TOTVS
⚙️ Conceitos-chave
Importador XML (SIGACOM): rotina que lê XMLs e gera títulos/documentos no Protheus. Pode operar de forma manual (upload/ pasta) ou com agendamentos. Central de Atendimento TOTVS
TOTVS Transmite: orquestra sincronismo automático de NFe/NFSe (quando disponível para o município), integra com TSS, baixa XMLs e os disponibiliza para o Importador XML. Central de Atendimento TOTVS+1
DE/Para (amarras):
Produto x Fornecedor: traduz o código do fornecedor para o código interno do produto. Obrigatório para integrar itens corretamente. Central de Atendimento TOTVS
Produto x Cliente: útil quando há recebimento de devoluções/retornos com código do cliente no XML. Central de Atendimento TOTVS
🧩 Pré-requisitos essenciais
TSS configurado e acessível (on-premise, cloud exclusivo ou compartilhado). Central de Atendimento TOTVS
TOTVS Transmite com empresa/filiais cadastradas (importar do TSS ou cadastrar manualmente, conforme arquitetura). Central de Atendimento TOTVS
Parâmetros e MVs de integração do Importador/Transmite revisados (ex.: MV_DTINITR – data inicial da integração). TOTVS Developer Network
Amarras de item (Produto x Fornecedor / Produto x Cliente) definidas. Central de Atendimento TOTVS+1
Jobs do SIGACOM disponíveis: COLAUTOREAD e SCHEDCOMCOL (schedule). Central de Atendimento TOTVS
🚀 Como operar (visão prática)
A) Com TOTVS Transmite (recomendado)
Configurar Transmite e vincular empresas/filiais (importando do TSS ou cadastrando). Central de Atendimento TOTVS
Habilitar sincronismo (NFe e, quando suportado, NFSe com sincronismo automático por município). Central de Atendimento TOTVS
No Protheus, agendar/confirmar os jobs COLAUTOREAD (lê/valida XML) e SCHEDCOMCOL (dispara a integração). Central de Atendimento TOTVS
Manter DE/Para (Produto x Fornecedor / Produto x Cliente) atualizado para evitar rejeições ou itens sem correspondência. Central de Atendimento TOTVS+1
Resultado: XMLs chegam automaticamente via Transmite e são importados com mínima intervenção do usuário. TOTVS Developer Network
B) Sem TOTVS Transmite (modo manual)
Baixar XMLs manualmente na SEFAZ/Prefeitura.
Colocar os arquivos nas pastas monitoradas do Importador ou executar a leitura via rotina.
Garantir agendamentos COLAUTOREAD e SCHEDCOMCOL para processamento recorrente. Central de Atendimento TOTVS+1
🛠️ Operação e manutenção dos Jobs
Execução manual (troubleshooting):
Pausar no Schedule; 2) Executar COLAUTOREAD; 3) Executar SCHEDCOMCOL na filial correta; 4) Verificar se os XMLs migraram de IN para LIDOS. Atenção à ordem! Central de Atendimento TOTVS
🧪 Boas práticas de cadastro
Produto x Fornecedor: obrigatório para mapear cProd do XML ao código interno do produto no Protheus. Central de Atendimento TOTVS
Produto x Cliente: útil em devoluções/retornos; identifique o cProd no XML e relacione ao produto interno. Central de Atendimento TOTVS
🚨 Erros comuns & como agir
Itens não encontrados / mapeamento falho: revisar Produto x Fornecedor/Cliente e o cProd do XML. Central de Atendimento TOTVS+1
Jobs não processam / XML não sai de IN: rodar COLAUTOREAD e depois SCHEDCOMCOL manualmente; conferir filial de execução. Central de Atendimento TOTVS
Problemas de integração NFSe no monitor/valores inconsistentes: validar notas do tipo serviço e particularidades do fluxo Importador x Transmite. TOTVS Developer Network+1
Parâmetros de início/validação da integração: conferir MVs de integração (ex.: MV_DTINITR). TOTVS Developer Network
Conectividade Transmite x TSS: confirmar porta/URL do TSS sem “/api/tss” na configuração. Central de Atendimento TOTVS
❓FAQ rápido
Preciso do Transmite para usar o Importador XML?
Não. Mas sem o Transmite você fará o download manual dos XMLs; com o Transmite a coleta é automática e o processo fica mais fluido. TOTVS Developer Network+1Como incluo uma nova empresa no Transmite?
Via Configurações → Empresas/Filiais (importar do TSS ou cadastrar). Central de Atendimento TOTVSComo forçar a integração agora?
Pause o Schedule e execute COLAUTOREAD → SCHEDCOMCOL (nesta ordem). Central de Atendimento TOTVS
📌 Referências oficiais (TOTVS)
Importador XML x Transmite – visão/fluxo: IX10/Fluxo de Integração. TOTVS Developer Network
Transmite – incluir/configurar empresa: passo a passo (TSS on-premise, cloud exclusivo/compartilhado). Central de Atendimento TOTVS
Jobs manuais (SIGACOM): COLAUTOREAD e SCHEDCOMCOL (ordem e filial). Central de Atendimento TOTVS
Amarração Produto x Fornecedor (DE/Para): fundamentos e exemplo. Central de Atendimento TOTVS
Amarração Produto x Cliente: conceito e identificação via cProd. Central de Atendimento TOTVS
Parâmetros/MVs de integração (ex.: MV_DTINITR): guia de referência. TOTVS Developer Network
Centro de artigos do Transmite (SEFAZ, NFSe, sincronismo): visão geral e how-tos. Central de Atendimento TOTVS+1
📎 Categoria e tags (sugeridas)
Categoria: Compras (SIGACOM) → Importador XML / Transmite
Tags: Protheus SIGACOM Importador XML TOTVS Transmite TSS COLAUTOREAD SCHEDCOMCOL NF-e NFS-e DE/Para
Mastersiga Consultoria
Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.