Este módulo mostrará como funcionará o fluxo de integração do LinxDMS x EL Sistemas para o grupo de clientes INGA.
Produto | LinxDMS |
|---|---|
Menu | Configurações → Cadastros → Empresas e Revendas |
Data | |
Autor | Brian Alves Pereira |
Área | P&D |
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.
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.
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”.
- Preencha todos os campos de diretórios (obrigatório);
- 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 na tabela GER_FORMULARIO_CAPA.
1.3 Deverá mapear os tipos de transações que o cliente utilizará para notas de grãos no LinxDMS, departamento de grãos, condição de pagamento para as notas de grãos, banco, usuário que ficaram por conta desse processo, marca, grupo, categoria (categoria do item) e o grupo de desconto. Uma vez mapeados, devem ser inseridos através da tela "Configuração → Cadastros → Parâmetros de Integração EL Sistemas".
OBS: No momento a tela não foi desenvolvida. Assim que concluída, a documentação será atualizada.
Essa tabela é muito importante estar parametrizada, pois os XML’s só serão importados automaticamente pelo LinxDMS (sem intervenção nenhuma do usuário) se existirem valores cadastros na mesma. Do contrário os XML’s não serão consumidos, pois não saberá qual departamento, banco, marca, usuário e entre outras informações que ele precisa, para alimentar as tabelas de notas e de itens.
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.
- O(s) arquivo(s) que vierem do diretório "PROC", entende-se que é um cliente. Os passos serão exatamente do item 1 e 2, porém sempre considerando os parâmetros como cliente, mas as tabelas são exatamente as mesmas.
- 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.
OBS 2: Caso a importação de uma NF tenha algum problema, o usuário poderá consultar por NF e ver o motivo da mesma não ter sido importada, por exemplo, o CFOP 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. - Ao término da gravação dos XML's nas tabelas de movimentação de notas, o serviço (CSharp) irá mover os XML's para um diretório denominado "backup" parametrizado no LinxDMS, conforme parametrizado no item "1.2".
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: "Faturamento → Consultas / Relatórios → Consulta de Notas Importadas com erro EL Sistemas".
OBS: A tela ainda está em desenvolvimento. Assim que concluída, será atualizada essa documentação com a imagem da mesma.
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.
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;
- 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;
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o suporte Automotivo de POA (LinxDMS).