Planning Planning Central de ajuda da rede

Split de pagamento: 1. Configuração e rotina

Como conectar o OMIE da sua unidade ao ASAAS, enviar as chaves para a matriz e emitir cobranças com a divisão já aplicada.

Escrito por Operações da Rede Atualizado em 22 de setembro de 2026 Leitura de 8 minutos

A partir da integração entre o OMIE e o ASAAS, a divisão entre a sua unidade e a matriz acontece dentro da própria cobrança, no momento em que o cliente paga. Não existe mais transferência depois, nem planilha de conciliação, nem cobrança de repasse.

A configuração é feita uma vez. Depois dela, você continua trabalhando só no OMIE: cadastra o cliente, lança a conta a receber e dá baixa como sempre fez. O ASAAS emite o boleto ou o Pix e faz a divisão por trás, sem você precisar abrir o sistema dele.

Quem faz o quê

A unidade abre as contas, copia quatro chaves e envia para a matriz. A matriz conecta os dois sistemas, cria a conta corrente do ASAAS dentro do seu OMIE e define o percentual da divisão. Você recebe o aviso quando estiver ativo.

Antes de começar

Confira estes três pontos. Sem eles, a configuração trava no meio do caminho.

  • Conta OMIE ativa, com clientes, faturamento e contas a receber em uso.
  • Acesso de administrador do OMIE, porque é com esse login que se copia as chaves. Se você não tem, defina agora quem na unidade tem.
  • Conta ASAAS aberta no CNPJ da unidade, com os dados bancários preenchidos e a verificação da empresa concluída.
Importante

A verificação da empresa no ASAAS é analisada por eles e costuma levar de um a dois dias úteis. Só copie as chaves do ASAAS depois que a conta estiver liberada. Chave gerada com a conta em análise pode não funcionar.

Como funciona o split

Toda cobrança passa por cinco etapas. Você atua nas duas primeiras e na última. As duas do meio são automáticas.

Cliente cadastrado. Cadastro no OMIE com e-mail válido.

Você

Conta a receber. Lançamento com valor, vencimento, cliente, categoria e a conta corrente do ASAAS.

Você

Aviso ao ASAAS. Ao salvar, o OMIE comunica que existe uma cobrança a emitir.

Automático

Cobrança com split. O ASAAS gera boleto ou Pix já com a divisão entre unidade e matriz.

Automático

Baixa. Recebimento, cancelamento e exclusão saem do OMIE e refletem no ASAAS.

Você

Passo 1: copiar as chaves do OMIE

As chaves são códigos que autorizam um sistema a conversar com o outro. Não são senhas de pessoa. As duas do OMIE ficam na mesma tela e são copiadas juntas.

  1. Acesse developer.omie.com.br. Esse é o Portal do Desenvolvedor, um site separado do OMIE que você usa todo dia.
  2. Entre com o mesmo e-mail e a mesma senha do administrador do OMIE da unidade.
  3. No menu, clique em Aplicativos.
  4. Clique no aplicativo da sua unidade. Se a lista estiver vazia, inclua um novo aplicativo com o nome da unidade e salve. As chaves aparecem depois de salvar.
  5. No topo da tela, copie a App Key e a App Secret.
  6. Cole as duas num bloco de notas, cada uma com o nome ao lado, para não trocar uma pela outra na hora de enviar.
Print Tela de Aplicativos no Portal do Desenvolvedor, com a App Key e a App Secret destacadas no topo
App KeyCurta e só de números. Exemplo: 1234567891011
App SecretLonga, com letras e números. Exemplo: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6
Dica

Se o login no portal não funcionar, não crie uma conta nova. Peça para quem administra o OMIE da unidade liberar o seu acesso ou copiar as duas chaves para você. As chaves precisam sair da conta que está em operação.

Passo 2: copiar as chaves do ASAAS

São mais duas: o Wallet ID, que identifica a carteira da sua unidade, e a API Key, que autoriza as operações na conta. Ambas ficam no mesmo menu.

Wallet ID

  1. Acesse asaas.com e entre na conta da sua unidade.
  2. No menu, clique em Integrações.
  3. Abra a aba Início. O código aparece identificado como Wallet ID ou identificador da carteira.
  4. Copie e cole no mesmo bloco de notas.

O Wallet ID pode ser consultado quantas vezes você quiser nessa mesma tela.

API Key

  1. Ainda em Integrações, abra a aba Chaves de API.
  2. Clique em Gerar chave de API.
  3. Se aparecer um campo de nome, escreva Orquestrador Planning, para você saber depois para que ela serve.
  4. Copie a chave que aparecer na tela antes de confirmar e fechar a janela.
Print Menu Integrações do ASAAS, com a aba Início mostrando o Wallet ID e a aba Chaves de API ao lado
Wallet IDBlocos separados por traços. Exemplo: 8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d
API KeyMuito longa e começa com $aact_. Exemplo: $aact_YTU5YTE0M2M2N2I4MTliNzk0YmQz...
Importante

A API Key aparece uma única vez. Se você fechar a tela sem copiar, não dá para consultar depois: só gerar outra. Gerar outra não quebra nada, mas avise a matriz, porque a chave anterior deixa de valer e a integração precisa ser atualizada.

Passo 3: enviar as quatro chaves para a matriz

Com os quatro códigos em mãos, mande tudo de uma vez, no formato abaixo. A matriz confirma o recebimento, faz a configuração e avisa quando a integração estiver ativa.

