Restrições:

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)
;
• Não será feito o controle de estoque para grãos no LinxDMS (responsabilidade da INGA);
• Não serão emitidas notas ou documentos/eventos pelo LinxDMS, que sejam vinculadas as notas de grão pelo LinxDMS;
• As notas de grãos só serão emitidas no sistema da INGA;
As notas de modelos
• • .
  • Modelos 57, 96, A1, 01, 1A, recibos, faturas e outros documentos sem modelos, mas todos
vínculados
• • vinculados ao processo de grãos, todos deverão ser gerado um XML pela SGI no modelo 55 (NF-e)
e 57 (CT-e) da SEFAZ;
• O cancelamento/inutilização de notas emitidas pela INGA será realizado somente no próprio sistema da INGA (para mais detalhes, vá até o item 3.0 desta página).
• As notas de grãos emitidas pela INGA só permitirá apenas um único item por nota;
• Todos os XML's deverão possuir as tags complementares, passando dados como condição de pagamento, usuário (CPF), tipo transação e entre outras (serão citadas mais abaixo), para que possamos importamos as notas nossa base de dados (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;
• Notas de serviço devem possuir o grupo ISSQN no XML, e obrigatoriamente deve possuir a tag <cServico> com conteúdo;
• Para Serviços, está fixo para tratar sempre CST como  90;

Premissas:

• • O serviços de importação de notas é executado a cada 1 minuto no ambiente do cliente (não é possível de se alterar isso no momento);
  • Após inutilizar/cancelar uma NF no sistema do SGI, será disponibilizarão um novo XML para que possamos atualizarmos o produto LinxDMS (importaremos esses XML's);
  • 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);
  • O registro M do SPED Contribuições será preenchido automaticamente pelo LinxDMS (ainda será desenvolvido);
  • O registro 1100 e 1005 do SPED Fiscal será preenchido automaticamente pelo LinxDMS (ainda será desenvolvido);
  • Deve ser criado no LinxDMS um departamento como GRAO, para facilitar consulta de notas (opcional esse item);
  • Deve ser criar uma categoria específica para os itens do tipo cereais, para fácil identificação no sistema (opcional esse item);
  • Criar um diretório no "C:\" do servidor da INGA chamado "INGA".
    • Dentro de "INGA" criar os subdiretórios: SPED, EXP, PROC, ERRO e BACKUP;
    • O diretório raiz e os subdiretórios, todos devem possuir permissão de leitura/escrita.
      OBS: As premissas dos diretórios são sugestivas, qualquer diretório definido e com permissão, será acessível pelo serviço e pelo SGI.

Pré-requisitos:

• • Como o LinxDMS é executado pelo IIS do Windows, é necessário que os diretórios definidos no item "1.2" 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:
    Image RemovedImage Removed
  • 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.

1.0 - Parametrização

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. Favor, registrar atendimento junto aos mesmos.

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”.

Image Removed

1. Preencha todos os campos de diretórios (obrigatório). Os diretórios devem existir fisicamente;
2. 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".

Image Removed

1.3 Este item é fundamental para o processo, pois sem ele estar parametrizado, todo o fluxo de importação de nota não ocorrerá. A implantação deverá mapear as seguintes informações que o cliente utilizará para notas de grãos no LinxDMS, são elas:

• Departamento (se for o caso, criar um departamento exclusivo para grãos);
• Condição de pagamento: Forma de pagamento do LinxDMS para realizar os lançamentos financeiros e contábeis;
• Banco: banco utilizado para pagamento/recebimento no processo financeiro do LinxDMS;
• Marca: Criar uma marca genérica ou GRÃO(s) ou OUTROS, para ser utilizado especificamente nesse processo de importação de XML's do SGI;
• Grupo: Criar uma grupo genérico como GRÃO(s) ou OUTROS, para ser utilizado especificamente nesse processo de importação de XML's do SGI;
• Grupo de Desconto: Criar um grupo de desconto específico para esse processo, ou usar grupos existentes (fica a critério da definição da implantação com o cliente);
• Categoria: (se for o caso, criar uma categoria exclusiva para grãos);
• Tipo Transação: Selecionar/Criar um tipo de transação para esse processo de importação de XML's do SGI.
• Origem Pagamento: Criar origens de pagamentos para serem utilizados para as notas de despesas/serviços durante a importação;

