Emissão em série por planilha

Para emitir muitas notas de uma vez (fechamento do mês, lote de uma operadora, faturamento de todos os pacientes), use *Planilha* no menu (módulo "Emissão por planilha", planos Rede e Integrador).

  1. Baixe o modelo (.xlsx). A segunda aba explica cada coluna. Colunas obrigatórias: documento, valor, competencia. As demais: nome, email, im, cep, numero, complemento, referencia, detalhamento, perfil, enviar_email (S/N), pedido.
  2. Preencha uma nota por linha e apague a linha de exemplo. Para CNPJ, nome e endereço são completados pela Receita se ficarem vazios. Para CPF, o nome é obrigatório e, no DF, CEP e número também.
  3. Envie (.xlsx ou .csv). Escolha a empresa emissora e, se quiser, um perfil fiscal padrão para as linhas sem a coluna perfil.
  4. Prévia: o sistema mostra quais linhas estão aptas e quais têm erro, com o motivo escrito na própria linha. Nada foi enviado à prefeitura ainda. Corrija e reenvie, ou emita só as aptas.
  5. Emitir: a emissão roda em segundo plano com barra de progresso. Cada nota autorizada vira uma nota normal (aparece em *Notas* com origem "lote").
  6. E-mail ao tomador: as linhas com enviar_email = S (ou todas, se você marcar a opção) recebem PDF + XML assim que a nota é autorizada, pelo seu servidor de e-mail ou pelo do sistema.
  7. Retorno: ao terminar, a planilha de retorno (.xlsx) traz, por linha: status, número da NFS-e, chave de acesso, código de verificação, erro, se o e-mail ao tomador foi enviado e o link do PDF e do XML. Ela fica em *Planilha → lotes enviados* e vai para o seu e-mail, se você marcou.

Opções avançadas: "Emitir direto ao enviar" pula a prévia (só as linhas sem erro entram). "Emitir também as que a conferência marcar para revisar" força a emissão mesmo com alertas (não recomendado). Pela API: POST /api/v1/lotes com a lista de itens ou a planilha em base64; webhook lote.concluido avisa o seu sistema.

Modo efêmero ("só emitir e sair"): funciona igual; nenhum cadastro é criado e a planilha de retorno é a sua cópia do lote.