Guia

Como emitir nota automaticamente na Cakto

Como configurar NFS-e na Cakto na Emitfy: CNPJ, mapeamento, reembolso, fila e o que costuma quebrar no primeiro lançamento.

Por que parei de emitir à mão na Cakto

Portal da prefeitura depois de cada venda na Cakto até funciona no mês 1. No lançamento vira fila de CPF errado, reembolso sem cancelamento e contador pedindo XML que ninguém acha.

Na Emitfy o fluxo é seco: evento de aprovação → fila → NFS-e → XML/PDF no dashboard. Retentativa quando a prefeitura pisca; rascunho quando o dado está podre (melhor que emitir errado).

Cakto aparece em funis curtos e ticket médio. O risco é mapear um único serviço genérico para ofertas diferentes (mentoria vs curso vs comunidade).

Separe no mapeamento Emitfy o que o contador separa na apuração. Descrição genérica demais vira pergunta no fechamento.

Pré-requisitos fiscais (não pule)

CNPJ ativo, inscrição municipal quando o município exigir, e definição do código de serviço / alíquota ISS compatíveis com o que você vende.

Comprador com CPF/CNPJ válido no checkout. Endereço incompleto é uma das causas mais comuns de rascunho ou rejeição — oriente a página de compra ou complete dados antes de forçar emissão.

Confirme em /cidades-atendidas (ou no onboarding) se o município do prestador está no escopo Emitfy para o seu caso de NFS-e.

Passo a passo Cakto → Emitfy

  1. Crie a conta e o CNPJ emissor

    Cadastre-se na Emitfy, adicione a empresa (CNPJ), município, serviço padrão e certificado digital quando a prefeitura exigir.

  2. Conecte Cakto

    Em Integrações, ative Cakto (token/webhook conforme o conector). Confirme um evento de teste chegando à Emitfy antes de mapear o catálogo inteiro.

  3. Mapeie produtos e ofertas

    Associe cada produto ao código de serviço, descrição fiscal e regras de ISS. Sem dados mínimos, a nota fica em rascunho — isso é proteção, não bug.

  4. Defina reembolso e cancelamento

    Combine com o financeiro: quando houver chargeback/reembolso na plataforma, a NFS-e deve ser cancelada ou substituída conforme regra municipal.

  5. Valide com venda de teste

    Faça um pedido de teste (homologação quando disponível) e confira status, XML e PDF no dashboard.

  6. Opere em produção

    Acompanhe fila, falhas com retry, e feche o mês exportando XML/PDF para o contador.

Checklist antes de ir para produção

  • CNPJ e inscrição municipal corretos
  • Município atendido para o seu caso de NFS-e
  • Integração Cakto autenticada e recebendo eventos
  • Todos os produtos ativos mapeados (não só o “principal”)
  • Regra clara para reembolso/cancelamento
  • Quem recebe XML/PDF (cliente, contador, e-mail)
  • Alguém responsável por rejeições na primeira semana

Quem usa Cakto + Emitfy assim

Operação enxuta

Uma pessoa conecta Cakto, mapeia o catálogo e o contador puxa XML no fechamento — sem estagiário colando CPF.

Dia de pico

A fila aguenta volume; o que derruba é dado ruim no checkout. Monitore rejeição nas primeiras horas.

Time com código

Mantém o conector nativo e usa a API só para conciliar, reprocessar ou emitir o que o webhook não cobre.

O que Cakto + Emitfy resolve (e o que não)

Prós

  • Nota sai depois da aprovação na Cakto, sem portal
  • XML/PDF no mesmo lugar para o contador
  • Fila com retry quando a prefeitura oscila
  • Gente no WhatsApp quando a rejeição não faz sentido

Contras / limitações

  • Contador e enquadramento continuam sendo seus
  • Checkout com CPF furado = rascunho (de propósito)
  • Município fora da cobertura = sem mágica
  • Autorização “na hora” depende da prefeitura

Erros comuns (e como evitar)

Produto sem mapeamento: a venda chega, a nota não sai. Revise o catálogo após criar oferta nova na plataforma.

CPF inválido ou estrangeiro sem tratamento: defina política (bloquear checkout vs. emitir com tomador genérico quando a lei local permitir — fale com seu contador).

Ignorar reembolso: nota autorizada + venda cancelada = dor de cabeça. Trate cancelamento como parte do setup, não como exceção.

Perguntas frequentes

Como emitir nota fiscal na Cakto?

Conecte Cakto à Emitfy, configure o CNPJ e os produtos para NFS-e, e deixe a fila emitir após cada pagamento aprovado. Detalhes na integração /integracoes/cakto.

Por que Emitfy e não só o portal na Cakto?

Porque a plataforma de venda não emite NFS-e por você. A Emitfy liga o evento de pagamento à prefeitura. Se outro emissor fechar melhor no TCO, os números estão em /comparativos.

Preciso saber programar?

Não para o fluxo nativo Cakto. Programação só se você preferir API/webhooks customizados.

Quanto custa?

Há trial com notas grátis e planos pagos por volume (ex.: Ruby R$ 97/mês com 300 notas). Veja /planos — há garantia de 7 dias se o produto não atender às expectativas.

E a Reforma Tributária?

Acompanhe /reforma-tributaria. Não afirme readiness IBS/CBS sem ler o que a Emitfy publica oficialmente.

Automatize a emissão fiscal com a Emitfy

Conecte sua plataforma ou use a API REST. 10 notas grátis, sem cartão. Garantia de 7 dias se o produto não atender às expectativas.

Começar grátis