Checklist para integração de Produtos no Omie

Este artigo explica quais são os requisitos e regras para que produtos e serviços do Omie integrem corretamente com o Ploomes, incluindo limitações, mapeamento de campos e boas práticas para evitar erros na integração.

Diferente de outras entidades, produtos e serviços seguem apenas o fluxo Omie → Ploomes.

• Não é possível criar produtos no Ploomes e enviá-los para o Omie;

• Qualquer criação ou edição estrutural de produtos deve ser feita diretamente no Omie;

• O Ploomes apenas consome as informações enviadas pelo ERP.

Famílias e grupos de produtos no Ploomes

Ao ativar a integração com o Omie, o Ploomes cria automaticamente duas famílias padrão:

• Produtos

• Serviços

Essas famílias são utilizadas para diferenciar, no Omie, pedidos de venda e pedidos de serviço gerados a partir do Ploomes.

Regras de alocação:

1. Produtos do Omie sem família informada são alocados no grupo “Produtos”, dentro da família “Produtos” no Ploomes;

2. Como o Omie não possui campo de família para serviços, todos os serviços são cadastrados no grupo “Serviços”, dentro da família “Serviços” no Ploomes.

Campos obrigatórios para criação de produtos no omie

Para um produto ser criado corretamente no Omie (e consequentemente integrado ao Ploomes), é obrigatório preencher:

• Descrição;

• Unidade;

• Código NCM;

• Código do Produto (gerado automaticamente pelo Omie).

Mapeamento fixo de campos na integração

Os campos abaixo possuem mapeamento fixo na integração entre Omie e Ploomes.

Produtos

Serviços

O campo Marcadores dos produtos no Ploomes segue o mesmo comportamento do campo de status, conforme descrito em:

Consulta de estoque no Ploomes

O estoque dos produtos integrados é exibido no Ploomes por meio de um campo dinâmico de texto multilinha, que armazena uma tabela em HTML.

Regras de exibição

• A tabela respeita as permissões definidas no Omie;

• Apenas locais de estoque habilitados para venda são exibidos;

• Essa configuração é controlada no painel de Locais de Estoque do Omie.

Exemplo da tabela no Ploomes

Informações exibidas na tabela

• Status do Estoque;

• Local de Estoque;

• Estoque Disponível;

• Estoque Mínimo;

• Previsão de Saída;

• Tipo de Local de Estoque;

Atualização dos dados

A tabela é atualizada quando:

• Ocorre uma movimentação no estoque do produto;
  ou

• Um administrador clica manualmente em Atualizar, o que força a atualização de todos os produtos.

Ao final da tabela, é exibida a data e hora da última atualização, garantindo mais transparência.

Limitação relacionada às imagens de produtos

Os links de imagens de produtos gerados pelo sistema Omie possuem um prazo de validade de 7 dias. Após esse período, o link expira automaticamente e a imagem deixa de ser exibida, sendo necessário renovar o link no Omie.

Esse comportamento é uma limitação do Omie e, por consequência, impacta a integração com o Ploomes, que apenas consome o link disponibilizado pelo ERP.

Formas de contorno:

• Editar manualmente o produto no Omie, salvando novamente o cadastro para renovar o link da imagem (solução temporária, válida por mais 7 dias);

• Criar uma rotina semanal de edição em lote de produtos no Omie, para renovação periódica dos links;

• Hospedar as imagens em uma plataforma pública de armazenamento (como Google Drive, por exemplo) e substituir, no Ploomes, o link da imagem pelo link público dessa plataforma (manualmente ou via importação);

• Adicionar a imagem diretamente no Ploomes, fazendo upload do arquivo pelo botão “Selecionar” no campo de imagem e, em seguida, “Adicionar imagem” (processo manual).

---

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.