@nfewizard/shared

Core utilities do ecossistema NFeWizard para comunicação com SEFAZ (XML, HTTP, Certificados, Schemas).

Instalação

npm install @nfewizard/shared
# ou
pnpm add @nfewizard/shared

Características

• ✅ XmlBuilder - Assinatura digital e geração de SOAP
• ✅ HttpClient - Cliente HTTP configurado para SEFAZ
• ✅ LoadCertificate - Carregamento de certificados A1
• ✅ SchemaLoader - Mapeamento de schemas XSD por operação fiscal
• ✅ NFE_SchemaValidate - Validação de XML contra schema XSD com relatório humanizado
• ✅ Utilities - Funções auxiliares (validações, formatações)

NFE_SchemaValidate

Função pública que valida um XML fiscal contra o schema XSD oficial, disponível para uso direto ou via facade (NFeWizard.NFE_SchemaValidate, NFSe.NFSe_SchemaValidate).

import { NFE_SchemaValidate, SchemaValidationResult } from '@nfewizard/shared';

const result: SchemaValidationResult = await NFE_SchemaValidate(
    xmlString,
    'NFeAutorizacao',
    { validator: 'validateSchemaJsBased' } // opcional
);

// result.success   — boolean
// result.message   — mensagem-resumo humanizada
// result.errors[]  — SchemaValidationIssue[]: { raw, humanized, element?, line?, column?, expected? }
// result.report    — string multilinha estilo SEFAZ-RS
// result.tableRows — Array pronto para console.table
// result.schema    — arquivo XSD utilizado
// result.metodo    — SchemaValidateMethod informado

Métodos disponíveis (SchemaValidateMethod)

| Valor | Schema XSD | |-------|-----------| | 'NFeAutorizacao' / 'NFEAutorizacao' | enviNFe_v4.00.xsd (envelope adicionado automaticamente se ausente) | | 'NFEStatusServico' | consStatServ_v4.00.xsd | | 'NFEConsultaProtocolo' | consSitNFe_v4.00.xsd | | 'RecepcaoEvento' | envEvento_v1.00.xsd | | 'NFeDistribuicaoDFe' | distDFeInt_v1.01.xsd | | 'NFEInutilizacao' | inutNFe_v4.00.xsd | | 'NFERetAutorizacao' | consReciNFe_v4.00.xsd | | 'CTeDistribuicaoDFe' | cte/distDFeInt_v1.00.xsd | | 'NFSe_Autorizacao' | nfse/DPS_v1.01.xsd | | 'NFSe_Consulta' / 'NFSe_Distribuicao' | nfse/NFSe_v1.01.xsd | | 'NFSe_Eventos' | nfse/pedRegEvento_v1.01.xsd | | 'NFSe_ParametrosMunicipais' | — (API REST, sem XSD) |

Seleção do validador

1. options.validator — escolha explícita do caller.
2. options.environment.getConfig().lib?.useForSchemaValidation — valor do config da lib.
3. 'validateSchemaJsBased' — padrão (sem JDK).

Licença

GPL-3.0