Destina-se ao grupo INGAque tem a necessidade de ter no LinxDMS as notas fiscais de grãos (emitidas pelo sistema de terceiros - SGI), assim unificando com veículos e peças os módulos financeiro, contábil e fiscal.

https://grupolinx-my.sharepoint.com/personal/pollyanne_firmiano_linx_com_br/_layouts/15/stream.aspx?id=%2Fpersonal%2Fpollyanne%5Ffirmiano%5Flinx%5Fcom%5Fbr%2FDocuments%2FGrava%C3%A7%C3%B5es%2FOrienta%C3%A7%C3%A3o%5F%20Importa%C3%A7%C3%A3o%20XML%20de%20gr%C3%A3os%20INGA%2D20240123%5F100307%2DGrava%C3%A7%C3%A3o%20de%20Reuni%C3%A3o%2Emp4&referrer=StreamWebApp%2EWeb&referrerScenario=AddressBarCopied%2Eview

CONCEITOS DO PROCESSO             

No LinxDms foi criado um serviço que lê XML's  (gerados pelo terceiro SGI) das notas de entrada/saída/cancelamento/inutilização/Cte/Despesas apenas de Grãos. Essas notas serão gravadas no departamento 'GRAOS' e irá existir transações específicas (iniciadas com a letra 'G') para geração do processo fiscal, financeiro e contábil.

Essa importação não precisa de interação do usuário, acontece em background. Mas existe uma tela para visualizar notas importadas com sucesso e com erros.

Esses arquivos são espelhos idênticos que estão na Sefaz , em nosso sistema serão consideras com Descrição Livre ou Despesa.

Para habilitar as parametrizações e usabilidades especificas para GRÃOS é necessário intervenção por banco de dados (comando no detalhamento).

IMPORTANTE: Todas as regras abaixo foram definidas juntamente com o grupo técnico e fiscal da Ingá, logo estão homologadas e no ambiente de produção.

ESTRUTURA DO XML - DIRETÓRIOS - SERVIÇO:

• • Os XMLs gerados pela INGA, será no padrão da SEFAZ, ou seja, em cima dos XSD da SEFAZ (layout 4.00) para o modelo NF (55) e modelo 57 (CT-e) .
  • Modelos 57, 96, A1, 01, 1A, recibos, faturas e outros documentos sem modelos, mas todos vinculados ao processo de grãos, todos deverão ser gerado um XML pela SGI no modelo 55 (NF-e); Alguma TAG com sintaxe diferente do XSD a nota não será importada.
  • Criar um diretório no "C:\" do servidor da INGA chamado "INGA" e os subdiretórios : (todos devem possuir permissão de leitura/escrita)
    • EXP : armazena xml de terceiros (destinatário CNPJ da INGA)  mas com os dados já convertidos para uma ENTRADA o DE-PARA será feito pelo SGI.
    • PROC : armazena xml emitidos pela ingá (emitente CNPJ da INGA).
    • ERRO : armazena os xml que não foram importados.
    • BACKUP: armazena os xml importados com sucesso.
  • Os XML serão gerados após recepção ou emissão do sistema de terceiro SGI, ou seja, não estamos importando o arquivo original.
  • Todos os XML's deverão possuir as TAGS complementares. Foi definido junto com a INGA/SGI que os parâmetros das TAGS serão os nossos próprios códigoscadastrados no ApolloLinx DMS. O SGI é responsável para fazer os relacionamentos DE-PARA e caso alguma destas informações seja inexistente a nota não será importada.  
    • USUARIO: CPF , campo numérico , tamanho 11
    • TIPO_TRANSACAO: Tipo de transação para esse processo de importação, campo alfanumérico, tamanho 3
    • DEPARTAMENTO: Aconselhamos criar um departamento exclusivo para grãos,, campo numérico , tamanho 3
    • CONDICAO_PAGAMENTO: Forma de pagamento para realizar os lançamentos financeiros e contábeis;
    • DATA_HORA_NOTA : Acordado com SGI que sempre será a data de emissão de nota
    • BANCO: Banco utilizado para pagamento/recebimento , campo numérico, tamanho 5
    • MARCA: Aconselhamos criar uma marca para GRÃO(s), campo alfanumérico, tamanho 4
    • GRUPO: Aconselhamos criar uma grupo para GRÃO(s), campo numérico, tamanho 3
    • GRUPO_DESCONTO: Aconselhamos criar criar um grupo de desconto para GRÃO(s),campo numérico, tamanho 3
    • CATEGORIA: Aconselhamos criar categoria exclusiva para GRÃO(s) e deve ser igual a CATEGORIA CONTÁBIL, campo numérico, tamanho 3
    • ORIGEM_PAGAMENTO: Criar origens de pagamentos para serem utilizados para as notas de despesas/serviços durante a importação, campo numérico, tamanho 5
    • ATUALIZAR_NOTA: Para alterar informações cadastradas erradas exemplo: CFOP, CST,  campo alfanumérico, tamanho 1 (S/N)

                 Para gravar os impostos do FUNRURAL - RAT , SENAR, INSS

