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. 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).
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 (layout 3.10) 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 importada
- 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ódigos cadastrados no Apollo. 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 enviar 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 de 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.
REFERENTE AO ITEM GRÃO: - Não será gerado nenhum relatório especifico, mas sugerimos a criação de um departamento GRAOS para ser usado como filtro.
- Não será feito o controle de estoque (responsabilidade da INGA) as notas serão importadas como DESCRIÇÃO LIVRE.
- Não serão emitidas notas (entrada/saída) ou documentos/eventos(cancelamento/inutilização/carta de correção) diretamente pelo LinxDMS foi desenvolvido bloqueios, essa movimentação exclusiva por IMPORTAÇÃO, ou seja, o sistema SGI após inutilizar/cancelar uma NF disponibilizara um novo XML para que possamos atualizarmos o produto LinxDMS
- 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.
PONTOS IMPORTANTES SOBRE O PROCESSO - Notas de Grãos terá uma numeração diferente do LinxDMS.
- O cliente INGA usará apenas uma forma de pagamento em notas de grãos emitidas pela 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.
- Na contabilização das notas importadas do SGI, os títulos/faturas no LinxDMS serão o mesmo do XML nas tags <fat>, ou seja, é o próprio numero da nota fiscal emitida pelo SGI;
- As notas emitidas pelo próprio LinxDMS (peças/veículos/serviços) existem parâmetros no LinxDMS para que a fatura também seja o próprio número da NF (isso deve ser definido junto a equipe de implantação);
- 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:
![](/download/attachments/275660566/Permissao1.png?version=2&modificationDate=1644337247674&api=v2) ![](/download/attachments/275660566/Permissao2.png?version=2&modificationDate=1644337247702&api=v2)
- 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: O IIS não é de responsabilidade da Linx, ele é desenvolvido e mantido pela Microsoft, e sua instalação/configuração é de responsabilidade da T.I da empresa do cliente. OBS 2: Após atualizar o LinxDMS para conter essas implementações desta documentação, aconselhamos PARAR o IIS do sistema operacional e depois INICIAR o mesmo novamente. OBS 3: Dependendo da build ou versão do Windows, alguns desses usuários dos print's acima não existam, ou sejam diferentes.
DETALHES DO PROCESSO1.0 PARAMETRIZAÇÕES INICIAIS1.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 Apollo, 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”. ![](/download/attachments/275660566/image-2023-12-6_13-58-23.png?version=2&modificationDate=1701974053175&api=v2)
- Preencha todos os campos de diretórios (obrigatório). Os diretórios devem existir fisicamente e com permissão como citado acina.
- Informe o formulário para a NF-e de grãos (obrigatório);
OBS: Esse formulário pode ser o mesmo para peças, veículos ou qualquer outro formulário do sistema. Os dados dos formulários devem existir previamente em "Configuração → Cadastros → Layout e Formulários". 3.E-mail como destinatário para receber informações de erro no serviço 'IntegracaoEl', para funcionar é necessário preencher as informações de e-mail da aba 'Agenda de processos' como emitente. 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 simbolo
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 SAIDA irá aplicar DE-PARA e nos enviara 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 como FATURADAS
2.1 Fluxo serviço: executa a leitura a cada 1 minuto percorrendo pelas pastas parametrizadas e XML por XML: - 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 - Na versão 2 passamos mostrar as notas gravadas com sucesso. - 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 todas as TAGS se os valores existem cadastrado no sistema, gravando uma mensagem para ajudar e nesse momento não temos informação de contador e transação.
- Clicando duas vezes na linha irá abrir outra tela mostrando a descrição do erro de forma detalhada.
![](/download/attachments/275660566/image-2023-12-6_16-4-34.png?version=2&modificationDate=1701974053096&api=v2)
2.3 O Serviço pode apresentar falhas na leitura dos arquivos, sempre que possível monitore acessando no LinxDMS “Configuração -> MONITORAMENTO SERVICOS” ![](/download/attachments/275660566/image-2023-12-6_15-27-5.png?version=2&modificationDate=1701974053136&api=v2)
2.4 Após importação é usado os mesmos recursos que notas de veículos/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 Observações sobre o fluxo para colocar no manualmente - Sistema valida se a chave de acesso de referencia 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 protoco 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 contabil o livro foi emitido. - Chave referenciada fica dentro do retEvento, no inicio é a chave de acesso do envio do cancelamento ![](/download/attachments/275660566/image-2023-12-7_14-7-16.png?version=2&modificationDate=1701974053039&api=v2)
2.0 Integração Financeiro e Contábil automáticaPara 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.
Não existirá grandes variações dos XML’s, por exemplo, como pré-requisito as notas de grãos emitidas no sistema da INGA só permitirão um único item por nota e haverá uma única condição de pagamento por nota. As notas são COMPRA, VENDA, REMESSA, REMESSA SIMBÓLICA, RETORNO REMESSA, SAÍDA ALFANDEGADA e VENDA EXPORTAÇÃO (esses foram os exemplos enviados pela própria INGA). Existem outros XML's de documentos internos do sistema do SGI, como o modelo 96 (serviço), 01 e A1 ou 1A, que são recibos/fatura e outros tipos de documentos, são todos documentos registrados manualmente dentro do sistema do SGI, e que serão gerados arquivos XML no modelo 55 de NF-e da SEFAZ Existe também o Conhecimento de Transporte, que este será um XML gerado pelo SGI seguindo o padrão do XSD da SEFAZ para CT-e (modelo 57). ATENÇÃO:As notas importadas não devem ser canceladas pelo LinxDMS (a ideia é que o usuário da INGA cancele pelo sistema da INGA). A partir do cancelamento do sistema da INGA, será disponibilizado um novo XML para ajustar o status da nota no LinxDMS e com os dados do estoque atualizados.
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 e a Emissão de nota usando o departamento/transação cadastrado para 'Grãos' assim não impacta o estoque da INGA. 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. ![](/download/attachments/275660566/cancelamento.png?version=1&modificationDate=1648578559451&api=v2)
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. ![](/download/attachments/275660566/devolucao.png?version=1&modificationDate=1648578559414&api=v2)
Em "Faturamento - Nota Fiscal - Nota Fiscal Descrição livre". Ao passar pelo campo departamento o sistema irá verificar se o departamento e a transação foram parametrizados para GRÃOS em 'LinxDms > Configuração > Cadastro > Parâmetro de Integração INGA' e não permite continuar. ![](/download/attachments/275660566/emissao.png?version=1&modificationDate=1648578559356&api=v2)
|