Para o correto funcionamento da rotina de "Inclusão de Movimento Através do XML - NF-e" será necessário algumas definições, como:
- Definir o diretório de importação
- Definir o parceiro para recebimento dos arquivos XML
- Definir os documentos que serão importados
- Avaliar se o processo poderá ser 100% automatizado
A seguir, detalhamos toda a parametrização referente a esta etapa.
Em “Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Integrações > Fiscal > Importação/Envio de Arquivos XML”, deverá ser preenchido por filial o “Tipo de Integração” e o diretório onde serão salvos os arquivos XML.
Obs: Esta parametrização é realizada apenas 1 vez, para cada coligada.
Tipo de Integração:
- TOTVS Colaboração 2.00 - indica que é utilizado a integração com a Neogrid.
- TOTVS Colaboração 1.00 - indica utilização do TSS
- TOTVS Processos Fiscais - indica que está utilizando o TPF (TOTVS Processos Fiscais)
- TOTVS Transmite – indica que está utilizando o TOTVS Transmite
- Não Utiliza - indica que não utiliza nenhum dos parceiros disponíveis
Realizar Importação de XML de NF-e e CT-e (sem integração com parceiros): marque apenas se não houver contratação de parceiro para disponibilizar os arquivos XML automaticamente na pasta Client EDI.
Diretório Padrão para Importação dos Arquivos XML: informe o diretório escolhido para a integração (diretório onde os arquivos XML serão salvos), que deverá conter as subpastas IN e RM.
A partir da release 12.1.2402 será possível utilizar este cadastro em ambientes multi-tenant. Para estes ambientes o diretório deverá ser informado manualmente (não será possível selecionar). Isso se faz necessário, pois o diretório escolhido será uma subpasta do FileServerpath, (para mais informações acesse: Configuracao das Tags FileServerPath e LogPath). Dessa forma, não deverá ser informado um caminho com uma raiz (exemplo: C:\pasta), será definida apenas a subpasta para ser utilizada no FileServerpath. Conforme exemplo abaixo:
Esta configuração para ambiente Multi Tenant está disponível a partir da versão 12.1.2402
Atenção!
O diretório deverá estar compartilhado em rede com todos os usuários, permitindo leitura e gravação.
Em “Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Integrações > Fiscal > Parâmetros por Filial > Importação/Envio de Arquivos XML 1/2”, deverá ser definido qual o tipo de documento fiscal será recebido pelo processo de importação de arquivos XML.
Obs: Estas parametrizações deverão ser realizadas para cada filial que desejar utilizar o processo de importação de arquivo XML.
Na segunda etapa, em “Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Integrações > Fiscal > Parâmetros por Filial > Importação/Envio de Arquivos XML 2/2”, deverão ser definidos:
1 – O tipo de recebimento de NF-e - O campo "Tipo de Recebimento de NF-e" define a forma como o sistema irá realizar o processo de recebimento automático das NF-e. Esta informação é parametrizável por Filial e/ou por Fornecedor.
Para mais informações sobre o tipo de recebimento, acesse a aba Tipo de Recebimento.
2 – A Fórmula Tipo Mov. p/Recebimento NF-e – Poderá ser definido uma fórmula com regras especificas para entrada automática das NF-e’s.
Para mais informações sobre o tipo de recebimento, acesse a aba Fórmula Tipo Movto Recebimento NF-e.
3 – Recebimento de CT-e - definir um tipo de movimento default para o recebimento do CT-e
Esta etapa deverá ser parametrizada apenas se o processo de inclusão de documentos a partir de arquivos XML for ocorrer de forma totalmente automatizada. Para isto, devera ser avaliado se há necessidade de interferência do usuário no momento da inclusão do movimento (se durante o processo de inclusão do movimento for necessário preenchimento ou conferência de campos, a inclusão de documentos a partir de arquivos XML não poderá ser totalmente automatizada, sendo desnecessário o preenchimento dos parâmetros abaixo).
O campo "Tipo de Recebimento de NF-e" define a forma como o sistema irá realizar o processo de recebimento automático das NF-e. Esta informação é parametrizável por Fornecedor e/ou por Filial. Assim, quando do recebimento automático de uma NF-e, caso o emitente da mesma conste na tabela de definições do Cli/For para importação de XML ("Cadastros > Tabelas Auxiliares > Definições de Cli/For – Importação de Arquivo XML"), essa informação prevalecerá sobre o parâmetro definido por filial. Ou seja, para determinados fornecedores poderá ser definido um Tipo de Recebimento diferente do que é praticado geralmente.
Caso a filial não vá utilizar a rotina de recebimento automático da NF-e, o campo "Tipo de Recebimento de NF-e" deverá permanecer em branco.
Esta etapa deverá ser parametrizada apenas se o processo de inclusão de documentos a partir de arquivos XML for ocorrer de forma totalmente automatizada. Para isto, devera ser avaliado se há necessidade de interferência do usuário no momento da inclusão do movimento (se durante o processo de inclusão do movimento for necessário preenchimento ou conferência de campos, a inclusão de documentos a partir de arquivos XML não poderá ser totalmente automatizada, sendo desnecessário o preenchimento dos parâmetros abaixo).
Em “Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Integrações > Fiscal > Parâmetros por Filial > Importação/Envio de Arquivos XML 2/2”>”, deverá ser preenchido por filial o campo "Fórmula Tipo Mov. p/Recebimento NF-e".
Este parâmetro é do tipo fórmula, e assim, através do mesmo, o usuário poderá implementar uma regra específica para buscar o tipo de movimento que será utilizado tanto no recebimento automático como no recebimento manual das NF-e de cada filial.
Essa fórmula será executada para cada XML a ser recebido.
Foram criadas quatro novas funções de fórmula para auxiliar na criação dessa regra, são elas:
- TABXMLCOLAB - Retorna o valor de um campo da tabela de XMLs do Totvs Colaboração (TNFEENTRADA);
- DADOSXMLCOLAB - Retorna o valor de uma TAG de um XML;
- QTDTAGSXMLCOLAB - Retorna o número de vezes que uma determinada Tag aparece no XML;
- TABPRDCOLAB - Retorna o conteúdo de um campo do cadastro dos produtos vinculados aos itens constantes do XML.
Explicaremos a seguir a sintaxe de cada uma dessas funções bem como daremos exemplos de utilização de todas elas.