Emitindo NFC-e a partir de uma venda

A NFC-e é a nota fiscal de venda ao consumidor — usada quando você vende produto no balcão. O PetShop Flow integra com Plugnotas pra emitir, baixar XML/DANFE e cancelar.

Status atual: a emissão fiscal está em Fase 12.5. A configuração e a infraestrutura estão prontas; a UI de emissão completa entra em breve. Se você precisa emitir agora, fala com o suporte que orientamos manualmente.

Pré-requisitos

• Emissor fiscal configurado em /configuracoes/fiscal — veja Configurar emissor.
• Certificado A1 ativo.
• Permissão manage_fiscal.
• Venda criada no PDV.

Passo a passo (quando a UI estiver liberada)

1. Vá em /vendas e abra a venda.
2. Clique em Emitir NFC-e.
3. O PetShop Flow valida que a venda pertence à sua loja.
4. Monta o request fiscal a partir de:
   • Dados do emissor (CNPJ, IE, CFOP, série, regime).
   • Lista de itens da venda (descrição, quantidade, preço).
   • Valor total.
5. Chama o provider (Plugnotas) com o certificado.
6. Recebe o ID externo, número e chave de acesso da nota.

[SCREENSHOT: Botão de emitir NFC-e na tela da venda]

Baixar XML e DANFE

Depois de emitida:

• XML: arquivo oficial pra contabilidade.
• DANFE: PDF amigável que vai pro cliente.

Pra ambos, o PetShop Flow:

1. Verifica que o documento fiscal pertence à sua loja.
2. Se já tem a URL salva, devolve direto.
3. Senão, busca no provider.

Cancelamento

NFC-e pode ser cancelada até 30 minutos após emissão na maioria dos estados (algumas SEFAZ permitem mais). Pra cancelar:

1. Abra a venda.
2. Clique em Cancelar nota.
3. Informe motivo (mínimo 15 caracteres normalmente).
4. O PetShop Flow envia ao provider e marca o documento como cancelado.

Erros e provider não configurado

Quando você tenta emitir sem provider configurado, recebe:

Provider fiscal não configurado. Vá em Configurações → Notas fiscais (em breve).

O PetShop Flow registra um aviso interno apenas quando você escolheu um provider mas a chave não está setada — sinaliza misconfig de produção sem poluir o monitoramento.

Permissões

Só manage_fiscal (administrador, gestor) emite, baixa ou cancela.

Perguntas frequentes

Posso emitir NFC-e pra venda só de serviço?

Não. NFC-e é pra produto. Pra serviço (banho/tosa) use NFS-e a partir do agendamento.

Posso emitir NFS-e?

A infraestrutura está pronta, mas a UI também depende da Fase 12.5. Fala com o suporte.

Posso cancelar depois de 24h?

Em geral, não. Cancelamento fora do prazo SEFAZ exige carta de correção ou nota de devolução — fora do escopo automático do PetShop Flow.