• • • INSS_BASE: campo numérico (14,2)
    • INSS_ALIQUOTA: campo numérico (5,2)
    • INSS_VALOR: campo numérico (14,2)
    • SENAR_BASE: campo numérico (14,2)
    • SENAR_ALIQUOTA: campo numérico (5,2)
    • SENAR_VALOR: campo numérico(14,2)
    • RAT_BASE: campo numérico (14,2)
    • RAT_ALIQUOTA: campo numérico (5,2)
    • RAT_VALOR: campo numérico (14,2)

• • Notas de serviço devem possuir o grupo ISSQN no XML, e obrigatoriamente deve possuir a tag <cServico> com conteúdo;
  • 'Serviço LinxDMS para importação' é executado a cada 1 minuto e pode ser monitorado em (LinxDms - Configuração- Monitoramento de Serviço - IntegraçãoEL)
  • Nota de Exportação/Importação : Necessário preencher a TAG idEstrangeiro (passaporte)que substitui o CNPJ/CFP. Acordado com o SGI que no caso do cliente jurídicos terá um código qualquer determinado por ele mas que será o vinculo do cadastro SGI com o cadastro do LinxDMS.
  • O sistema irá fazer um cadastro simples do CEP e CLIENTE/FORNECEDOR pois não temos muitas informações no XML, por isso imprescindível entrar no cadastro e finalizar com preenchimentos importantes, como categoria, endereço cobrança, aba complemento. Caso não seja feito pode impactar na geração dos livros fiscais, Sped fiscal entre outros informativos.

REFERENTE AO ITEM GRÃO:

• • Não será gerado nenhum relatório específico, mas sugerimos a criação de um departamento GRAOS para ser usado como filtro nas telas de relatórios. (Essa etapa foi realizada pelo setor de implantação).
  • Não será feito o controle de estoque (responsabilidade da INGA) as notas serão importadas como DESCRIÇÃO LIVRE.

  • Não será permitido cancelamento/devolução) diretamente pelo LinxDMS  foi desenvolvido bloqueios internos (tabela FAT_MOVIMENTO_CAPA, campo NF_Integracao_EL). Essa movimentação somente será executada se enviado pelo sistema SGI um xml de cancelamento ou devolução.

  • As notas de grãos emitidas pela INGA só permitirá apenas um único item por nota, pois as tags complementares possui informação por item, ressaltando que a Ingá tem ciência desta regra.

PONTOS IMPORTANTES SOBRE O PROCESSO 

