Deck of Cards |
---|
| Card |
---|
label | Parâmetros por Coligada |
---|
| 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. ![](/download/attachments/750393316/image2023-4-4_9-51-44.png?version=1&modificationDate=1680612703983&api=v2)
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
![](/download/attachments/750393316/image2023-4-4_9-55-11.png?version=1&modificationDate=1680612911863&api=v2)
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. ![](/download/attachments/750393316/image2023-4-4_9-55-33.png?version=1&modificationDate=1680612933037&api=v2)
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. Aviso |
---|
| O diretório deverá estar compartilhado em rede com todos os usuários, permitindo leitura e gravação. |
|
Card |
---|
label | Parâmetros por Filial |
---|
| As parametrizações a seguir deverão ser realizadas para cada filial que desejar utilizar o processo de importação de arquivo XML. 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. ![](/download/attachments/750393316/image2023-4-4_9-58-9.png?version=1&modificationDate=1680613089523&api=v2)
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: ![](/download/attachments/750393316/image2023-4-4_14-24-39.png?version=1&modificationDate=1680629080143&api=v2)
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
|
Card |
---|
id | TipoRecebimento |
---|
label | Tipo de Recebimento |
---|
| 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.
Expandir |
---|
title | Tipo de Recebimento por Filial |
---|
| Para evitar erro no momento do recebimento, é imprescindível que o parâmetro da filial esteja sempre preenchido indicando como o sistema deve proceder para os fornecedores cujo Tipo de Recebimento não foi informado. Acesse "Ambiente | Parâmetros | Gestão de Estoque, Compras e Faturamento | Integrações | Dados Fiscais | Parâmetros por Filial | Importação/Envio de Arquivo XML 1/2" e informe o Tipo de Recebimento que será utilizado na empresa. ![](/download/attachments/750393316/image2023-4-4_16-23-37.png?version=1&modificationDate=1680636217667&api=v2)
|
Expandir |
---|
title | Tipo de Recebimento por Fornecedor |
---|
| Lembre-se que, caso para alguns fornecedores o tipo de recebimento seja diferente do que foi definido para a filial, você deve fornecer esta informação em "Cadastros > Tabelas Auxiliares > Definições de Cli/For –Importação de Arquivo XML". ![](/download/attachments/750393316/image2023-4-4_16-27-33.png?version=1&modificationDate=1680636453597&api=v2)
|
Âncora |
---|
| TipoRecebimento |
---|
| TipoRecebimento |
---|
|
|
Card |
---|
id | FormulaTipoMovto |
---|
label | Fórmula Tipo Movto Recebimento NF-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). 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.
Expandir |
---|
title | TABXMLCOLAB - Retorna o valor de um campo da tabela de XMLs do Totvs Colaboração (TNFEENTRADA) |
---|
| Expandir |
---|
| - TABXMLCOLAB ('NomeCampo', 'TipoRetorno') onde:
- NomeCampo = Nome do Campo da Tabela TNFEENTRADA. Podemos citar como campos dessa tabela o código da coligada (CODCOLIGADA), o código da filial (CODFILIAL), o código da coligada do fornecedor (CODCOLCFO), o código do fornecedor (CODCFO), a data de emissão (DATAEMISSAO), etc.;
- TipoRetorno = Informa o tipo de retorno relativo ao campo informado em NomeCampo, se S (string), V (valor), D (data) ou I (inteiro).
|
Expandir |
---|
title | Exemplo de fórmula de seleção do tipo de movimento utilizando a função TABXMLCOLAB |
---|
| ![](/download/attachments/750393316/image2023-4-4_16-40-16.png?version=1&modificationDate=1680637216610&api=v2)
Neste exemplo o sistema irá verificar na tabela TNFEENTRADA (tabela que contém os XML importados) o registro gerado pelo XML e caso o código do fornecedor seja F00017 o movimento será gerado com o tipo 1.2.27, caso contrário o tipo do movimento será 1.2.20. |
|
Expandir |
---|
title | DADOSXMLCOLAB - Retorna o valor de uma TAG de um XML |
---|
| Expandir |
---|
| - DADOSXMLCOLAB ('CaminhoTAG', 'NamespaceXML') onde:
- CaminhoTAG = Caminho da TAG desejada, separado por barra ( / ). Exemplo: '/nfeProc/NFe/infNFe/det/prod/CFOP' para o CFOP do produto do XML;
- IMPORTANTE: O Caminho da Tag deve ser informado exatamente como consta no XML, esta pesquisa considera letras maiúsculas e minúsculas (Case Sensitive).
- NamespaceXML = http://www.portalfiscal.inf.br/nfe
|
Expandir |
---|
title | Exemplo de fórmula de seleção do tipo de movimento utilizando a função DADOSXMLCOLAB |
---|
| ![](/download/attachments/750393316/image2023-4-4_16-49-39.png?version=1&modificationDate=1680637779973&api=v2)
Quando a tag possuir índice, basta informá-lo o entre colchetes ([ ]). No exemplo acima o sistema irá retornar a informação da TAG CFOP do primeiro item da NFe, já que não informamos nenhum índice. Veja abaixo um exemplo da mesma fórmula retornando o CFOP do 2º item da NFe: ![](/download/attachments/750393316/image2023-4-4_16-52-11.png?version=1&modificationDate=1680637932210&api=v2)
|
|
Expandir |
---|
title | QTDTAGSXMLCOLAB - Retorna o número de vezes que uma determinada Tag aparece no XML |
---|
| Expandir |
---|
| - QTDTAGSXMLCOLAB ('CaminhoTAG', 'NamespaceXML') onde:
- CaminhoTAG = Caminho da TAG desejada, separado por barra ( / ). Exemplo: '/nfeProc/NFe/infNFe/det' para o produto do XML;
- NamespaceXML = http://www.portalfiscal.inf.br/nfe
|
Expandir |
---|
title | Exemplo de fórmula de seleção do tipo de movimento utilizando as funções QTDTAGSXMLCOLAB |
---|
| ![](/download/attachments/750393316/image2023-4-4_17-6-41.png?version=1&modificationDate=1680638801977&api=v2)
No exemplo acima através da função QTDTAGSXMLCOLAB o sistema irá identificar o número de itens constantes do XML. Após isso, através da função DADOSXMLCOLAB, irá percorrer todos os itens do XML e caso exista algum cujo CFOP seja 5.102 o tipo de movimento gerado será o 1.2.12. Assim, utilizando em uma mesma fórmula estas duas funções (QTDTAGSXMLCOLAB e DADOSXMLCOLAB), o sistema irá verificar determinado dado de todos os itens constantes de um XML.
|
|
Expandir |
---|
title | TABPRDCOLAB - Retorna o conteúdo de um campo do cadastro dos produtos vinculados aos itens constantes do XML |
---|
| Expandir |
---|
| - TABPRDCOLAB ('CodigoProdutoColab', 'NomeCampo', 'TipoRetorno') onde:
- CódigoProdutoColab = Código do Produto na tabela "Produtos TOTVS Colaboração";
- NomeCampo = Nome do campo da tabela de Produtos;
- TipoRetorno = Informa o tipo de retorno relativo ao campo informado em NomeCampo, se S (string), V (valor), D (data) ou I (inteiro).
|
Expandir |
---|
title | Exemplo de fórmula de seleção do tipo de movimento utilizando a função TABPRDCOLAB |
---|
| ![](/download/attachments/750393316/image2023-4-4_17-11-16.png?version=1&modificationDate=1680639076510&api=v2)
Neste exemplo, em primeiro lugar o sistema utilizará a função QTDTAGSXMLCOLAB para identificar o número de itens constantes do XML, logo depois, através da função DADOSXMLCOLAB irá percorrer todos os itens do XML e através da função TABPRDCOLAB irá identificar na tabela Produtos TOTVS Colaboração quais são os produtos vinculados aos itens do XML. Após verificar sua tabela de produtos e irá analisar se algum deles possui a Tabela de Classificação 1 preenchida com 05. Em caso afirmativo o sistema irá gerar o movimento com o tipo 1.2.12, caso contrário o movimento será do tipo 1.2.11. Assim, utilizando em uma mesma fórmula estas três funções (QTDTAGSXMLCOLAB, DADOSXMLCOLAB e TABPRDCOLAB), o sistema irá verificar determinado dado de todos os itens constantes de um XML e ainda irá compará-lo com determinado campo do seu cadastro de Produtos. Caso, para algum XML, através da fórmula não seja possível definir o seu tipo de movimento, o XML será criado na base de dados com o status 'Inconsistente' e poderá ser recebido manualmente. |
|
|
|
|