Árvore de páginas

Versões comparadas

Chave

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

Informações
iconfalse

Importador 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:

Image Added


Dica
titleDica:

Saiba como configurar a integração do Importador XML x TOTVS Transmite na nossa pagina no YouTube:

Card
effectDuration0.5
idCONFIGURACOESa,b,c,d,e
labelConfiguraçõesConfiguração
titleConfiguraçõesConfiguração
effectTypeslide
Card
cardPasso-2Passo-2Passo-2
Carddeck
effectDuration0.5
idhistoryPasso-1false
labelPasso 1
titlePasso-1
ida,b,c,d,e
effectTypeslide

Texto do passo 1

Card
defaulttrue
effectDuration0.5
id
a
label
CONFIGURAÇÕES: IMPORTADOR XML
title
Configurações
effectTypeslide

Texto do passo 2

  

Guia passo a passo

ConfiguraçãoConfiguraçãoConfiguração
Informações
titleAtençã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.

Deck of Cards
effectDuration0.5
idImplantação, Requisitos
effectTypeslide
Card
defaulttrue
effectDuration0.5
id
Implantação
label
IMPLANTAÇÃO:
title
Funcionalidades
Configurações
effectTypeslide
Nota

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!

Deck of Cards
effectDuration0.5
id
ConfiguraçõesConfiguraçõesConfiguraçõesEmpresaGrupo/FilialEmpresatrueAgendamentoAgendamentoAgendamentoPor Empresa
Requisitos
effectTypeslide
Card
defaulttrue
effectDuration0.5
id
Requisitos
label
REQUISITOS ->
title
ConfiguraçõesPasso ConfiguraçõesConfiguraçõesPasso Configurações
Passos
effectTypeslide
Aviso
titleImportante

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 

Informações

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

Image Added

  • Tabela DHY: Nesta tabela será gravado os Ids para consulta dos XML importados do TOTVS Transmite

Image Added

  • Tabela DHZ: Nesta tabela será gravado o histórico de Ids com erros e já importados no Importador XML.

Image Added

Card
effectDuration0.5
id
Passos
label
PASSO 1 ->
title
Passos
effectTypeslide
Informações

Conector de Widget
urlhttp://youtube.com/watch?v=lJ_n6zHJ8AM


  • Acesso o módulo Configurador (SIGACFG) -> Base de dados -> Dicionário -> Base de dados -> Buscar a tabela "CKO" e alterar o nome para "CKOCOL"

          Image Added


  • 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

         Image Added

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


Aviso
titleImportante

Esses campos devem conter exatamente a mesma informação que foi cadastrada no TOTVS Transmite.



  

Texto do passo 1

Card
effectDuration0.5
id
Passos
label
PASSO 2 ->
title
Passos
effectTypeslide

Conector de Widget
urlhttp://youtube.com/watch?v=JeyVLUuqcKk

Informações
  • Criar uma pasta na Protheus_data - exemplo: "importadorxml"
  • Criar duas subpastas dentro da pasta "importadorxml" chamadas: "inn" e "lidos"
    Image Added


  • Configurar os parametros MV_NGINN e MV_NGLIDOS com os caminhos criados para as pastas conforme exemplo abaixo:

    MV_NGINN:
    \importadorxml\inn
    Image Added

    MV_NGLIDOS: \importadorxml\lidos
    Image Added


Aviso

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.

Texto do passo 2



  

Card
effectDuration0.5
id
Passos
label
PASSO 3 ->
title
Passos
effectTypeslide
  • Passo 1
Card

Conector de Widget
urlhttp://youtube.com/watch?v=PTSZFYLohAI

Informações
  •      Alterar o parâmetro MV_IMPXML para ".T.".

    Image Added



  

Card
default
effectDuration0.5
id
Passos
label
PASSO 4 ->
title
Passos
effectTypeslide

Conector de Widget
urlhttp://youtube.com/watch?v=WWU7cMlx-qE

Informações
  • Adicione no menu do módulo compras a opção WIZIMP:

