emitir-nfe-55listed

# emitir-nfe-55 Implementação de emissão de NF-e modelo 55 (Nota Fiscal eletrônica — operação entre PJ ou PJ→PF B2B). ## Pré-requisitos - [ ] CNPJ do emitente cadastrado na SEFAZ da UF. - [ ] Inscrição Estadual (IE) ativa. - [ ] Certificado digital A1 (`.pfx`/`.p12`) ou A3 (token) ICP-Brasil válido. - [ ] Senha do certificado em **cofre** (Vault / AWS Secrets / Azure Key Vault), nunca em texto puro. - [ ] Empresa **homologada** em ambiente 2 antes de produção. ## Fluxo de emissão ``` [Pedido] → [Montar XML] → [Assinar (XMLDSig)] → [Validar schema XSD] ↓ [Enviar SEFAZ (nfeAutorizacao)] → [Consultar (nfeRetAutorizacao)] ↓ cStat=100 → [Persistir XML autorizado imutável + protocolo + hash] cStat=outro → [Tratar conforme codigo] timeout → [Contingencia SVC-AN] ``` ## Checklist de implementação ### Configuração - [ ] `SEFAZ_AMBIENTE` em env (1 ou 2). FISCAL-003. - [ ] `SEFAZ_UF` em env (sigla da UF do emitente). - [ ] URL do webservice por UF (lista oficial SEFAZ). - [ ] Certificado carregado de cofre. FISCAL-002. ### XML - [ ] Schema XSD vigente baixado (versão do MOC atual — verificar Portal NF-e). - [ ] Assinatura XMLDSig com algoritmo `RSA-SHA-256` (padrão MOC 7.00+, NT 2023.001). `RSA-SHA-1` ainda aceito por algumas UFs por retrocompatibilidade, mas `OpenSSL 3.x` exige `legacy` provider — preferir SHA-256. - [ ] Chave de acesso 44 dígitos gerada corretamente. - [ ] Dígito verificador da chave calculado (módulo 11). ### Persistência - [ ] XML autorizado