Nota fiscal e WhatsApp por API, sem intermediário no caminho
A nota vai ao fisco assinada com o certificado A1 da sua empresa. A mensagem vai ao WhatsApp pelo canal oficial da Meta ou por uma instância sua conectada por QR Code. As duas integrações na mesma conta, contratadas em separado.
# nota fiscal de serviço — NFS-e no Padrão Nacional
curl -X POST "…/api/v1/emitentes/42/nfse" \
-H "Authorization: seu_token" \
-d '{"tomador":{…},"valor_servico":1500.00}'
# 202 { "id": 8412, "status": "processando" }
# mensagem de WhatsApp pela instância conectada
curl -X POST "…/api/v2/whatsapp/mensagem/42/enviar" \
-H "Authorization: seu_token" \
-d '{"to":"5551999999999","type":"text",
"content":"Sua nota 8412 foi autorizada."}'
# 202 { "error": false, "data": { "dbMessageId": 91422 } }Nota fiscal NFS-e · Padrão Nacional NFC-e · modelo 65 NF-e · modelo 55
WhatsApp Oficial · Meta Cloud Alternativa · QR Code Atendimento incluído
Duas linhas de produto, integração direta com cada fonte
Nota fiscal eletrônica e WhatsApp na mesma conta, cobradas em separado: quem só emite nota não paga instância de mensagem, e o contrário também vale. Cada integração vai direto na fonte — o fisco e a Meta —, sem revenda de API de terceiro no caminho.
nota fiscal eletrônica
Emitida direto no fisco
Três modalidades pela mesma API REST, assinadas com o certificado A1 do próprio emitente e transmitidas direto ao autorizador.
- NFS-e Nota de serviço pelo Padrão Nacional, na Sefin Nacional. Sem integração por prefeitura.
- NFC-e Cupom de consumidor final modelo 65, com CSC e QR Code, na SEFAZ do estado.
- NF-e Nota de mercadoria modelo 55, com DANFE, carta de correção e devolução.
A partir de R$ 39,90/mês por CNPJ emitente · Homologação sem custo
Oficial da Meta ou por QR Code
Duas modalidades de conexão, o mesmo formato de chamada nas duas. Você começa por uma e migra para a outra sem reescrever a integração.
- Oficial Meta Cloud API, selo verde e templates HSM. A Meta cobra a conversa no Business Manager do próprio cliente.
- Alternativa Qualquer número por QR Code, pairing code ou sessão importada, sem aprovação da Meta.
- Fila Aquecimento gradual, limite por instância e grupo de failover com até 10 instâncias.
R$ 22/mês por instância nas duas modalidades · 7 dias grátis, sem cartão
Com quem a API fala, sem SDK proprietário no meio
O que costuma dar errado antes de a nota sair e de a mensagem chegar
São os problemas que aparecem em toda conversa com quem já tentou integrar por conta própria ou por um intermediário. A plataforma foi montada em cima deles.
A rejeição chega depois que o número já foi gasto
A SEFAZ recusa o XML por um campo fora do leiaute e devolve rejeição 225 — com a numeração da nota já consumida. Aqui o XML é validado contra o schema oficial antes de sair, então o erro aparece na sua chamada, não na sequência fiscal.
O número do WhatsApp cai no meio da operação
Instância nova despejando mensagem no primeiro dia é o caminho mais curto para perder o número, e sem canal oficial não há para onde correr. Aqui há aquecimento gradual, limite por instância e grupo de failover com até 10 instâncias — e, quando o caso pede o canal oficial da Meta, dizemos isso em vez de vender o alternativo.
A integração passa por um revendedor
É comum contratar API fiscal — ou de WhatsApp — de quem também contratou de outro, somando markup e um intermediário a mais para culpar quando a nota não sai ou a mensagem não chega. A nota daqui vai direto ao autorizador com o seu certificado, e a conversa oficial é cobrada pela Meta no Business Manager da sua empresa, sem margem nossa em cima.
Nota fiscal emitida direto no fisco
Nota de serviço pelo Padrão Nacional, direto na Sefin Nacional, e nota de consumidor direto na SEFAZ do estado — sem revenda de API de terceiro. Cadastra o emitente e o certificado A1 uma vez no painel, e o seu sistema emite pela API a partir daí.
# serviço — NFS-e, Padrão Nacional
POST /api/v1/emitentes/42/nfse
{
"tomador": { "documento": "...", "nome": "..." },
"descricao": "Consultoria em TI",
"valor_servico": 1500.00
}
# varejo — NFC-e modelo 65, cupom com QR Code
POST /api/v1/emitentes/42/nfce
{
"itens": [{ "descricao": "Café torrado 500g",
"quantidade": 2, "valor_unitario": 19.90 }],
"pagamentos": [{ "forma": "17", "valor": 39.80 }]
}
# 202 Accepted: a nota volta em "processando" e você consulta pelo id- NFS-e só pelo Padrão Nacional: o município da prestação é consultado no fisco antes de qualquer emissão
- NFC-e com CSC e QR Code do cupom, autorizada na SEFAZ do estado do emitente
- NF-e modelo 55 de mercadoria, com DANFE, carta de correção e nota de devolução
- Certificado A1 do próprio cliente, cifrado no painel — nunca da APIFácil
- Homologação e produção com o mesmo certificado, só troca o ambiente
- Cancelamento, reconsulta e XML assinado disponíveis pela mesma API
Nota Fiscal
NFS-e pelo Padrão Nacional · 200 notas inclusas
R$ 39,90 /mês por CNPJ
Nota Fiscal Varejo
NFC-e modelo 65 · 500 cupons mais 100 notas dos demais modelos
R$ 59,90 /mês por CNPJ
A NFC-e é liberada por estado, já disponível no Rio Grande do Sul e em São Paulo; a homologação já está aberta em 21 dos 27 estados, sem custo.
Quantos municípios já emitem NFS-e
A NFS-e do Padrão Nacional sai pela mesma chamada em qualquer UF, sem integração por prefeitura. O que varia não é a API: é quantas prefeituras já liberaram a emissão para os contribuintes delas.
Este número não sai de lista de adesão. Cada município foi perguntado ao próprio fisco — a mesma pergunta que é feita antes de emitir a sua nota. Quando a sua prefeitura liberar, a emissão passa a funcionar sozinha aqui, sem configuração nova.
- 371 já emitem pelo Padrão Nacional — 6,7% do país
- 2.340 responderam que ainda não liberaram a emissão
- 2.755 sem confirmação do fisco — não contamos como cobertura
Base de 5.570 municípios. Apurado em 2 de setembro de 2026.
NFC-e e NF-e não dependem de município, e sim de estado. A NFC-e tem produção liberada no Rio Grande do Sul e em São Paulo, e homologação, que é gratuita, aberta em 21 dos 27 estados. Já a NF-e está liberada nesses mesmos dois estados também para homologação, porque nela a liberação é por estado, não por ambiente.
Do cadastro à primeira nota autorizada
Sem reunião comercial e sem proposta. A homologação é liberada antes de qualquer assinatura, então dá para emitir de teste e conferir o XML antes de decidir.
Criar a conta
E-mail e senha em apifacil.dev. O token da API já aparece no painel, e é o mesmo token para nota fiscal e para mensagem.
Cadastrar o emitente
No painel nfe.apifacil.dev: o CNPJ que assina a nota, o certificado A1 e, no varejo, o CSC. Feito uma vez, à mão — o certificado não trafega por API.
Emitir em homologação
Um POST e a nota vai ao ambiente de teste do fisco. Não custa nada, não consome franquia e devolve o XML assinado igual à produção.
Virar para produção
Contrata o serviço e o emitente é promovido a produção com o mesmo certificado — só muda o ambiente na chamada.
WhatsApp pelo canal oficial da Meta ou por QR Code
A mesma chamada nas duas modalidades: você conecta a instância uma vez no painel e o seu sistema envia pela API a partir daí. Começa pelo QR Code hoje e migra para o canal oficial quando fizer sentido, sem reescrever a integração.
- Conexão por QR Code, pairing code ou sessão importada, em cima de qualquer número
- Canal oficial pela Meta Cloud API, com selo verde e templates HSM aprovados
- Conversa oficial cobrada pela Meta no Business Manager da sua empresa, sem markup nosso
- Envio de texto, imagem, vídeo, áudio, documento, localização, enquete e figurinha
- Fila com atraso aleatório, aquecimento gradual e limite por instância
- Grupo de failover com até 10 instâncias: se a ativa cair, a próxima assume
- Webhook de mensagem recebida e de mudança de status, assinado com HMAC
WhatsApp API Alternativa
QR Code, pairing code ou sessão importada · sem aprovação da Meta
R$ 22,00 /mês por instância
WhatsApp Business Oficial
Meta Cloud API · a Meta cobra as conversas em separado, direto de você
R$ 22,00 /mês por instância
A partir de 10 instâncias o preço por instância cai por faixa — a tabela inteira está em Preços. Sete dias grátis, sem cartão, e sem fidelidade.
# texto — vale nas duas modalidades
POST /api/v2/whatsapp/mensagem/42/enviar
{
"to": "5551999999999",
"type": "text",
"content": "Sua nota 8412 foi autorizada."
}
# documento — o PDF da nota no mesmo envio
POST /api/v2/whatsapp/mensagem/42/enviar
{
"to": "5551999999999",
"type": "document",
"mediaUrl": "https://…/danfse-8412.pdf",
"fileName": "nota-8412.pdf"
}
# 202 Accepted: entra na fila da instância e você
# acompanha pelo dbMessageId até "delivered"
Atendimento com o time todo no mesmo número
Caixa de entrada compartilhada em cima da mesma conexão que a sua API usa. Cada atendente entra com o próprio login e a fila é uma só: quem responde, assume a conversa.
- Até 5 atendentes no mesmo número, sem mensalidade por pessoa
- Histórico completo por contato, independente de quem atendeu
- Transferência de conversa entre atendentes
- Envio sempre pela fila, com status de entrega por mensagem
- Notas internas, tarefas e chamados dentro da conversa
- Login separado para o dono da conta e para cada atendente
Uma requisição, quatro linguagens
REST com JSON e autenticação por token no header, igual nos dois produtos. Trocar NFS-e por NFC-e muda o caminho e o corpo, não a forma de integrar — e o mesmo vale para trocar o WhatsApp alternativo pelo canal oficial da Meta.
- Emissão devolve 202 com o id do documento: segue em fila e você consulta até sair de processando
- Envio de mensagem devolve 202 com dbMessageId: você acompanha de pending até delivered
- Idempotência por referencia_externa: reenviar a mesma venda não gera nota dobrada
- XML assinado e PDF (DANFSe, DANFE ou cupom) pela mesma API
- Webhook assinado com HMAC para mensagem recebida e mudança de status
- Token com escopo só de emitir, só de consultar ou de gerenciar
- Arquivo llms.txt da plataforma e um por modalidade de nota, para agentes de IA lerem a documentação
curl -X POST "https://nfe.apifacil.dev/api/v1/emitentes/42/nfse" \
-H "Authorization: seu_token" \
-H "Content-Type: application/json" \
-d '{"referencia_externa":"os-2026-8412",
"tomador":{"documento":"12345678000199","nome":"Cliente Ltda"},
"descricao":"Consultoria em TI",
"valor_servico":1500.00}'const res = await fetch(
'https://nfe.apifacil.dev/api/v1/emitentes/42/nfse',
{
method: 'POST',
headers: {
Authorization: process.env.APIFACIL_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
referencia_externa: 'os-2026-8412',
tomador: { documento: '12345678000199', nome: 'Cliente Ltda' },
descricao: 'Consultoria em TI',
valor_servico: 1500.00,
}),
}
)
// { id: 8412, status: 'processando' }
const { data } = await res.json()use Illuminate\Support\Facades\Http;
$res = Http::withHeaders([
'Authorization' => config('services.apifacil.token'),
])->post(
'https://nfe.apifacil.dev/api/v1/emitentes/42/nfse',
[
'referencia_externa' => 'os-2026-8412',
'tomador' => [
'documento' => '12345678000199',
'nome' => 'Cliente Ltda',
],
'descricao' => 'Consultoria em TI',
'valor_servico' => 1500.00,
]
);
$res->json('data.id');import os, requests
res = requests.post(
"https://nfe.apifacil.dev/api/v1/emitentes/42/nfse",
headers={"Authorization": os.environ["APIFACIL_TOKEN"]},
json={
"referencia_externa": "os-2026-8412",
"tomador": {"documento": "12345678000199", "nome": "Cliente Ltda"},
"descricao": "Consultoria em TI",
"valor_servico": 1500.00,
},
timeout=10,
)
res.json()["data"]["id"]Nota Fiscal
Cobrado por CNPJ emitente, não por instância de WhatsApp — são produtos separados e você pode contratar só este. Homologação é gratuita e ilimitada, então dá para integrar inteiro antes de pagar qualquer coisa.
Nota Fiscal — 200 notas de serviço inclusas por mês, em cada CNPJ
- NFS-e pelo Padrão Nacional, direto na Sefin Nacional, sem revenda
- Assinatura digital com o seu certificado A1, guarda dos XMLs por 5 anos
- Consulta, cancelamento, PDF e trilha de auditoria inclusos
- Homologação gratuita, sem limite de notas e sem assinatura ativa
Nota Fiscal Varejo — 500 cupons NFC-e mais 100 notas dos demais modelos
- NFC-e modelo 65 autorizada na SEFAZ do seu estado, com CSC e QR Code no cupom
- NF-e modelo 55 no mesmo CNPJ, para vender a empresa e para fora do estado
- Excedente de R$ 0,04 por cupom — o volume do varejo cabe no preço do varejo
- Liberação por estado, já disponível no Rio Grande do Sul e em São Paulo
- Homologação de NFC-e aberta em 21 dos 27 estados, sem custo, para integrar o PDV antes
Notas de serviço além das 200 inclusas
Progressivo como imposto de renda: cada faixa cobra só as notas que caem dentro dela, não reclassifica o total.
Cupons além dos 500 inclusos
No serviço de varejo a NFC-e tem preço próprio; NF-e e NFS-e emitidas no mesmo CNPJ usam a franquia de 100 e custam R$ 0,15 cada acima dela.
Vários CNPJs
Desconto na mensalidade a partir do quinto emitente — pensado para contabilidades.
Cada produto da APIFácil tem preço próprio e é contratado à parte: esta mensalidade não cobre nota fiscal, e a nota fiscal não exige instância de WhatsApp. Aqui, cobra-se por instância conectada, qualquer que seja a modalidade — QR Code ou Meta Oficial. As conversas do WhatsApp Oficial vão direto para a Meta, no seu Business Manager, sem passar por nós.
Free
Para conhecer a plataforma
7 dias, sem cartão
- 1 instância de WhatsApp
- Envio de texto e mídia
- Documentação e token da API
- Painel web completo
mais usado
Básico
Para quem já vende pelo WhatsApp
Preço de lançamento; era R$ 49
Desconto por volume a partir de 10 instâncias
- Quantas instâncias você quiser, R$ 22 por cada uma
- WhatsApp por QR Code e Meta Oficial
- Atendimento multiatendente
- Campanhas, agendamento e webhooks
- Fila com controle de intervalo
- Suporte por WhatsApp
Dedicado
500+ instâncias em servidor exclusivo
Contrato anual
- Infraestrutura isolada
- SLA contratual com crédito
- Canal direto com a engenharia
- Apoio na migração
Simule o seu volume
O desconto por instância cresce conforme a quantidade.
O que você não paga
- Markup por conversa: a Meta cobra você diretamente, pela tabela dela
- Taxa de setup na modalidade self-service
- Mensalidade por atendente no atendimento
- Multa de cancelamento
Atendimento e Workflows com IA
A caixa de entrada multiatendente já vem incluída na instância de WhatsApp: não há mensalidade por atendente nem por assento. O que se contrata à parte é a automação com inteligência artificial.
WhatsApp Oficial: serviço de entrada
A mensalidade da plataforma é a mesma nos três casos. O que muda é quanto do processo da Meta você quer fazer por conta própria.
Assistente guiado
Você roda as cinco etapas sozinho, em cerca de uma hora.
Sem taxa de setup
- Assistente passo a passo no painel
- Validação automática de cada etapa
- Documentação e suporte por WhatsApp
recomendado
Onboarding gerenciado
Criamos Business Manager, WABA, número, templates e webhook.
Mais R$ 22/mês de plataforma — R$ 2.019 no primeiro mês
- Business Manager e verificação da empresa
- WABA, número e selo verde
- Templates HSM submetidos e acompanhados até a aprovação
- Webhook configurado e testado
- Você fornece apenas CNPJ e chip
Gestão mensal
Para quem nunca quer falar com a Meta.
Mais o onboarding e a plataforma — R$ 2.516 no primeiro mês
- Tudo do onboarding gerenciado
- Novos templates cadastrados quando precisar
- Acompanhamento de qualidade do número
- Interlocução com o suporte da Meta
Perguntas frequentes
O que a APIFácil faz, afinal?
Duas coisas, contratadas em separado. Nota fiscal eletrônica: NFS-e de serviço pelo Padrão Nacional, NFC-e de consumidor final e NF-e de mercadoria (modelo 55) na SEFAZ do estado. Mensagem: a WhatsApp API Alternativa por QR Code e o WhatsApp Business Oficial da Meta, com caixa de entrada para o time e workflows com IA.
Em ambos, falamos direto com a fonte — Sefin Nacional, SEFAZ, Meta — sem revender API de terceiro. Quem só emite nota não paga instância de WhatsApp, e quem só usa WhatsApp não paga CNPJ emitente.
Quais modalidades de conexão existem?
Duas, na mesma plataforma e com a mesma API: a WhatsApp API Alternativa, por QR Code ou pairing code, que conecta em dois minutos e sem aprovação da Meta; e o WhatsApp Business Oficial, pela Meta Cloud API, com selo verde e sem risco de banimento. Você começa por uma e migra para a outra sem reescrever código.
É seguro? Posso ser bloqueado?
No WhatsApp Business Oficial não existe banimento por usar automação — é o canal da Meta e a automação é o que ele faz. O que existe são duas outras coisas: limite de envio reduzido quando a taxa de bloqueio e denúncia sobe, o que se recupera; e desativação da conta quando a atividade contraria a política da Meta, o que não se recupera abrindo outra conta.
Na conexão por QR Code, qualquer automação tem risco. Ele cai bastante com aquecimento gradual, limite de velocidade e monitoramento, e a plataforma faz as três coisas. Número novo precisa de aquecimento: comece devagar. Não prometemos risco zero nessa modalidade.
Antes de contratar, vale conferir a lista de atividades que não atendemos.
Minha empresa pode usar? Existe atividade que não é aceita?
Existe, e a lista não é nossa: é da política do WhatsApp. Cobrança de dívida, crédito consignado, empréstimo entre pessoas, apostas, criptomoeda, conteúdo adulto e marketing multinível estão entre as atividades vedadas — e a política diz que a vedação vale independentemente de licença, registro ou autorização do setor. Nesses casos a conta é desativada, não apenas limitada, e abrir uma nova não resolve.
A lista completa, com o que continua permitido, está em atividades que não atendemos. Se o seu caso ficar na fronteira, mande o CNPJ e uma amostra das mensagens antes de assinar: a gente confere em um dia útil.
Quanto tempo leva para começar?
Pelo QR Code, menos de cinco minutos: cria a conta, lê o código, envia. No Meta Oficial self-service, cerca de uma hora pelo assistente. No onboarding gerenciado a gente faz tudo, e você fornece apenas CNPJ e chip.
Quanto custa de verdade?
A cobrança é dupla e separada: você paga R$ 22 por mês à APIFácil pela plataforma (preço de lançamento; era R$ 49) e as conversas vão direto para a Meta, no seu próprio Business Manager.
Não aplicamos markup — você enxerga cada centavo na fatura da Meta. É comum o mercado cobrar de R$ 250 a R$ 500 por mês e ainda multiplicar o valor da conversa por dois a cinco.
A nota fiscal é um contrato separado, por CNPJ emitente: R$ 39,90 por mês com 200 notas de serviço inclusas, ou R$ 59,90 com 500 cupons NFC-e. Quem só emite nota não paga instância de WhatsApp, e quem só usa WhatsApp não paga CNPJ emitente. O fisco não cobra por nota autorizada.
Preciso saber programar?
Não. O painel envia mensagens, cria campanhas a partir de planilha e gerencia contatos. Se você for desenvolvedor, a API tem documentação completa, especificação OpenAPI e exemplos em cURL, Node.js, PHP e Python.
E se eu quiser cancelar?
Não há fidelidade. Os 7 dias grátis são sem cartão. Depois você escolhe um plano ou a instância é pausada. Não cobramos nada sem aviso e não retemos seus dados; quando quiser voltar, é só reativar.
A conta da Meta fica com a minha empresa?
Sim. Business Manager, WABA e número ficam na posse da sua empresa. No onboarding gerenciado atuamos com acesso delegado, e você revoga esse acesso quando quiser.
Que notas fiscais vocês emitem hoje?
NFS-e (nota de serviço) nos municípios que emitem pelo Padrão Nacional — município que mantém emissor próprio da prefeitura, como São Paulo capital, fica de fora, e a conferência acontece antes de emitir — e NFC-e (modelo 65, o cupom que substituiu o fiscal) na SEFAZ do estado, hoje liberada no Rio Grande do Sul e em São Paulo, e sendo aberta estado a estado.
A NF-e de mercadoria (modelo 55) também já emite, no Rio Grande do Sul e em São Paulo. A homologação de NFC-e já está aberta em 21 dos 27 estados, sem custo, para você integrar o PDV antes da liberação do seu estado.
Vocês revendem API fiscal de outro provedor?
Não. A assinatura do XML é feita com o certificado A1 da sua empresa e a transmissão vai direto para a Sefin Nacional ou para a SEFAZ do estado. Não há provedor no meio, e o fisco não cobra nada por documento autorizado — a mensalidade e o excedente são o que a APIFácil cobra pela intermediação.
O único custo de terceiro é o certificado digital A1, que você compra direto de uma autoridade certificadora. Não revendemos certificado nem colocamos margem nele.
Preciso assinar para testar a emissão de nota?
Não. A homologação é gratuita e ilimitada: cadastre o CNPJ emitente, envie o certificado A1 e emita quantas notas de teste quiser antes de contratar qualquer coisa. Só a emissão em produção exige um serviço ativo.
Não achou o que precisava? Fale com a gente no WhatsApp ou escreva para suporte@apifacil.dev.
Comece com 7 dias grátis
Sem cartão, sem reunião comercial e sem contrato. Cria a conta e já sai enviando mensagem — ou cadastra o CNPJ emitente e testa a emissão de nota.
- Token da API disponível assim que a conta é criada
- Nota fiscal e WhatsApp no mesmo painel, com o mesmo token
- Conversas cobradas pela Meta, sem markup nosso
- Homologação de nota fiscal liberada sem custo, para integrar antes de assinar
- Suporte por WhatsApp com gente que conhece a API