d105beae-d862-4dbd-9bfd-d07d432765f8.gifImage Added



Aviso

Importante: Executar a rotina até o final onde irá selecionar quais serão as empresas/filiais que deseja realizar a integração.

  

Card
effectDuration0.5
idPassos
labelPASSO 5 ->
titlePassos
effectTypeslide

Conector de Widget
urlhttp://youtube.com/watch?v=TGiN9Ln36bI

Informações
  • 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ênciaConfiguraçãoConsumo Licença

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.

    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



    Aviso

    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.

      

    Card
    effectDuration0.5
    idPassos
    labelPASSO 6 ->
    titlePassos
    effectTypeslide

    Conector de Widget
    urlhttp://youtube.com/watch?v=HK-Ha9bZXB4

    Informações
    • 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


    Informações
    • Saiba mais:

    - Requisitos para utilização da condição de pagamento TES | Condição de pagamento no monitor do importador XML

    - 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

    - Automatização da natureza de rendimento - Importador XML

    - Configurador de Tributos

      

    Card
    effectDuration0.5
    idPassos
    labelPRONTO!
    titlePassos
    effectTypeslide
    Dica

    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!

      

    Card
    effectDuration0.5
    idparametrizações
    labelPARAMETRIZAÇÕES:
    titleparametrizações
    effectTypeslide
    Nota

    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:

    Deck of Cards
    effectDuration0.5
    idparametrizacoes
    effectTypeslide
    Card
    defaulttrue
    effectDuration0.5
    id
    DocImportados
    parametrizacoes
    label
    Documentos Importados
    DOCUMENTOS IMPORTADOS ->
    title
    Documentos Importados
    parametrizacoes
    effectTypeslide
    Lista de documentos importados

    Listaremos os 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


    Saiba quais são os requisitos para que integração de cada tipo de documento funcione corretamente:


    Expandir
    titleNFe
    Expandir
    titleCTe
    Expandir
    titleNFSe
    Expandir
    titleCTEOS
    <EmConstrução/>
    Aviso

    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!

    Card
    effectDuration0.5
    idmonitor
    labelMONITOR ->
    titleparametrizacoes
    effectTypeslide
    • 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:

    mceclip1.pngImage Added


    Aviso

    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 

    O xml saiu da pasta Inn para lidos após processar Schedule, não é apresentado o documento na rotina do monitor.

    O que fazer quando o documento está com o CKO_FLAG = "0

    Card
    effectDuration0.5
    idocorrencias
    labelPRINCIPAIS OCORRÊNCIAS!
    titleparametrizacoes
    effectTypeslide

    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;

    - Erro COM024 - (CT-e);

    - Error.log variable is not array - Type [C] on SCHEDCOMCOL(SCHEDCOMCOL.PRW);

    - Error.log type mismatch on .AND. on IMPXTRA(COMXCOL2.PRW);

      







      

    Card
    effectDuration0.5
    idConfigurações
    labelPARÂMETROS
    title
    Importante
    Configurações
    effectTypeslide


    • Parâmetros utilizados na integração do Importador XML x Transmite:

    Parâmetro

    Tipo

    Conteúdo

    Descrição

    Observaçã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

      

    Card
    effectDuration0.5
    idConfigurações
    labelPONTOS DE ENTRADAS
    titleConfigurações
    effectTypeslide

      

    Card
    effectDuration0.5
    idConfigurações
    labelPRINCIPAIS DÚVIDAS - FAQs
    titleConfigurações
    effectTypeslide
    Expandir
    titleImportador XML

    Dúvidas:

    Configurações adicionais:


    Integração:

    Ocorrências

    Expandir
    titleTOTVS Transmite


    <EmConstrução/>

      

    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



    Informações

    Artigos relacionados

    ...

    Propriedades de página
    hiddentrue
    Itens relacionados
    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}
    
    .tab-nav-link current {
        color: #fff;
    }



    Composition Setup
    deck.tab.inactive.background = #FFFFFF 
    deck.tab.active.background = #252626