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 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). ESTRUTURA DO XML - DIRETÓRIOS - SERVIÇO: Os XMLs gerados pela INGA, será no 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 (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 importadaimportados.
- 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 enviar 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.
REFERENTE AO - 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 especifico 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ão emitidas notas (entrada/saída) ou documentos/eventos(cancelamento/inutilização/carta de correçãoserá permitido cancelamento/devolução) diretamente pelo LinxDMS foi 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 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. 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 A numeração e série das notas de veículos e peças são controladas pelo sistema Linx 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.
- Na contabilização das notas importadas do SGI, os A numeração dos títulos/faturas gravadas no LinxDMS serão o mesmo do XML nas tags <fat>, ou seja, é o próprio numero número 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 . 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: 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 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 32: 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 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”. ![](/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 acinaacima.
- 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.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 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 SAIDA SAÍDA irá aplicar DE-PARA e irá nos enviara 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
Caso esteja selecionado DESPESA - importado como despesa , caso contrário será importado como descrição livre, independente das independente das opções marcadas.
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 - Na versão 2 passamos mostrar as notas gravadas com sucesso.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 se os valores existem cadastradocadastrados no sistema, gravando uma mensagem para ajudar e nesse momento não temos informação de contador e transação..
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.
![](/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 . 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” ![](/download/attachments/275660566/image-2023-12-6_15-27-5.png?version=2&modificationDate=1701974053136&api=v2)
2.4 Após importação é usado são usados os mesmos recursos que 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 Observações sobre o fluxo para colocar no manualmente - Sistema valida se a chave de acesso de referencia 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 protoco 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 contabil contábil o livro foi emitido. - Chave referenciada fica dentro do retEvento, no inicio é a chave de acesso do envio do cancelamento Image Removedcomo destacado abaixo pois a primeira TAG 'chNFe' é do próprio cancelamento. Image Added
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 . 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. Image Removed Image Added
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. Image Removed
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. Image Removed Image Added
|