Ir para o conteúdo

OUT1515% off na primeira cobrança com o cupom OUT15.15% off na 1ª cobrançaVer planos

Guia

Como emitir nota automaticamente na Kiwify

Como ligar a Kiwify à Emitfy: credenciais da API, papel de produtor, afiliado ou coprodutor, mapa fiscal por produto e o que conferir antes do lançamento.

Rainer R. · FundadorAtualizado em 4 min de leitura

Como funciona Kiwify → Emitfy

A Kiwify avisa a Emitfy quando a venda é aprovada. A Emitfy monta a nota com os dados fiscais do produto e coloca na fila de emissão. Autorizada, a nota fica no painel com XML e PDF.

A conexão aceita três papéis. Produtor emite para o comprador. Afiliado emite a própria comissão contra o produtor. Coprodutor escolhe o modelo: comissionamento (tomador é o produtor) ou parceria (tomador é o comprador, valor é a sua fatia).

Com as credenciais da API, a Emitfy sincroniza o catálogo da Kiwify e cadastra o webhook sozinha. O token que valida os eventos é gerado automaticamente se você deixar o campo em branco.

Passo a passo para emitir na Kiwify

  1. Cadastre o CNPJ emissor

    Crie a conta, adicione a empresa, o município e o serviço padrão. Envie o certificado A1 se o município exigir. As 10 notas grátis servem para validar sem cartão.

  2. Conecte a Kiwify

    Na Kiwify, abra Apps → API e copie Client ID, Client Secret e Account ID. Na Emitfy, crie a integração Kiwify, cole os três campos e salve. O webhook é configurado pela própria Emitfy.

  3. Escolha o papel e mapeie os produtos

    Defina se a conta emite como produtor, afiliado ou coprodutor (e o modelo fiscal, no caso de coprodução). Depois associe cada produto ao serviço, à descrição da nota e às regras de ISS combinadas com o contador.

  4. Faça uma venda de teste

    Aprove um pedido real de valor baixo e confira no painel o status, o XML e o PDF. Peça para o contador revisar a primeira nota.

  5. Acompanhe a primeira semana

    Olhe a fila e os rascunhos todos os dias. Rejeição no começo quase sempre é dado de comprador ou produto sem mapa.

Antes de ligar em produção

  • Client ID, Client Secret e Account ID da Kiwify conferidos
  • Papel da conexão igual ao seu contrato na Kiwify
  • Produtos de upsell e order bump mapeados, não só o principal
  • Tipo de nota da conexão definido (NFS-e, NF-e ou as duas na mesma venda)
  • Venda de teste autorizada e XML revisado pelo contador

O que a integração Kiwify resolve e o que não resolve

Pontos fortes

  • Produtor, afiliado e coprodutor na mesma integração
  • Catálogo sincronizado pela API da Kiwify
  • Fila com retentativa automática quando a prefeitura falha
  • XML e PDF no painel para o fechamento

Pontos de atenção

  • Afiliado sem comissão ou sem documento do produtor no evento: a nota não sai
  • Venda cujo tipo não combina com o papel escolhido é ignorada
  • Produto sem dados fiscais nasce como rascunho até você completar

Perguntas frequentes

Posso emitir como afiliado na Kiwify?

Sim. Escolha o papel Afiliado na conexão. A Emitfy usa a sua comissão informada pela Kiwify como valor e o produtor como tomador. Se o evento não trouxer a comissão ou o documento do produtor, a nota não é emitida, e a Emitfy não troca o tomador pelo comprador.

E se eu for coprodutor?

Escolha Coprodutor e o modelo fiscal. Em comissionamento, a nota vai para o produtor. Em parceria, vai para o comprador, pelo valor da sua fatia. O modelo precisa espelhar o seu contrato; a Emitfy não descobre isso sozinha.

Preciso cadastrar o webhook na Kiwify?

Não. Com as credenciais da API salvas, a Emitfy configura o webhook e gera o token de validação. Você só confere se a venda de teste chegou.

Quanto custa emitir pela Emitfy?

Você testa com 10 notas grátis, sem cartão. Depois, o Quartz custa R$ 47,00/mês com 50 notas e nota extra a R$ 0,89; o Ruby, R$ 97,00/mês com 300 notas. Sem taxa de adesão, e API e MCP em todos os planos. Tabela completa em /planos.

Próximo passo

Automatize a emissão fiscal com a Emitfy

Conecte sua plataforma ou use a API REST. 10 notas grátis para testar, sem cartão.