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:
Produtos do Omie sem família informada são alocados no grupo “Produtos”, dentro da família “Produtos” no Ploomes;
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.
⚠️ Atenção: os produtos devem obrigatoriamente pertencer às famílias “Produtos” ou “Serviços” no Ploomes. A remoção ou alteração dessas famílias pode causar falhas na integração de vendas.
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
Omie | Ploomes |
Descrição | Nome |
Código | Código |
Unidade de Medida | Unidade de medida |
Preço unitário | Valor unitário |
Família | Grupo |
Inativo | Marcadores |
Serviços
Omie | Ploomes |
Descrição | Nome |
Código | Código |
Preço unitário | Valor unitário |
Inativo | Marcadores |
O campo Marcadores dos produtos no Ploomes segue o mesmo comportamento do campo de status, conforme descrito nas observações da integração de clientes.
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;
ouum 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.