Requisitos

Parametrizações

Sistema Almode – sistema de PDV

1. Acesse o Almode com os dados de login;
2. Cadastro usuário - link API? Não tem faqs relacionados?Realize os cadastros relacionados à produtos, vendas e estoques. Série fiscal aonde fica?acesso liberação para produto, estoque e vendas. Série fiscal por PDV - parte de vendas.

Sistema Consistem ERP

1. Acesse o programa Integração (CSINTEGRACAO010) e no grid selecione a Integração API Almode;
   
   
   
   
2. Acione o Editar para executar o Cadastro de Integração (CSINTEGRACAO010A) permitindo realizar a parametrização e ativação da integração.
   
   
   
   
3. Na Aba Dados Gerais (CSINTEGRACAO010ATAB1) inicia-se a configuração e habilita-se a integração.
   Importante: se atentar ao campo Situação, pois se permanecer como Inativo não irá funcionar a integração.
   
   1. No botão Específico é exibido o programa Configuração Integração Almode (CCPV111) para configuração geral da integração.
      
      
      
      Importante: o preenchimento dos campos Portador e Tipo de Cobrança se referem aos cadastros padrões para quando for feita a importação das vendas no Almode. Essa importação é uma nota fiscal gerada no Consistem ERP e os títulos são gerados com esses portadores e tipo de cobrança, para os casos que não tenha sido especificado algum portador ou tipo de cobrança específicos para um tipo de venda. 
      Importante: o preenchimento do campo Ramo de Atividade serve para quando houver um novo cliente com identificação de CPF ou CNPJ no Consistem ERP para gerar um cadastro automático de acordo com o preenchimento deste campo.
      
      1. No botão Série Fiscal é executado o programa Configuração por Série Fiscal Integração Almode (CCPV111B) para realizar a configuração por série fiscal para a integração com Almode.
         Importante: essa série fiscal é disponibilizada pelo Almode, sendo necessário realizar esse cadastro aqui no Consistem ERP.
         
         
          
      2. No botão Tipo Venda é exibido o programa Configuração por Tipo de Venda Integração Almode (CCPV111A) permitindo realizar a configuração por tipo de venda para a integração com Almode. O cadastro ocorre no programa Cadastro de Tipo de Venda Almode (CCPV112).
         Importante: não é obrigatório o preenchimento desse programa Configuração por Tipo de Venda Integração Almode (CCPV111A), pois os campos Portador e Tipo de Cobrança já se encontram preenchidos como cadastros padrões no programa anterior. Este programa deverá ser preenchido caso a empresa queira ter salvo um outro portador e tipo de cobrança para casos específicos.
         
         
         TIPO DE BAIXA - se for pago no crédito (tipo de venda) - baixa automático com o código configurado aqui.
         
         

4. Retornando para o programa Cadastro de Integração (CSINTEGRACAO010A) temos a Aba Endpoints (CSINTEGRACAO010ATAB2) que estão disponíveis os endpoints vinculados à integração do Almode. Aqui é possível habilitar e desabilitar os endpoints da integração conforme necessidade e, ainda, verificar e detalhar os possíveis erros caso hajam. Lembrando que a integração de envio ou importação irá ocorrer entre os sistemas caso estejam ativados.
   O endpoint de contatos não é utilizada pois a Bling não monitora os clientes cadastrados no marketplace e que ainda não realizaram nenhum pedido. Quando o cliente realizar o pedido, automaticamente, o cadastro do mesmo será importado para o Bling e consequentemente para o Consistem.Produto envia do Consistem para Almode. E Vendas é do Almode para Consistem. Consistem envia o cadastro dos produtos e atualização e o Almode gera um ticket. 
   
   

   Método	Endpoint	Descrição	Rotina/Classe	Fluxo de integração
   GET	/api/public/clientes	Importar Cliente Almode	CCPVRG021C	Indisponível?	Almode > Consistem
   GET	/api/public/produtos	Consultar Produto AlmodeCCPVRG021A	Almode > Consistem
   GET	/api/public/recebiveis	Recebíveis Venda AlmodeCCPVRG021C	Almode > Consistem
   GET	/api/public/tickets	Processar Ticket Almode	CCPVRG021BAlmode > Consistem
   GET	/api/public/vendas	Importar Notas Fiscais Período Almode	CCPVRG021CAlmode > Consistem
   GET	/api/public/vendas	Importar Nota Fiscal Almode	CCPVRG021CAlmode > Consistem
   PATCH	/api/public/depositos/{operacao}	Atualizar Estoque Almode	CCESARG006Consistem > Almode
   POST	/api/public/produtos	Criar Produto Almode	CCPVRG021AConsistem > Almode
   POST	api/public/produtos/{codProduto}/variantes	Adicionar Variantes Produto Almode	CCPVRG021AConsistem > Almode
   PUT	/api/public/produtos	Atualizar Produto Almode	CCPVRG021AConsistem > Almode

5. Já a Aba Integração Manual (CSINTEGRACAO010ATAB3) poderá ser utilizada caso o usuário queira realizar a geração de uma requisição manual para integração com o sistema terceiro, ou até mesmo para correção de um possível erro. Existem dados predeterminados facilitando a seleção.
   
   
   
   
6. Agora sim, na Aba Carga Dados (CSINTEGRACAO010ATAB4) é possível a geração de carga de dados inicial para todo o sistema integrado, agilizando assim o processo de integração com o Almode.
   Enviar Produtos da Tabela de Preço - Código Empresa e Tabela Preço - Confirma - Coluna Status vai ficar atualizando. Gerando tickets 611 - verificar CCPV611 e corrigir erros-inconsistências - reenvia para correção.
   Taks Enviar Produtos
   TESTE - Venda pelo Almode, importa na integração (manual ou automática).
   Nota Fiscal entra no Consistem - validar o Sped das notas. 
   Cancela nota no Almode e importa no Consistem.
   
   
   
   
7. Retorne ao programa Integração (CSINTEGRACAO010) e no grid selecione a Integração API Almode;
   1. Clique em Ações e Log de Integração para executar o programa Consulta Logs de Integração (CSINTEGRACAO100) para identificar e detalhar as requisições com ou sem erros e reexecutar as requisições.
   2. Acesse o programa CCPV611 (sem documentação, acesso somente pelo sms?menu) ainda não foram processados ou que ocorreram algum erro.
      1. 2 Taks Sincronização de dados e importação de vendas. Já vem criadas? Criar 2 agendamentos para cada task (Aba tab2) citada. Clique em Ações e Agendamentos de Tarefas para executar o programa Agendamento de Tarefas (CSTASK015);
   3. Cadastre um novo agendamento para a integração com o Almode tanto para consumir importar ou enviar dados.
8. Pronto, configuração realizada com sucesso!

Fluxo do processo