Fatura paga vira OS
Cada fatura paga no WHMCS vira uma Ordem de Serviço no seu Omie, com o serviço e o valor certos.
Módulo para WHMCS · Omie · GPL
Fatura paga no WHMCS vira Ordem de Serviço no Omie. Pronta para emitir a NFS-e, uma OS por fatura.
Se a sua empresa fatura pelo Omie, cada fatura paga no WHMCS vira uma Ordem de Serviço lá, com o cliente pelo CPF ou CNPJ e o serviço que você vende. Você para de digitar a venda duas vezes e fatura a NFS-e no Omie como já faz.
BR.S2 — O que o plugin faz
O cliente paga no WHMCS. A OS aparece no Omie.
Pronta para a NFS-e
A OS cai na coluna Faturar (ou na que você escolher) e a NFS-e sai do faturamento no Omie.
Cliente pelo CPF ou CNPJ
O cadastro no Omie é achado pelo documento e atualizado, sem cliente repetido.
Uma OS por fatura
Código da fatura procurado no Omie antes de criar: resposta perdida ou cron em dobro não duplicam.
Fila que não perde
Omie fora do ar ou chamada bloqueada: a fatura espera e o cron tenta de novo. Recusa mostra o motivo.
Chaves só suas
App Key e App Secret cifradas no seu WHMCS. Nenhum dado passa por servidor nosso.
Provado na API real do Omie numa conta de teste: a fatura paga virou uma OS, o reenvio achou a mesma OS em vez de criar outra, e a OS lida de volta trouxe o valor, o serviço e a coluna Faturar. O pacote foi carregado num WHMCS 9 de verdade.
R$ 197 por ano por instalação do WHMCS, no Pix, boleto ou cartão, com as atualizações e o suporte do ano, sem taxa por fatura. O arquivo é liberado na área do cliente assim que o pagamento é confirmado. O plano do Omie é o seu, contratado direto com o Omie.
BR.S3 — Como fica no WHMCS
A tela do módulo no seu WHMCS.
A tela é o HTML que o módulo gera, com dados de exemplo e um Omie simulado. No seu WHMCS, a lista mostra as suas faturas e as OS do seu Omie.
BR.S4 — Como instalar
Três passos, e o WHMCS já manda as vendas para o Omie.
1. Envie os arquivos
Na área do cliente, baixe o .zip e descompacte na pasta raiz do WHMCS, a que tem o init.php. Ele só cria a pasta modules/addons/brasaomie.
2. Ative e conecte
Em Configurações, Módulos adicionais, ative o Brasa Conector Omie, abra a tela dele em Addons e cole a App Key e a App Secret do seu aplicativo no Omie.
3. Escolha e confira
Escolha o serviço, a categoria, a conta corrente e a coluna da OS, pague uma fatura pequena para você mesmo e veja a OS no Omie.
BR.S5 — Perguntas frequentes
O que perguntam antes de comprar.
Por que não um módulo de ERP que já existe?
Os módulos de ERP para WHMCS que encontrei ligam o Bling e o Conta Azul, por R$ 19,98 por mês cada. Para o Omie não achei nenhum: quem usa Omie lança a venda do WHMCS à mão ou paga integração sob medida. O Brasa Conector Omie custa R$ 197 por ano.
O que vai para o Omie?
Cada fatura paga vira uma Ordem de Serviço com o cliente, o serviço que você escolheu e o valor da fatura, na coluna que você escolher (o padrão é Faturar). Os itens da fatura vão no texto da nota. A NFS-e e o contas a receber saem do faturamento da OS no próprio Omie, do jeito que você já fatura lá.
E o cliente?
Entra pelo CPF ou CNPJ, do campo Tax ID do WHMCS ou de um campo personalizado que você indicar, e o Omie atualiza o cadastro que já existe em vez de criar outro. Cliente sem documento entra pelo número do cliente no WHMCS, e você completa o CPF ou CNPJ no Omie antes de faturar.
Uma fatura pode virar duas OS?
Não. Cada OS leva um código desta instalação do WHMCS e da fatura, e o módulo procura esse código no Omie antes de criar. Se a resposta do Omie se perder no caminho, a próxima tentativa acha a OS que já existe. Dois processos do cron ao mesmo tempo também não duplicam: a fatura fica reservada para um só.
E se o Omie estiver fora do ar?
A fatura espera na fila e o cron do WHMCS tenta de novo, cinco vezes, com espera crescente. O Omie também bloqueia por cerca de um minuto a chamada repetida, e o módulo espera em vez de insistir. Recusa do Omie, como um serviço apagado, aparece na tela com o motivo e o botão Reenviar.
Preciso cadastrar o serviço no Omie?
Sim, o serviço que você vende (hospedagem, domínio, suporte) cadastrado em Serviços no Omie, porque é ele que traz o código municipal, a LC 116 e os impostos da NFS-e. Na tela do módulo você escolhe esse serviço numa lista lida do seu Omie, junto com a categoria e a conta corrente.
Minhas chaves do Omie ficam seguras?
A App Key e a App Secret ficam cifradas no banco do seu WHMCS, com o segredo da sua instalação, e as chamadas vão do seu WHMCS direto para o Omie. Nada passa por servidor nosso. Chaves copiadas para outro WHMCS não abrem.
O que já foi testado, e o que não foi?
O módulo passou por um WHMCS de teste com o fluxo inteiro contra um Omie simulado e foi provado na API real do Omie, numa conta de teste: a fatura paga virou uma OS, o reenvio da mesma fatura achou a OS em vez de criar outra, e a OS lida de volta trouxe o valor, o serviço e a coluna Faturar. O pacote que você baixa foi carregado dentro de um WHMCS 9 de verdade. O faturamento da OS (a NFS-e) é do Omie e não foi testado, porque depende da configuração fiscal da sua empresa lá. Antes de seguir, pague uma fatura pequena para você mesmo e confira a OS no Omie.
E as faturas pagas antes de instalar?
A versão 0.1 manda só as faturas pagas depois da ativação. Reembolso no WHMCS também não cancela a OS no Omie: cancele lá. Se precisar de uma dessas, chame no WhatsApp.
O que preciso para instalar?
WHMCS 8.8 ou mais novo, com PHP 8.1 ou mais novo e a extensão curl, o cron do WHMCS ativo e um aplicativo no Omie (Meus aplicativos, em developer.omie.com.br) com a App Key e a App Secret.
E se eu não renovar a licença?
O módulo continua funcionando no seu WHMCS como está, porque ele não consulta licença nem desliga recurso. A fatura da renovação sai 20 dias antes do vencimento; sem pagamento, a licença fica suspensa 30 dias depois e a área do cliente deixa de liberar as versões novas e o suporte. Pagou depois, ela volta a ficar ativa sozinha.
BR.S6 — Suporte
Seu WHMCS tem algo diferente?
Faturas antigas, cancelar a OS no reembolso e faturar a NFS-e pelo WHMCS ficam de fora da versão 0.1. Se o seu WHMCS precisa de outra coisa, ou se a primeira fatura não chegar ao Omie, chame no WhatsApp. Você fala com quem escreveu o módulo.