Integração da iugu com o Omie
A integração da iugu com o Omie leva cada fatura criada na iugu para o contas a receber do Omie e, quando o gatilho da iugu avisa que ela foi paga, lança o recebimento no Omie pela API. Em outubro de 2026 não encontramos integração nativa entre os dois; a LHCX monta o fluxo sob medida, com código de integração para não duplicar e logs de cada lançamento.
Existe integração nativa entre a iugu e o Omie?
Não encontramos. Em outubro de 2026, a documentação para desenvolvedores da iugu não menciona o Omie, a central de ajuda do Omie não menciona a iugu, o resumo de integrações bancárias do Omie não inclui a iugu e a Omie.Store não tem um app da iugu.
O único caminho pronto que encontramos é de terceiro: a página do app Pluga na Omie.Store cita a automação "quando um pagamento for aprovado na Iugu, gerar um pedido de venda no Omie ERP". Para quem precisa do contas a receber e da baixa, com regras do financeiro, o caminho é uma integração pelas APIs dos dois sistemas.
O fluxo da integração, do cliente à baixa
- 01
Cliente no Omie
O pagador da iugu é procurado ou criado no Omie com UpsertCliente, usando o codigo_cliente_integracao para ligar o cadastro dos dois lados sem duplicar.
- 02
Fatura vira conta a receber
Cada fatura criada na iugu (o gatilho invoice.created avisa) vira um lançamento no Omie com UpsertContaReceber: codigo_lancamento_integracao com o id da fatura, cliente, data_vencimento, valor_documento, codigo_categoria e id_conta_corrente.
- 03
Pagamento vira baixa
Quando o gatilho invoice.status_changed chega com o status paid, a integração confirma a fatura na iugu e chama LancarRecebimento no Omie, informando o codigo_lancamento_integracao, o valor, a data e a conta corrente.
- 04
Cancelamento, expiração e reembolso
Os status canceled, expired e refunded seguem a regra que o financeiro definir: cancelar o recebimento (CancelarRecebimento), manter o título em aberto para nova cobrança ou outro tratamento.
- 05
Tarifas e conciliação
A forma de registrar as tarifas da iugu é definida com o financeiro e com o contador. A conciliação pode ser feita na própria baixa (conciliar_documento) ou depois, com ConciliarRecebimento.
Exemplo: baixa no Omie quando a iugu avisa o pagamento
POST https://app.omie.com.br/api/v1/financas/contareceber/
Content-Type: application/json
{
"call": "LancarRecebimento",
"app_key": "SUA_APP_KEY",
"app_secret": "SEU_APP_SECRET",
"param": [{
"codigo_lancamento_integracao": "ID_DA_FATURA_NA_IUGU",
"codigo_conta_corrente": 1234567,
"valor": 159.90,
"data": "25/10/2026",
"observacao": "Pago pela iugu (Pix)"
}]
}Detalhes que derrubam integrações improvisadas
- Datas em formatos diferentes: a iugu usa AAAA-MM-DD no due_date; o Omie usa DD/MM/AAAA nos campos de data
- Valores em unidades diferentes: a iugu trabalha em centavos (price_cents, paid_cents); o Omie recebe o valor decimal
- Tamanho dos códigos: codigo_lancamento_integracao aceita 60 caracteres, mas codigo_baixa_integracao aceita só 20, e o id da fatura da iugu nos exemplos da documentação tem 32
- Avisos repetidos: a iugu reenvia o gatilho quando não recebe resposta de sucesso, então a baixa precisa conferir se já foi feita
- Limites da API do Omie: requisições por minuto e chamadas simultâneas têm teto, e inclusões não aceitam chamadas em paralelo
- Ambientes separados: o token de teste da iugu tem gatilhos próprios; vale testar com um aplicativo do Omie que não seja o da operação real
Pluga, n8n ou código?
| Caminho | Bom quando | Limite |
|---|---|---|
| Pluga (terceiro, na Omie.Store) | Basta gerar um pedido de venda no Omie quando o pagamento é aprovado. | Automação padrão, com pouca margem para regra própria de contas a receber e baixa. |
| n8n | O fluxo tem etapas, validações e exceções (cliente novo, pagamento parcial, reembolso). | Precisa de servidor e de alguém responsável por manter. |
| Código dedicado | Volume alto, várias contas ou regras fiscais e financeiras mais rígidas. | Maior esforço de construção e de manutenção. |
O que a LHCX entrega
- Mapa do fluxo atual de cobrança e baixa, da iugu ao Omie
- Regras documentadas para cada status da fatura e para as tarifas
- De-para de cliente, categoria, conta corrente e departamento
- Integração com código de integração em cada lançamento e controle de duplicidade
- Logs de cada fatura e de cada baixa, alertas para exceções e reprocessamento
- Período em paralelo com o processo atual antes de desligar a baixa manual
Páginas e leituras relacionadas
Integração com a iugu
Links de pagamento pela API, gatilhos e status do pedido na loja online.
Ver a páginaIntegração com Omie
API, webhooks e limites de requisição do Omie.
Ver a páginaWebhook da iugu: status em tempo real
Como receber os gatilhos com segurança e sem duplicar.
Ver a páginaComo gerar link de pagamento na iugu pela API
Criação da fatura, autenticação e campos obrigatórios.
Ver a páginaAnálise completa do ERP Omie
Contas bancárias, conciliação e formas de pagamento no Omie, na prática.
Ver a páginaIntegração NFE.io com Omie
Outro exemplo de integração com o Omie por webhook e Pluga.
Ver a páginaPedir orçamento pelo WhatsApp
Conte quantas faturas saem por mês e como a baixa é feita hoje. Respondemos em até 24 horas.
Ver a página
Fontes
Informações consultadas em outubro de 2026. A LHCX é uma consultoria independente, sem parceria com a iugu, com o Omie ou com a Pluga.
Integração da iugu com o Omie: dúvidas comuns
A iugu tem integração nativa com o Omie?
Não encontramos, em outubro de 2026, nem na documentação da iugu nem na do Omie ou na Omie.Store. Existe a opção de terceiro da Pluga, que cita a geração de pedido de venda no Omie quando um pagamento é aprovado na iugu.
Dá para dar baixa automática no Omie quando a fatura é paga na iugu?
Dá. O gatilho invoice.status_changed avisa o pagamento, e a integração chama o método LancarRecebimento da API de contas a receber do Omie, identificando o título pelo código de integração usado na criação.
E se o mesmo aviso de pagamento chegar duas vezes?
A integração precisa conferir antes de lançar. A LHCX registra cada aviso pelo id da fatura e pelo status, e consulta o título no Omie antes da baixa, para não lançar o mesmo recebimento duas vezes.
O Omie já gera boleto e Pix. Preciso da iugu?
Depende da operação. O Omie tem APIs de boleto e de Pix (com a conta Omie.CASH como padrão do Pix). A iugu entra quando a empresa já cobra por ela ou precisa de recursos como cartão, assinaturas ou split. O diagnóstico compara os dois caminhos.
Como ficam as tarifas da iugu no Omie?
A forma de registrar é decidida com o financeiro e o contador, e a integração segue essa regra em todo lançamento.
A LHCX é parceira da iugu ou do Omie?
Não. A LHCX é uma consultoria independente de automação e dados. A integração usa as APIs públicas documentadas pelos dois, com as credenciais da sua empresa.
Quanto custa e quanto tempo leva?
Depende do volume de faturas, dos status que precisam de regra e de quantas contas e categorias entram no de-para. Depois do diagnóstico, a proposta traz escopo, etapas, prazo e investimento.
Cobra pela iugu e dá baixa no Omie à mão? Conte como o financeiro faz hoje.
Respondemos em até 24 horas com as próximas perguntas e uma proposta objetiva.