Uma vez mapeados e parametrizados, essas informações devem ser enviados no XML pelo sistema do SGI, para que assim as notas possam ser importadas dentro do LinxDMS.

O conteúdo das tags complementares devem obedecer a capacidade total dos campos de cada criado e parametrizado, por exemplo, no cadastro de DEPARTAMENTO, o mesmo é um campo número de até 3 dígitos. Então a tag complementar de departamento deve obedecer esse tipo.
OBS: Foi definido junto com a INGA/SGI que os parâmetros de tags complementares serão os nossos próprios códigos cadastrados no Apollo/LinxDMS nas telas de manutenções.

As tags complementares, se alguma não estiver preenchida, o serviço não irá importar o XML e irá gravar mensagem de erro na tela de logs em “Faturamento -> Consultas / Relatórios -> Notas Importadas Com Erro INGA”:
OBS: Não são todos os erros que serão apresentados nessa tela, então é necessário que acesse o menu “Configuração -> MONITORAMENTO SERVICOS” para visualizar outros motivos de erros.

Uma vez atendido todos os passos acima, o serviço então funcionará de forma automática, entrando nos diretórios, carregando os arquivos XML’s, fazendo a consistências se os dados necessários foram preenchidos. Se sim, começa o cadastramento da pessoa (cep e cliente), grava a nota, grava o item e grava o XML para depois movê-los para o diretório de “BACKUP”. 

Se houver algum erro, os XML's sempre serão movidos para o diretório de “ERRO”. Então deverá acessar primeiro, sempre o log do menu “Faturamento -> Consultas / Relatórios -> Notas Importadas Com Erro INGA”. Se não tiver o erro ou o erro não estiver atualizado, consulte o log do menu “Configuração -> MONITORAMENTO SERVICOS”. Essa é a ordem.

Para saber se as notas foram importadas com sucesso, acesse o menu “Faturamento → Consultas / Relatórios → Notas Fiscais” e filtre pela numeração da NF-e.

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.

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.

3.0 - Consumo dos arquivos xml's do SGI

O processo é automático, basta seguir as parametrizações acima, que todo o resto do consumo dos XML's gerados pela INGA será automático. Mas será explicado mais abaixo o fluxo do processo. Uma vez definido o diretório, e parametrizado devidamente a integração com a INGA, o serviço avaliará o conteúdo do XML e fará as seguintes ações:

• • O(s) arquivo(s) que vierem do diretório "EXP", serão considerados XML's de terceiros/fornecedores, ou seja, o EMITENTE da NF é um fornecedor. Então o serviço pegará o emitente da NF e verificará se o mesmo existe na base de dados. Se não, cadastrará o CEP no sistema e no menu de cadastro de clientes, preenchendo os campos que são obrigatórios e que estejam no XML ou que sejam passíveis de tomar decisão baseadas em outras tag's, como por exemplo, IE (inscrição estadual). Se a mesma estiver com conteúdo, entende-se que é um contribuinte e podemos informar na tabela;
  • Os campos que não existirem nos XML's ou não forem possíveis de se tomar decisão, assumiremos valor um default para que seja possível cadastrar o cliente ou solicitaremos informações complementares para a EL nos enviar no XML.
  • O(s) arquivo(s) que vierem do diretório "PROC", entende-se que é uma NF emitida pela empresa e revenda. Os passos serão exatamente do citado acima, porém sempre considerando os parâmetros como cliente.
  • A primeiro momento os itens das NF's serão considerados como DESCRIÇÃO LIVRE no Apollo, e NÃO movimentara estoque no LinxDMS. A INGA/SGI ficará por conta do controle de estoque. Isso foi acordo entre os mesmos em reuniões de definição deste projeto.
  • 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.
  • Ao final do cadastramento do cliente/fornecedor e do item, o serviço irá realizar a gravação da NF-e no sistema como FATURADAS.
    OBS 1: As informações complementares que serão disponibilizados pela INGA, faremos uma busca no nosso banco de dados para carregar as informações "DE-PARA", onde confrontaremos do que veio no XML com os dados próprios do LinxDMS. Assim conseguiremos concluir a gravação dos itens, clientes/fornecedores e a nota no sistema. Por isso o item "1.3" é fundamental.
    OBS 2: Caso a importação de uma NF tenha algum problema, o usuário poderá consultar pela NF e ver o motivo da mesma não ter sido importada, por exemplo, o CFO informado não existe na base de dados do LinxDMS. O XML será movido para uma pasta de "ERRO", conforme parametrizado no item "1.2".
    OBS 3: A integração contábil e financeira serão realizadas após gravação da NF de forma automática.
  • Ao término da gravação dos XML's, o serviço irá mover os XML's para um diretório denominado "backup" parametrizado no LinxDMS, conforme parametrizado no item "1.2".

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" ou "SPED", conforme explicado mais abaixo.

