O que é o Omie
O Omie é um ERP em nuvem popular entre empresas de pequeno e médio porte no Brasil, forte em serviços, distribuição e comércio. Concentra cadastro, pedido, estoque, financeiro e emissão fiscal num produto só, o que resolve bem o núcleo da operação.
O ponto em que ele passa a precisar de integração é quase sempre o mesmo: a venda acontece fora dele — num site próprio, num marketplace, num CRM ou num sistema construído sob medida — e alguém redigita.
O que a API entrega
A API do Omie é REST com autenticação por chave de aplicação, organizada por recurso: cliente, produto, pedido, conta a receber, conta a pagar, ordem de serviço. Na prática dá para criar e consultar praticamente tudo que a tela faz.
O que costuma faltar não é recurso e sim evento: boa parte das integrações acaba usando consulta periódica em vez de ser avisada, o que exige desenhar a frequência com cuidado para não sobrecarregar nem atrasar o dado.
Há limite de chamadas por período. Integração ingênua que consulta tudo a cada minuto bate no limite e passa a falhar de forma intermitente — que é o pior tipo de falha, porque parece instabilidade.
Fluxos que construímos
Pedido do canal de venda para o Omie
Pedido pago no site ou marketplace vira pedido no Omie com cliente localizado ou criado, itens conferidos e condição de pagamento correta. A chave da origem é guardada para nunca duplicar.
Estoque do Omie para os canais
Saldo publicado nos canais com a regra de segurança que você definir — colchão por item ou reserva no fechamento do pedido. Sem regra explícita, campanha vira cancelamento.
Cadastro sem duplicar
Documento como chave de identidade, com decisão declarada para o caso de vir em branco. É o que impede mil clientes virarem quatro mil cadastros.
Financeiro de volta
Baixa de recebimento e status financeiro devolvidos ao canal ou ao painel próprio, para o time parar de consultar duas telas.
O que costuma quebrar
Consulta periódica batendo no limite
A rotina cresce junto com o catálogo e um dia estoura a cota. A saída é consultar por janela de alteração, não o catálogo inteiro — e ter fila com nova tentativa quando o limite responder.
Pedido duplicado por reprocessamento
Sem chave estável da origem, reprocessar uma fila cria o pedido de novo. Idempotência aqui não é refinamento: é o que permite religar a integração depois de qualquer queda.
Produto que não casa
Código do canal diferente do código no Omie é a causa mais comum de pedido travado. O de-para de produto precisa existir e ter tratamento explícito para item novo que ainda não foi cadastrado.
Falha silenciosa
Integração que para e não avisa deixa a operação confiando em dado que não chega mais. Alerta em canal que alguém lê é parte do entregável, não extra.
Prazo típico
- 2 a 4
- semanas para pedido e estoque em produção
- +1 a 2
- semanas para financeiro e devolução
- D+1
- para divergência aparecer no relatório
Perguntas frequentes
Preciso de plano específico do Omie para usar a API?
O acesso à API depende do plano contratado e das permissões da chave de aplicação. Isso é conferido no diagnóstico, antes de qualquer estimativa — descobrir limitação de plano no meio do projeto é o tipo de surpresa que muda prazo.
Dá para integrar sem trocar minha loja?
Dá, e é o caminho normal. A integração fica entre a loja e o Omie; nenhum dos dois precisa mudar. Trocar a loja é outro projeto, com outra justificativa.
E se a integração cair no meio do dia?
Nada se perde. A troca passa por fila com ponto de retomada, então quando o serviço volta a fila sobe na ordem certa e sem duplicar. O que muda é o atraso, e o alerta avisa antes de alguém perguntar.
Vocês mantêm a integração depois de pronta?
Pode ser o seu time ou o nosso. Em qualquer caso entregamos painel de execução, alerta e documentação do que cada rotina faz — integração que só uma pessoa entende é passivo, mesmo funcionando.