# Prompt: fluxo completo de emissão fiscal

## Solicitação

Analisar integralmente o Muirasoft e `emissor-api/docs/DOCUMENTACAO-IA.md` e implementar NF-e 55/NFC-e 65 com a operação como fonte das regras. O pedido inclui empresas, A1, operações, produtos, clientes/fornecedores, vendas/compras, idempotência, estados, persistência, XML/PDF, cancelamento/eventos, segurança, migrations, testes e documentação, sem inventar contratos ou executar efeitos fiscais reais.

## Resposta e decisões implementadas

- A arquitetura, schema e fluxos comerciais foram inspecionados antes da alteração.
- Foi criado serviço fiscal central, gateway autenticado, pré-validação e persistência idempotente separada da venda.
- Estoque/financeiro permanecem no fluxo transacional existente; tentativa fiscal nunca os duplica.
- Operação passou a definir modelo, finalidade, CFOPs, destinatário e automação.
- Empresa, produto, cliente e fornecedor receberam campos fiscais; o A1 é testado e segredos são omitidos das respostas.
- Foi criada a área Documentos Fiscais com filtros, histórico, XML, PDF, impressão, reprocessamento seguro, cancelamento e CC-e.
- A migration numerada foi aplicada no banco local sem apagar dados.
- Foram criados testes por mock/contrato e schema, sem contato com a SEFAZ.
- Ausências do contrato (consulta assíncrona, inutilização, manifestação, metadados completos do certificado e atomicidade da numeração no emissor) foram registradas em `docs/INTEGRACAO-FISCAL.md`, sem endpoints inventados.

## Continuação — ações fiscais nas telas com operação (2026-07-17)

### Solicitação

Todas as telas que envolvem operação devem expor emissão de cupom ou nota fiscal. As listagens de vendas e compras devem mostrar as opções de emissão e de preview de cada registro.

### Resposta e decisões implementadas

- As listagens e formulários de vendas e compras passaram a exibir o modelo fiscal definido pela operação e ações de preview/emissão.
- A listagem de pedidos também recebe as ações porque reutiliza o mesmo cartão de venda.
- O preview de NF-e 55 usa exatamente `POST /fiscal/nfe/preview`, sem assinar, transmitir ou incrementar numeração.
- Como a API não documenta preview de NFC-e 65, a ação correspondente executa somente pré-validação local e informa claramente essa limitação; nenhum endpoint foi simulado.
- Compras fiscais aceitam somente NF-e 55 de entrada e CFOP iniciado por 1, 2 ou 3. NFC-e e operações de saída são bloqueadas na pré-validação.
- Documentos de compra usam idempotência própria, aparecem na central fiscal e podem ser emitidos manualmente ou automaticamente conforme a operação.
- O cancelamento de compra com NF-e autorizada solicita primeiro o cancelamento fiscal e só então efetua o estorno de estoque.
- Nenhuma emissão real foi executada nos testes. Foram validados contrato mockado, schema, sintaxe PHP, tipos e lint.