Como integrar o Ploomes com o Omie?

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 é possível 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.

Como ativar a integração?

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

Adicionando entidades no mapeamento

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

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 da plataforma ou pelo e-mail suporte@ploomes.com.