A INGA criará um diretório raiz em uma máquina server (definida entre a própria INGA e a SGI). Uma vez definido esse diretório raiz a estrutura será da seguinte forma:

• Recebidas → Notas importadas e exportadas pelo sistema INGA, que são os documentos XML's de terceiros (normal e alterado). Seguem as nomenclaturas dos arquivos definidos pela INGA:

Exportado (alterado): XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-imp.xml (esse xml é o arquivo gerado pela EL após importar o arquivo original em seu sistema, mas com os dados alterados, por exemplo, CFOP).

Exportado (CTe - alterado): XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-cte.xml (esse XML não será o original do fornecedor da INGA, e sim, ele modificado pela INGA e enviado posteriormente para a Linx importá-lo dentro do LinxDMS).

Exportado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-imp-can.xml (xml de cancelamento da nota de terceiro);

• Emitidas → Notas emitidas pelo sistema EL, que são os documentos XML da própria nota emitida e autorizada, além dos eventos vinculados a NF, como inutilização, denegação e cancelamento. Seguem as nomenclaturas dos arquivos definidos pela EL:

Autorizado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-nfe.xml

Cancelado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-can.xml

Inutilizado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-inut.xml

Denegado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-den.xml

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

Os arquivos XML que ficarão dentro dos diretórios parametrizados, eles precisam ter os seguintes finais:

-nfe.xml: Ficará sempre no diretório “EXP” (não será importado, apenas movido para o diretório de BACKUP);

-imp.xml: Ficará sempre no diretório “EXP” (XML de terceiro/fornecedor. Será importado);

-imp-can.xml: Ficará no diretório “EXP” (XML de cancelamento de terceiro/fornecedor);

-den.xml: Ficará sempre no diretório “PROC” (XML denegado, será importado);

-inut.xml: Ficará sempre no diretório “PROC” (XML de inutilização, será importado);

-sped.xml: Ficará sempre no diretório “SPED” (XML de exportação do SPED, será importado);

-can.xml: Ficará sempre no diretório “PROC” (XML de cancelamento de notas emitidas pela próprio empresa e revenda);

-cte.xml: Ficará sempre no diretório “EXP” (XML de Conhecimento de Transporte Eletrônico (modelo 57));

OBS: Os XML’s só serão gerados pelo SGI nos diretórios do item “3º”, mas apenas se existirem e se tiverem a devida permissão de leitura/escrita no servidor.

Image Removed

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.

• • 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.

Image Removed

• • 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.

Image Removed

• • Emissão de nota 

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

• SPED (registros 1100 e 1105)

5.0 - tela de visualização de erros ao importar NF-e.

Para visualizar as notas que tiverem erro durante a importação, basta acessar os menus do LinxDMSPrincipal (LinxDMS Web): "Faturamento → Consultas / Relatórios → Notas Importadas com erro INGA".

Image RemovedImage Removed

• • ; 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 importação' é executado a cada 1 minuto e pode ser monitorado em (LinxDms - Configuração- Monitoramento de Serviço - IntegraçãoEL)

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:
    Image AddedImage Added

• • 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 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 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”.

Image Added

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.
• Image Added

2.3 O Serviço pode apresentar falhas na leitura dos arquivos, sempre que possível monitore acessando no LinxDMS “Configuração -> MONITORAMENTO SERVICOS” 

Image Added

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

Image Added

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 e a Emissão de nota usando o departamento/transação cadastrado para 'Grãos' assim não impacta o estoque da INGA.

• • 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.

Image Added

• • 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.

Image Added

• • Emissão de nota 

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 Added