Omie é um ERP (Enterprise Resource Planning), que integramos com o nosso CRM da Ploomes por meio de uma integração Plug-and-Play. Por meio dessa integração é possivel unir os dois sistemas através das entidades: Cliente, Produto, Venda, Produto da Venda, Serviço e Ordem de Serviço, e também os usuários no ploomes que são os vendedores no Omie.
Após a criação do seu aplicativo Omie, acesse a seguinte URL: https://developer.omie.com.br/my-apps/ e entre com seu login e senha
Na tela inicial estão as informações necessárias para realizar a integração. Vamos utilizar o App Key e App Secret para dar continuidade pelo Ploomes.
Após copiar as informações, basta acessar o Ploomes e navegar para a tela de Integrações Plug & Play pela opção Administração no menu lateral.
Basta clicar na integração do Omie na lista e habilitar a integração.
Clique em “Autorizar integração”, isso abrira uma nova guia do navegador, nela você deve colar as informações de App Key e App Secret que copiamos anteriormente no Omie, após isso clique em “Confirmar” e em seguida “Ativar integração”.
Após a ativação da integração, copie a URL gerada para criar os webhooks dentro do Omie.
Retorne ao painel do Omie e na barra inferior de opções do mesmo aplicativo que foi configurado no Ploomes (App Key) e clique em “Adicionar novo webhook”.
Cole a URL gerada pelo Ploomes no campo “Endpoint”.
Marque as seguintes entidades e clique em “SALVAR” ao final.
Cliente Fornecedor
Produto (Caso utilize marktplace ou pdv marcar as opções referentes a elas também)
Serviço
Venda Produto
Vendedor
Escolha se há a necessidade de sincronização dos históricos de pedidos e de vendas criados antes da ativação da integração. Se essas opções estiverem desligadas, serão sincronizados somente os pedidos criados após a ativação da integração.
Mapeie os campos que vão ter uma comunicação entre o Ploomes e o Omie. Se atente à tabela de correspondência entre os campos Omie e o tipo de campo no Ploomes. Quando acabar, finalize a ativação da integração clicando em “Atualizar integração”.
É de extrema importância ressaltar que qualquer sincronização necessária só pode ser realizada fora do horário comercial. Isso se deve ao fato de que a sincronização envolve um volume considerável de requisições, podendo sobrecarregar significativamente as APIs do Omie e do Ploomes caso seja executada durante o expediente regular.
Limites da API Omie:
Limite de até 240 requisições por minuto;
Limite de até 4 requisições simultâneas por segundo para consultas;
Requisições redundantes liberadas a cada 60 segundos (*);
Limites da API Ploomes:
Nossa API atualmente está apta a processar até 120 requisições por minuto, considerando todos os usuários de integração da conta em conjunto, portanto, em caso de a sua solução precisar executar muitas requisições simultâneas, esteja preparado para processar respostas HTTP 429 - Too Many Requests.
Algumas entidades possuem um limite de recursos que pode ser obtido em uma solicitação GET. Esse limite é de 300 itens para as entidades: Contacts, Deals, Cities, Tasks, Orders e Quotes.
O máximo payload aceito pela API é de 10MB.
Os limites e recomendações de uso estão presentes na documentação oficial: https://developers.ploomes.com/
Esse artigo te ajudou? Deixe seu retorno abaixo para continuarmos sempre melhorando nossa base de conhecimento. 😊
Ficou com alguma dúvida? Não hesite em chamar o Suporte pelo chat.