open-nfse / EmitirParams

Interface: EmitirParams

Defined in: src/nfse/emit.ts:338

Parâmetros de alto nível para emitSeguro. Equivalente a BuildDpsParams sem o campo nDPS (fornecido pelo DpsCounter), mais os flags de emissão.

Passe nDPS explícito para override manual (útil para dryRun sem queimar um número ou replay determinístico em testes).

Extends

• Omit<BuildDpsParams, "nDPS">.EmitOptions

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
cepValidator?	readonly	CepValidator	Validador de CEP custom. Se omitido, o validador default (ViaCEP) é usado. Passe um custom para usar outra API, banco local ou mock em tests.	EmitOptions.cepValidator	src/nfse/emit.ts:59
dCompet?	readonly	Date	Competência (mês/ano) da prestação do serviço. Default new Date() (hoje). Para notas com competência retroativa (ex.: serviço prestado no mês anterior) informe explicitamente — o default não deduz nada de dhEmi.	BuildDpsParams.dCompet	src/nfse/build-dps.ts:139
dhEmi?	readonly	Date	Default new Date().	BuildDpsParams.dhEmi	src/nfse/build-dps.ts:133
dryRun?	readonly	boolean	Quando true, a pipeline só constrói e assina o XML — sem enviar para a Receita. Útil para previews, testes locais e inspeção offline.	EmitOptions.dryRun	src/nfse/emit.ts:34
emitente	readonly	EmitenteInput	-	BuildDpsParams.emitente	src/nfse/build-dps.ts:120
nDPS?	readonly	string	Override manual do nDPS. Quando presente, o DpsCounter não é consultado. Obrigatório em dryRun (sem isso o preview consumiria um número do counter à toa). Não preencher com zeros à esquerda — o Id da DPS é composto a partir desta string, então '1' e '00001' produzem Ids distintos para o mesmo número sequencial.	-	src/nfse/emit.ts:348
serie	readonly	string	-	BuildDpsParams.serie	src/nfse/build-dps.ts:121
servico	readonly	ServicoInput	-	BuildDpsParams.servico	src/nfse/build-dps.ts:142
skipCepValidation?	readonly	boolean	Pula a validação de CEP (formato + lookup na API externa). Default false. Quando habilitada, cada endereço da DPS (prest/toma/interm/obra/ atvEvento/RTC-dest/fornec) é verificado — a API default é o ViaCEP.	EmitOptions.skipCepValidation	src/nfse/emit.ts:48
skipCpfCnpjValidation?	readonly	boolean	Pula a validação de dígito verificador de CPF/CNPJ. Default false. Apenas identificadores do tipo CNPJ e CPF são validados; NIF e cNaoNIF são ignorados (não têm DV brasileiro).	EmitOptions.skipCpfCnpjValidation	src/nfse/emit.ts:54
skipValidation?	readonly	boolean	Pula a validação XSD local (RTC v1.01) antes de assinar. Default false. A validação roda antes da assinatura: se o XML estiver malformado, o erro aparece localmente com linha + descrição ao invés de virar rejeição da Receita depois de um round-trip. Só desligue para debugging ou quando estiver intencionalmente gerando XML fora do padrão.	EmitOptions.skipValidation	src/nfse/emit.ts:42
tomador?	readonly	TomadorInput	-	BuildDpsParams.tomador	src/nfse/build-dps.ts:144
tpAmb?	readonly	TipoAmbienteDps	Default '2' (Homologação).	BuildDpsParams.tpAmb	src/nfse/build-dps.ts:131
valores	readonly	ValoresInput	-	BuildDpsParams.valores	src/nfse/build-dps.ts:143
verAplic?	readonly	string	Versão do aplicativo emissor. Default open-nfse/<VERSÃO_ATUAL>.	BuildDpsParams.verAplic	src/nfse/build-dps.ts:141