• • Notas de Grãos terá uma numeração e série diferente do LinxDMS. A numeração e série das notas de veículos e peças são controladas pelo sistema ApolloLinx DMS. Para notas de Grãos, o controle da numeração é do sistema SGI (eles emitem a nota, enviam os xmls para pasta de importação e o Linx DMS importa o xml).
  • O cliente INGA usará apenas uma forma de pagamento em notas de grãos emitidas pelo sistema INGA;
    OBS: Não será uma única condição de pagamento para todas as notas. Cada nota poderá ter apenas uma condição de pagamento (código interno do sistema da SGI)
    Exemplo: Código interno da SGI (10), o código 10 é uma venda de três parcelas, 30 dias, 60 e 90 dias. Exemplo 2: Código interno (100), o código 100 é dinheiro à vista;
  • Para Serviços, está fixo para tratar sempre CST como  90;
  • A categoria de peças deve ser igual a categoria contábil.
  • A numeração dos títulos/faturas gravadas no LinxDMS serão o mesmo do XML nas tags <fat>, ou seja, é o próprio número da nota fiscal emitida pelo SGI. Consequentemente é com essa numeração que serão gerados os lançamentos contábeis.
  • Como o LinxDMS é executado pelo IIS do Windows, é necessário que os diretórios definidos para armazenagem estejam com permissão de leitura/escrita ou permissão total do Windows. Além disso, como configuração adicional, inclua os seguintes usuários nos diretórios definidos:

• • Se for um diretório compartilhado em rede, deve ser configurado para ser acessível para todos, e que tenha permissão de leitura/escrita.
    OBS 1: Após atualizar o LinxDMS para conter essas implementações desta documentação, necessário PARAR o IIS do sistema operacional e depois INICIAR o mesmo novamente.
    OBS 2: Dependendo da build ou versão do Windows, alguns desses usuários dos print's acima não existam, ou sejam diferentes.

  DETALHES DO PROCESSO

1.0 PARAMETRIZAÇÕES INICIAIS

1.1 - Para a ativação de integração entre o LinxDMS com o SGI, deverá ser feito via comando SQL pela equipe de implantação ou suporte. 

                                          UPDATE GER_REVENDA SET INTEGRACAO_EL = 'S'
                                           WHERE empresa = XX
                                              AND revenda = XX

1.2 - Acesse o ApolloLinx DMS, e vá até os menus “Configuração > Cadastros > Empresas e Revendas”. Será aberta uma nova janela, então navegue pelos novos menus “NF-e -> Integração INGA”.

2.0 GRAVAÇÃO DA NOTA E TIPOS DE CONSULTAS

• O(s) arquivo(s) que vierem do diretório "EXP", serão de terceiros/fornecedores e NECESSARIAMENTE  precisa ao final do nome o símbolo e algumas das opções abaixo:

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-imp.xml: XML de terceiro/fornecedor

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-imp-can.xml: XML de cancelamento de terceiro/fornecedor

               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-cte.xml: XML de Conhecimento de Transporte Eletrônico (modelo 57)

               IMPORTANTE: O SGI irá receber a nota de saída do fornecedor com CFOP de SAÍDA irá aplicar DE-PARA e irá nos enviar CFOP de ENTRADA.

• O(s) arquivo(s) que vierem do diretório "PROC", entende-se que é uma NF emitida pela empresa e revenda.

 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-nfe.xml : Autorizado

 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-can.xml : Cancelado

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-inut.xml : Inutilizado

 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-den.xml : Denegado

OBS: XXXX... Significa a chave eletrônica do documento fiscal.

• Para definir se o XML será importado como Despesa ou Descrição livre, verificamos no cadastro de TIPO TRANSAÇÃO o campo UTILIZAÇÃO - DESPESA da 
  transação enviada na TAG complementar.

       Caso esteja selecionado DESPESA - importado como despesa , caso contrário será importado como descrição livre, independente das opções marcadas.

• A gravação da NF-e no sistema ficará com “Status = F”.

2.1 Fluxo serviço:  executa a leitura a cada 1 minuto percorrendo pelas pastas parametrizadas e XML por XML , atualmente não é possível configurar esse período.

• Identifica o tipo da nota validando o CNPJ das TAGS emitente e destinatário
• Valida as TAGS complementares
• Cadastramento da pessoa (cep e cliente): Os campos que não existirem nos XML's ou não forem possíveis de se tomar decisão, assumiremos valor um default.
• Valida os dados da CAPA e ITEM se não encontrar erros GRAVA A NOTA.
• Gera o Financeiro e Contábil: Nesse momento a nota esta gravada e a geração é automática.
• Se apresentar erro é movido para o diretório parametrizado para ERRO caso contrário irá para pasta de “BACKUP” 

