Este módulo mostrará como funcionará o fluxo de integração do LinxDMS x EL Sistemas para o grupo de clientes INGA.

Este documento tem a finalidade de apresentar a ativação da integração entre o produto LinxDMS x EL Sistemas.

Destina-se aos clientes do produto LinxDMS que pertencem ao grupo INGA.

Restrições:

• • Não será gerado nenhum relatório para grãos (ficará por conta da EL);
  • Não será feito o controle de estoque para grãos (responsabilidade da EL);
  • Não serão emitidas notas ou documentos/eventos que sejam vinculadas as notas de grão pelo LinxDMS;
  • As notas de grãos só serão emitidas no sistema da EL; e
  • O cancelamento / inutilização de notas emitidas pela EL será realizado somente no próprio sistema da EL. A EL disponibilizará um novo XML da NF-e cancelada/inutilizada, assim o serviço consumirá o mesmo e irá gravar/atualizar as notas no LinDMS.

Premissas:

• • O serviços é executado a cada 5 minutos;

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:
    
  • Se for um diretório compartilhado em rede, deve ser configurados para ser acessível para todos, e que tenha permissão de leitura e escrita.
    
    OBS 1: O IIS não é de responsabilidade da Linx, ele é desenvolvido e mantida 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 PARA o IIS do seu sistema operacional (Windows), e depois INICIAR o mesmo novamente.

1.0 - Parametrização

1.1 - Para a ativação de integração entre o LinxDMS com a EL Sistemas, 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 EL”.

2.0 - Consumo dos arquivos xml's da el sistemas

O processo é automático, basta seguir as parametrizações acima, que todo o resto do consumo dos XML's gerados pela EL Sistemas 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 EL 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, 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. 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 tomar decisão, assumiremos valor 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.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, mas terão suas informações gravadas no menu de itens de estoque e de revenda.
  • 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 EL, 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 nota no sistema. Esse de para vêm da tela do item "1.3".
    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".

A EL Sistemas criará um diretório raiz em uma máquina server (definida pela Linx em conjunto com o cliente do grupo INGA). Uma vez definido esse diretório raiz a estrutura será da seguinte forma:

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

Importado: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-nfe.xml (esse xml é o arquivo original emitido pelo fornecedor. A EL irá disponibilizar para nós, mas não iremos importá-los).

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

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

• Para saber se o serviço está ativo, acesse o LinxDMSPrincipal (LinxDMS WEB), navegue pelo menu "Configuração → MONITORAMENTO SERVIÇOS", e veja se o serviço constará como ativo, conforme a imagem abaixo:
  

3.0 - tela de visualização de erros ao importar nf.

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 EL Sistemas".

Ao visualizar o motivo do erro, deve-se realizar o ajuste no Apollo/LinxDMS, depois mover o arquivo do erro que está no diretório de "erro" para o diretório de origem do mesmo (PROC ou EXP). Depois aguarde o serviço consumir o arquivo XML novamente.

4.0 - retornar próximo numerador de documento fiscal a ser emitido pela el sistemas

A EL Sistemas irá chamar um endpoint que será hospedado pelo lado do LinxDMS do ambiente do cliente. Esse endpoint permitirá que a EL o consuma através de uma requisição HTTP (método GET), passando três parâmetros na URL do endpoint (CNPJ, SÉRIE e MODELO). O objetivo é retornar o próximo número do documento fiscal a ser emitido pela empresa EL Sistemas para notas de grãos.

Neste ponto o cliente (usuário do LinxDMS / Apollo) não precisará realizar nenhuma operação. Esse é um processo que será executado de forma automática também, quando a EL Sistemas acionar o endpoint. Uma vez disponibilizado o numero do documento, esse mesmo número não será utilizado mais pelo LinxDMS, pois entende-se que a EL já fará uso do mesmo.

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