Modelo de mensagem 
Unidade: [nome da unidade]
Responsável: [nome e telefone]

OMIE
App Key: [código]
App Secret: [código]

ASAAS
Wallet ID: [código]
API Key: [código]

Verificação da conta ASAAS concluída: [sim ou não]
Importante

Com a API Key, qualquer pessoa consegue criar e cancelar cobrança na conta da sua unidade. Trate como senha de banco: envie pelo canal combinado com a matriz, nunca em grupo de mensagens ou e-mail aberto, e apague o bloco de notas depois que a matriz confirmar o recebimento.

Sua rotina depois de configurado

A partir daqui, tudo acontece no OMIE. São três momentos, sempre nessa ordem.

Cadastrar o cliente

O cliente precisa existir no OMIE antes da cobrança. Se já estiver cadastrado, confira só o e-mail.

  1. Abra Finanças e clique em Clientes e fornecedores.
  2. Clique em Incluir.
  3. Preencha razão social, CNPJ ou CPF e endereço.
  4. Na aba Telefones e E-mail, informe um e-mail válido.
  5. Salve.
Importante

É pelo e-mail do cliente que o ASAAS entrega o boleto ou o Pix. Sem e-mail, a cobrança não é processada e o sistema não avisa que deu errado. E-mail do contato responsável pelo pagamento também serve. O que não pode é ficar em branco.

Lançar a cobrança

O lançamento é o de sempre, com um detalhe que decide tudo: a conta corrente. É ela que liga o título ao ASAAS.

  1. Abra Finanças e clique em Contas a Receber.
  2. Clique em Incluir e escolha Inserção manual.
  3. Informe cliente, valor, vencimento e categoria.
  4. No campo Conta Corrente, selecione a conta do ASAAS, que costuma aparecer como ASAAS IP S.A.
  5. Salve. O OMIE aciona o ASAAS e a cobrança sai com a divisão já aplicada.
Print Tela de inclusão manual de conta a receber no OMIE, com o campo Conta Corrente destacado
Erro mais comum

Escolher a conta corrente errada. Com a conta do banco no lugar da conta do ASAAS, nenhum boleto é gerado e o título fica parado no OMIE. Se a conta do ASAAS não aparecer na lista, a configuração ainda está pendente: fale com a matriz antes de lançar.

Dar baixa e corrigir

Toda movimentação sai do OMIE e reflete no ASAAS sozinha. Você não precisa de controle paralelo.

  1. Abra Finanças e clique em Contas a Receber.
  2. Localize e abra o título.
  3. Para registrar o pagamento, clique em Receber Agora.
  4. Para desfazer um recebimento, clique em Cancelar Recebimentos.
  5. Para apagar um título, clique em Excluir ou em Cancelar Conta a Receber.
Não faça pelo ASAAS

Cancelar, dar baixa ou editar cobrança direto no ASAAS faz as duas bases divergirem e a conciliação deixa de fechar. Tudo pelo OMIE.

Se o boleto demorar a aparecer

Depois que você salva a conta a receber, a cobrança pode levar alguns minutos para aparecer no ASAAS. Isso é atraso de sincronização, não erro de lançamento.

Não relance

Não exclua e não crie a mesma conta a receber de novo. O relançamento gera duas cobranças para o mesmo cliente e alguém vai precisar estornar uma delas. Aguarde alguns minutos e, se ainda assim não aparecer, fale com a matriz antes de mexer.

Perguntas frequentes

Não consigo entrar no Portal do Desenvolvedor do OMIE. E agora?
Não crie uma conta nova. Peça para quem administra o OMIE da unidade liberar o seu acesso ou copiar as duas chaves para você. As chaves precisam sair da conta que está em operação.
Fechei a tela do ASAAS sem copiar a API Key.
Volte em Integrações, aba Chaves de API, e gere outra. Avise a matriz no mesmo momento: a chave anterior deixa de valer e a integração precisa ser atualizada com a nova.
A conta do ASAAS não aparece na lista de contas correntes do OMIE.
Essa conta é criada pela matriz na configuração da integração. Se ela não está na lista, a configuração ainda não foi concluída. Segure os lançamentos e fale com a matriz, para não gerar títulos fora do fluxo.
Salvei a conta a receber e a cobrança não foi emitida.
Confira duas coisas: se o cliente tem e-mail no cadastro do OMIE e se a conta corrente escolhida foi a do ASAAS. Se os dois estiverem certos e a cobrança continuar sem sair, fale com a matriz sem relançar o título.
O cliente diz que não recebeu a cobrança.
Confira o e-mail cadastrado no OMIE. Erro de digitação no e-mail é a causa mais comum. Corrija o cadastro e peça o reenvio para a matriz.
Emiti duas cobranças iguais sem querer.
Cancele uma delas pelo OMIE, com Excluir ou Cancelar Conta a Receber. O cancelamento reflete no ASAAS. Não cancele pelo ASAAS.
Preciso entrar no ASAAS no dia a dia?
Não. Cadastro, lançamento, baixa e cancelamento acontecem no OMIE. O ASAAS opera por trás. Entrar lá só é necessário se a matriz pedir.

Este artigo resolveu sua dúvida?

Ainda precisa de ajuda?

Dúvidas de configuração, chaves que não funcionam e cobranças que não saíram: fale com a matriz pelo canal de suporte da rede. Se o caso envolver um título já lançado, não refaça o lançamento antes de falar com a gente.