Atenção

Uma vez ajustado o erro apresentado para determinado XML, atualmente o usuário deverá mover manualmente o XML do diretório de ERRO para um dos diretórios "EXP", "PROC".

2.2 Consulta notas importadas: Faturamento -> Consultas / Relatórios -> Notas Importadas Com Erro INGA 

• A nota pode ser importada com sucesso e apresentar erro na geração do Contábil e Financeiro, desta forma irá constar duas vezes na listagem, exemplo destacado em verde na imagem.
• Validamos se os valores de todas as TAGS existem cadastrados no sistema, gravando uma mensagem para ajudar.

           Exemplos: 'Departamento não cadastrado', 'Transação não cadastrada', 'Usuário não cadastrado' .

• Clicando duas vezes na linha irá abrir outra tela mostrando a descrição do erro de forma detalhada.
• 

2.3 O Serviço pode apresentar falhas na leitura dos arquivos. Exemplo:  arquivo xml faltando TAG ou não encontrou a pasta parametrizada em empresa/revenda-NFe-Inga. Sempre que possível monitore acessando no LinxDMS “Configuração -> MONITORAMENTO SERVICOS” 

2.4 Após importação são usados os mesmos recursos das notas de veículos e peças.

• Faturamento - Notas Fiscais - Manutenção : Para visão geral dos dados da nota
• Faturamento - Consultas - Operações Fiscais : para financeiro e contábil
• Faturamento → Consultas / Relatórios → Notas Fiscais : Relatório lista de notas, caso tenha cadastrado categoria especifica pode ser usada como filtro.

2.5 Importação de nota de CANCELAMENTO

- Sistema valida se a chave de acesso de referência do XML consta no sistema (tabela fat_movimento_capa).

- A nota de referência precisa estar com status fechado, situação A , cancelar = C e não ter protocolo de cancelamento (para evitar cancelamento da mesma nota duas vezes)

- Antes de cancelar verifica se o titulo esta pago totalmente ou parcialmente, se tem devolução e se pela data contábil o livro foi emitido.

- Chave referenciada fica dentro do retEvento, como destacado abaixo pois a primeira TAG 'chNFe' é do próprio cancelamento.

2.0 Integração Financeiro e Contábil automática

Para saber se as notas foram contabilizadas, acesse o menu “Faturamento → Consultas / Relatórios → Operações Fiscais” e filtre pelas notas.
OBS 1: O financeiro e o contábil serão executados automaticamente na importação da nota.
OBS 2: Caso haja algum erro na contabilização, o usuário poderá manualmente gerar os lançamentos financeiros e contábeis, caso queira pelo menu citado acima.

4.0 - Instrução sobre emissão de notas de grãos, cancelamento, devolução e geração do SPED pelo LinxDMS/Apollo.

Adicionadas travas para Cancelar, Devolver notas que a origem foi do parceiro SGI .

• • Cancelamento 

Menu: "Faturamento - Consulta> Relatórios > Operações" fiscais se selecionar uma nota de GRÃOS (FAT_MOVIMENTO_CAPA campo NF_INTEGRACAO_EL = S) o sistema não permite continuar e informa que deve ser cancelada pelo parceiro EL.

• • Devolução 

Em "Faturamento - Nota Fiscal - Nota Fiscal Descrição livre". Quando informado uma transação de devolução habilita uma aba NF Complementar, caso seja informado uma nota fiscal de grãos (FAT_MOVIMENTO_CAPA campo NF_INTEGRACAO_EL = S) e clicar em procurar o sistema irá apresentar a mensagem "Nota de Grãos: Devolução deve ser feita pelo parceiro INGA" e após OK irá limpar os campos e o foco voltará para o campo Número.

Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o suporte Automotivo de POA (LinxDMS).