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).
- 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. - 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.
- Envie (.xlsx ou .csv). Escolha a empresa emissora e, se quiser, um perfil fiscal padrão para as linhas sem a coluna
perfil. - 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.
- 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").
- 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. - 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.