- Criado por Danilo Furtado Justiniano, última alteração por Amanda Barbara de Souza em 13 set, 2024
Tempo aproximado para leitura: superior a 15 minutosImportador XML simplifica a inclusão de notas de entrada no Protheus, aumentando a eficiência diária do cliente. Com o TOTVS Transmite, o processo é ainda mais automatizado, pois os XMLs são baixados automaticamente da Sefaz e inseridos no Protheus. Sem o TOTVS Transmite, o download manual dos XMLs na Sefaz é necessário.
Processo de Integração:
Dica:
Saiba como configurar a integração do Importador XML x TOTVS Transmite na nossa pagina no YouTube:
- HowTo Passo a Passo:
Atenção
Nesta guia veremos passo a passo para implantação do Importador XML com integração com TOTVS Transmite. O procedimento será dividido em duas etapas:
Implantação: Nesta etapa veremos passo a passo como preparar o ambiente Protheus para utilização do Importador XML;
Parametrizações: Nesta etapa veremos as principais parametrizações do Importador XML. Exemplo: Configurações dos principais parâmetros, Documentos Importados, entre outros.
Para uma implantação com êxito, solicitamos que seja seguido TODOS os passos das guias abaixo, iniciando por: Requisitos
Atenção: Recomendamos que não seja avançado para próxima etapa sem a finalização da etapa atual!
Importante
Antes de iniciar o processo de configuração, é extremamente importante realizar atualização do módulo compras com a última versão da expedição continua: Atualização - COMPRAS
Observação: Realizar também a atualização de dicionário: Executando o compatibilizador de Upgrade de Release - UPDDISTR
IMPORTANTE: Com este procedimento, será criado algumas tabelas pertinentes ao processo de integração, sem elas não será possivel prosseguir com as configurações:
- Tabela DHW: Nesta tabela será gravado as configuração Grupo/Empresa que integra com o TOTVS Transmite
- Tabela DHY: Nesta tabela será gravado os Ids para consulta dos XML importados do TOTVS Transmite
- Tabela DHZ: Nesta tabela será gravado o histórico de Ids com erros e já importados no Importador XML.
- Acesso o módulo Configurador (SIGACFG) -> Base de dados -> Dicionário -> Base de dados -> Buscar a tabela "CKO" e alterar o nome para "CKOCOL"
- Acesso o módulo Configurador (SIGACFG) -> Empresas ->Filial -> Posicionar na filial que receberá integração com TOTVS Transmite > Alterar > Preencher campos CNPJ ou CPF e Inscrição Estadual
- Valide as configurações no Portal do TOTVS Transmite em relação à inclusão da empresa, garantindo que todos os detalhes estejam conforme o cadastro no Protheus:
- Acesse o Portal do TOTVS Transmite > Faça login utilizando suas credenciais de acesso.
- Verifique as Configurações da Empresa > Procure por uma seção ou página no Portal que exiba as configurações da empresa.
- Compare com os Dados do Protheus: Compare as informações disponíveis no Portal do TOTVS Transmite com os dados cadastrados no sistema Protheus. Isso inclui detalhes como razão social, CNPJ, endereço, entre outros.
Mais detalhes em: Cross Segmentos - TOTVS Transmite – Como incluir e configurar uma nova empresa no Transmite?
Importante
Esses campos devem conter exatamente a mesma informação que foi cadastrada no TOTVS Transmite.
- Criar uma pasta na Protheus_data - exemplo: "importadorxml"
- Criar duas subpastas dentro da pasta "importadorxml" chamadas: "inn" e "lidos"
- Configurar os parametros MV_NGINN e MV_NGLIDOS com os caminhos criados para as pastas conforme exemplo abaixo:
MV_NGINN:
\importadorxml\inn
MV_NGLIDOS: \importadorxml\lidos
OBSERVAÇÃO: As pastas devem constar no caminho Protheus_data, mantenha o diretório sem espaços .
ATENÇÃO: Ambiente Linux não aceita diretório com letras maiúsculas.
- Alterar o parâmetro MV_IMPXML para ".T.".
Adicione no menu do módulo compras a opção WIZIMP:
Observação: Na segunda etapa do vídeo são apresentados os campos de credenciais para preenchimento com informações obtidas no TOTVS Transmite.
- Client ID - Client ID do TOTVS Transmite;
- Client SECRET - Client Secret do TOTVS Transmite.
Como obter as Credenciais as Informações obtidas através do TOTVS Transmite
Para obter a credencial:
- Na página Inicial do Transmite
- Clicar no símbolo
- Opção - Obter Credenciais
- Link de Apoio para Configuração Wizard para Auxiliar na Configuração do Importador XML e Integração com o Totvs Transmite
Importante: Executar a rotina até o final onde irá selecionar quais serão as empresas/filiais que deseja realizar a integração.
- Configuração do Schedule: Neste Passo devemos realizar a criação dos seguintes agendamentos conforme indicado nas documentações a seguir:
- SCHEDIMPTRA : Responsável por requisitar os novos XMLs ao TOTVS Transmite para o Protheus na rotina Importador XML;
- SCHEDCOMCOL: Responsável por realizar a integração dos XMLs importados na tabela CKOCOL pelo agendamento SCHEDIMPTRA para o monitor do Importador XML;
- SCHEDUPDTRA : Responsável por atualizar o campo "Integração ERP" do TOTVS Transmite referente aos XMLs importados ao Protheus através do Importador XML;
Agendamento |
Descrição |
Recorrência | Configuração | Consumo Licença |
|---|---|---|---|---|
| SCHEDIMPTRA | Para requisitar e ler recibos retornados do TOTVS Transmite | 144 (00:10 min) | Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 01 Obs: Dessa forma ao importar XML será analisado se documento pertence a qualquer filial de cada grupo de empresa. |
Por Empresa |
| SCHEDUPDTRA | Para atualizar status de documentos no TOTVS Transmite | 72 (00:20 min) | Configurar apenas uma filial por grupo de empresa que ocorrera a importação Ex: T1 / D MG 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 |
Atenção: O agendamento COLAUTOREAD não será utilizado na integração entre importador xml x transmite para garantir melhor performance no sistema, exceto em casos que são necessarios uma importação dos XMLs incluidos MANUALMENTE na pasta INN. Como é um cenario especifico, incluir a função COLAUTOREAD para execução pontual destes XMLs conforme atigo: Como executar as funções de carga SEM utilizar o Schedule
Observação: Cada execução de um dos agendamentos cadastrados será consumido uma licença do Compras, assim como ocorre no acesso via menu.
- Cadastros: Para correto funcionando do Importador XML, é necessario realizar alguns cadastros prévios:
- Amarração Produto x Fornecedor: Cadastro de Produto x Fornecedor
- Amarração Produtos x Cliente (Nota de Devolução): Cadastro de Produto x Cliente
- Como utilizar Condição de Pagamento | TES: Regras TES / CFOP(Config.Tributos) / Condição de pagamento
- Saiba mais:
- Como gerar uma pré-nota automaticamente após a importação do XML?
- Como Importar um Documento do Tipo Normal já Classificado ?
- Como utilizar segunda unidade de medida no Importador XML?
- Entenda como funciona o processo da funcionalidade de revisão cadastral
- Automação Cadastral (Exclusivo Importador XML x TOTVS Transmite)
- Saiba como utilizar E-mail (Eventviewer) - Importador XML
Pronto! A Rotina Importador XML já está preparada para utilização do Importador XML integrado ao TOTVS Transmite, agora vá para sessão "PARAMETRIZAÇÕES" e realize as configurações de acordo com cada tipo de nota que será Importado!
Nesta etapa devemos realizar algumas parametrizações para atender a regra de negócio de cada empresa:
Atenção: Recomendamos que leia todos os conteúdos a seguir:
Listaremos os 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 |
Saiba quais são os requisitos para que integração de cada tipo de documento funcione corretamente:
NFe
- Inclusão de NFe via Importador XML
- Importador XML identificação de Tags no XML, para vinculo de pedido de compras
- Regras TES / CFOP(Config.Tributos) / Condição de pagamento
- Segunda unidade de medida
- XML com rastro e unidades de medidas diferente
- Documentos complementares (Preço/Quantidade)
- Importador XML - Aba Impostos
- Importação de Documento do Tipo Beneficiamento Classificado
- Importação de documentos cancelados e/ou rejeitada
- Importador XML - Regra CLASFIS
- É possível Importar um documento do Tipo Beneficiamento Classificado
CTe
- Inclusão de CTE via Importador XML
- Importação de CTE definição dos produtos utilizados no documento.
- Como são definidos os produtos e o Tipo de Documento na importação do Documento de Frete / CTe no Importador XML?
- Regra tipo de frete - Conhecimento de Frete
- Os CTE's não estão sendo integrados, permanecendo com o status de integração ERP como "Pendente"
- Após importar uma CTe está sendo gerado o codigo de erro COM024 - c116Tes := ←Invalido
- Conhecimento de Frete - Valor Zerado
- COM020 - Documento de entrada inexistente na base
- Erro COM024 - (CT-e)
NFSe
CTEOS
<EmConstrução/>
Atenção: A importação do documento NFSe estará exclusivamente disponivel para integração do Importador XML com TOTVS Transmite.
Caso não tenha essa integração, NÃO será possivel importar este tipo de documento!
- Para validar os documentos que foram importados utilizando o Monitor do Importador XML, siga os passos indicados:
- Acesse: Módulo SIGACOM (COMPRAS) >Miscelânea → Importador XML → Monitor
- Paramentros: Preencher as parametrizações conforme a necessidade, segue exemplo abaixo:
Caso não seja apresentado documentos na rotina verificar a documentações:
Os documentos não estão aparecendo na rotina do monitor do Importador XML
Ocorrências: Abaixo Listaremos as principais ocorrências que podem ocorrer no monitor do Importador XML:
- Os documentos não estão aparecendo na rotina do monitor do Importador XML
- O que fazer quando o documento está com o CKO_FLAG = "0
- Os documentos não estão aparecendo na rotina do monitor
- Os documentos não estão aparecendo na rotina do REPROCESSAR dentro monitor
- Códigos de erro no REPROCESSAR do Importador XML;
- Principais parâmetros do Importador XML;
- Principais Dúvidas x Ocorrências do Importador XML;
- Após importar uma CTe está sendo gerado o codigo de erro COM024 - c116Tes := <--Invalido;
- Error.log variable is not array - Type [C] on SCHEDCOMCOL(SCHEDCOMCOL.PRW);
- Error.log type mismatch on .AND. on IMPXTRA(COMXCOL2.PRW);
- Parâmetros utilizados na integração do Importador XML x Transmite:
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/CTO | 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:
|
|
| MV_XMLCSEC | C | Client Secret do TOTVS Transmite | Informação virá do TOTVS Transmite Para obter a credencial:
|
|
| 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_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 Obs1: Ambientes Linux deixar nomenclatura minúscula |
|
| MV_APITRAN | C | production | Indica ambiente do Totvs Transmite (production / staging / development) | Default: production |
| MV_DTINITR | D | 20230101 | Data 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 |
Importador XML
Dúvidas:
- Como funciona os cálculos de impostos na rotina do monitor?
- Guias de Referência Totvs Colaboração e Importador XML
- Quais os parâmetros básicos para configuração do Totvs Colaboração e Importador XML?
- É possível Importar um Documento e já gerar pré-nota automaticamente ?
- Legenda dos campos: DS_STATUS, CKO_STATUS, DS_TIPO
- Gravar Origem + CST quando documento é originado via Totvs Colaboração
- Como gravar origem e cst quando documento é gerado pelo monitor do Importador XML?
- Configuração de TES Inteligente para utilização no TOTVS Colaboração
- Identificação das flags apresentadas no Totvs Colaboração
- Como é gravado o Tipo de Frete (DS_TPFRETE) ao Importar o Xml?
- Após processar schedule, não é apresentado na opção Reprocessar o XML da filial correta.
- Qual o Consumo de Licenças das rotinas responsáveis pela importação e gravação do XML
- Identificação das flags apresentadas no Totvs Colaboração
- Como é importado o arquivo XML através do Totvs Colaboração ?
- Como permitir Inclusão de Documento de Entrada sem Pedido vinculado, com o MV_PCNFE ativado (MV_TESPCNF) ?
- O campo D1_CLASFIS esta mudando quando a nota tem informações no campo DT_CLASFIS.
- Se o XML ESTIVER for consumido da pasta IN para LIDOS, mas NÃO está aparecendo no MONITOR.
- Como tornar vínculo de Pedido de Compras obrigatório no Documento de Entrada ?
- Como são definidos os produtos e o Tipo de Documento na importação do Documento de Frete / CTe no Importador XML?
- Regras TES / Condição de pagamento
- Inclusão de CTE via Importador XML
- Como é realizado o preenchimento do campo DT_CHVNFO ?
- Algumas Regras para importação de NFe no Totvs Colaboração
- Configuração para XML do Fornecedor com segunda unidade de medida no Importador XML
- Como é realizado o preenchimento do campo DT_CHVNFO ?
- Como dar entrada em NF de Beneficiamento pelo Totvs Colaboração ou Importador XML ?
- Existe a impressão DANFE online no Monitor do Importador XML ?
- Qual a validação da Importação de Documentos XML com mesmo nome - CKO_ARQXML ?
- Importador XML - Vinculo com pedido de compras
- Campo de Pedágio (DS_VALPEDG) / Importador XML
- O que fazer quando o conteúdo do campo CKO_FLAG está = "2"?
- Automatização da natureza de rendimento - Importador XML
- Como é alimentado os campos DT_LOTE e DT_DTVALID pelo Importador XML?
- Importador XML - Regras TES / Condição de pagamento
- Importador XML - Deletar linha da Entrada da Nota Fiscal no Monitor
- É possível Importar um Documento do Tipo Normal já Classificado ?
- É possível Importar um documento do Tipo Beneficiamento Classificado
Configurações adicionais:
- Wizard Importador XML: Não foi encontrada Grp Empresa/Filial no TOTVS Transmite"
- Como executar as funções de carga SEM utilizar o Schedule
- Configuração para XML do Fornecedor com segunda unidade de medida no Importador XML
- COLABORAÇÃO - COM020 - Documento de entrada inexistente na base.
- Totvs Colaboração / Importador XML - Erro COM024 na Execauto (CT-e)
- Ponto de entrada COMCOLF4:Altera o campo DT_TES
- COLABORAÇÃO - COM007 - Fornecedor/Cliente inexistente na base
- Trilha de Videos: Importador XML
- Totvs Colaboração / Importador XML - Erro COM012 no Monitor
- Qual o Ponto de Entrada para o CT-e ser incluso como Tipo Normal no Totvs Colaboração ou Importador XML ?
- Códigos de erro no REPROCESSAR do Importador XML
- Códigos de preenchimento do campo CKO_FLAG
- Baixar Notas de conhecimento de frete(CTE)
- Importador XML - Geração do CIAP
- Como configurar o Schedule para Totvs Colaboração
- Pontos de Entrada Totvs Colaboração e Importador XML
- Importador XML - Legenda "Docto Pendente de Revisão Cadastral" - Automação Cadastral
- Monitor do Importador XML / Colaboração impede / bloqueia alterar documento de CTe importado
- Configuração padrão dos impostos no Importador XML/ Totvs Colaboração para o documento de entrada.
- Principais parâmetros do Importador XML;
Integração:
- Como atualizar o campo 'Integração ERP' no TOTVS Transmite?
- Status de documento no TOTVS Transmite quando inseridos via Documento de Entrada
- Os CTE's não estão sendo integrados, permanecendo com o status de integração ERP como "Pendente"
Ocorrências
Os documentos não estão aparecendo na rotina do monitor do Importador XML
- O que fazer quando o documento está com o CKO_FLAG = "0
- Os documentos não estão aparecendo na rotina do monitor
- Os documentos não estão aparecendo na rotina do REPROCESSAR dentro monitor
- Ao importar o XML é gerado o código de erro COM052 no reprocessar do Importador XML
- Erro COM024 - (CT-e)
- Ao gerar Nota de Devolução no Monitor do Colaboração / Importador XML ocorre erro de " type mismatch on + on COLVERDEV(COMXCOL.PRW)
- COM020 - Documento de entrada inexistente na base
- Importador XML - Ao reprocessar um XML é gravado código de erro COM053 na tela do Monitor e na tabela CKOCOL (CKO_CODERR)
- Códigos de erro no REPROCESSAR do Importador XML;
- Principais Dúvidas x Ocorrências do Importador XML;
- invalid property _CTEPROC on IMPORTCOL(COMXCOL.PRW) ao executar o SCHEDCOMCOL
- Após importar uma CTe está sendo gerado o codigo de erro COM024 - c116Tes := <--Invalido;
- Error.log variable is not array - Type [C] on SCHEDCOMCOL(SCHEDCOMCOL.PRW);
- Mensagem de " Divergência Fiscal " ao gerar documento no Monitor do Colaboração / Importador XML
- Error.log type mismatch on .AND. on IMPXTRA(COMXCOL2.PRW);
TOTVS Transmite
<EmConstrução/>