Conectar a Notazz (emissão de NFS-e)

A Notazz emite notas fiscais de serviço (NFS-e) por venda. A integração da CopyFunnel é nativa: quando um pedido é pago, a CopyFunnel envia a emissão para a Notazz — uma NF por item opt-in do pedido, com o valor do item como base.

Pegar a API_KEY na Notazz

No painel da Notazz: Configurações → Empresas → API.

Configurar na CopyFunnel

Na rota Integrações, abra o card Notazz e preencha:

1. API_KEY — a chave da Notazz (campo secreto: fica cifrado, nunca volta para a tela — só os últimos 4 dígitos).
2. Produtos que emitem NF (opt-in) — IDs de produto separados por vírgula. Vazio = não emite nenhuma NF. O ID do produto aparece na URL do editor no painel da CopyFunnel (/produtos/<ID>/edit). Emitir nota é opt-in por produto: só os IDs listados aqui geram NF.
3. Endereço do tomador (rua, número, complemento, bairro, cidade, UF e CEP) — o endereço padrão da nota.

Clique em Salvar: a CopyFunnel já valida chamando consult_all_nfse na Notazz (a chave inválida devolve o código 303 e não é aceita). O botão Testar conexão repete a checagem quando quiser.

Por que o endereço do tomador é seu

A NFS-e exige endereço do tomador, mas o checkout digital da CopyFunnel não coleta endereço — então o endereço que vai na nota é o padrão que você configura aqui na credencial. Escolher e manter esse endereço correto é responsabilidade do produtor.

Regras de validação: UF com 2 letras e CEP com pelo menos 8 dígitos — config incompleta faz a emissão ser pulada silenciosamente.

Como a emissão funciona

1. Pedido vira pago (order.completed).
2. A CopyFunnel confere o CPF do comprador: a NFS-e exige documento — compra sem CPF legível não emite (CPF vira TAXTYPE F, CNPJ vira J).
3. Para cada item do pedido que estiver no opt-in, sai uma NF com:
   • Valor — o valor do item (DOCUMENT_BASEVALUE).
   • Descrição — "Prestação de serviços — {produto}".
   • EXTERNAL_ID — orderId:productId (idempotência da Notazz).
   • Tomador — nome, documento, e-mail do comprador + o endereço padrão da credencial.
4. Se dois itens do pedido estiverem no opt-in, saem duas NFs — um item não bloqueia o outro.

Código 101 significa que a nota daquele EXTERNAL_ID já foi vinculada antes — a CopyFunnel trata como sucesso. Reprocessar o mesmo pedido não duplica nota.

O campo URL de postback é opcional: preenchido, a Notazz avisa nessa URL quando a nota é autorizada ou cancelada.

Bom saber

• Falha de emissão nunca derruba a venda — a chamada é fire-and-forget.
• A nota não é reemitida em reenvio do mesmo pedido (idempotente por EXTERNAL_ID).
• Aliquotas, CNAE e LC 116 ficam na configuração da empresa no painel da Notazz — a CopyFunnel envia só os campos do pedido e do tomador.