@sinete/nfe 0.1.0 → 0.2.0

package/src/build/destinatario.ts

@@ -5,11 +5,11 @@
  * critério da UF (E16a-30 e E16a-35, E14-10 e E14-20, facultativas). As regras só da NFC-e estão em `nfce.ts`.
  */
 
-import { ufBySigla } from '@sinete/core';
-import { parseCnpj } from '@sinete/validators';
+import { ufPorSigla } from '@sinete/core';
+import { lerCnpj } from '@sinete/validators';
 import suframa from '../data/suframa.json' with { type: 'json' };
 import type { Issues } from '../issues.ts';
-import type { NfeInput } from '../model.ts';
+import type { DadosNfe } from '../model.ts';
 
 /** Identificação já resolvida pelo montador (com os padrões aplicados). */
 export interface IdeDestinatario {
@@ -26,7 +26,7 @@ const ID_ESTRANGEIRO = /^[0-9A-Za-z:.+\-/()]*$/;
 
 const digitos = (s: string): string => s.replace(/\D/g, '');
 
-export function conferirDestinatario(input: NfeInput, ide: IdeDestinatario, issues: Issues): void {
+export function conferirDestinatario(input: DadosNfe, ide: IdeDestinatario, issues: Issues): void {
   const d = input.destinatario;
   if (d === undefined) return;
   const nfe = ide.mod === '55';
@@ -85,7 +85,7 @@ export function conferirDestinatario(input: NfeInput, ide: IdeDestinatario, issu
   // E10-20: o município do destinatário é da UF dele (as duas primeiras posições do código são o código da UF).
   if (end !== undefined && !exterior) {
     const e = end as { UF: string; cMun: string };
-    const cUF = ufBySigla(e.UF)?.cUF;
+    const cUF = ufPorSigla(e.UF)?.cUF;
     if (cUF !== undefined && digitos(e.cMun).slice(0, 2) !== cUF) {
       issues.add(
         'destinatario.endereco.cMun',
@@ -108,11 +108,11 @@ export function conferirDestinatario(input: NfeInput, ide: IdeDestinatario, issu
     // Na saída a entrega vale contra o emitente e a retirada contra o destinatário; na entrada, ao contrário.
     const [ufEntrega, ufRetirada] = saida ? [emitUf, destUf] : [destUf, emitUf];
     if (ide.idDest === '2' && destUf === emitUf) {
-      // CNPJ alfanumérico: as letras contam; só a máscara sai (a mesma normalização do parseCnpj).
+      // CNPJ alfanumérico: as letras contam; só a máscara sai (a mesma normalização do lerCnpj).
       const cnpj = (v: string | undefined): string | undefined => {
         if (v === undefined) return undefined;
-        const r = parseCnpj(v);
-        return r.ok ? r.value : undefined;
+        const r = lerCnpj(v);
+        return r.ok ? r.valor : undefined;
       };
       const cnpjDest = 'CNPJ' in d ? cnpj(d.CNPJ) : undefined;
       const mesmoCnpj = cnpjDest !== undefined && cnpjDest === cnpj(input.emitente.CNPJ);

package/src/build/ibscbs.ts

@@ -3,9 +3,9 @@
  * `IBSCBSTot` (W34 a W59g) somando exatamente os valores dos itens.
  */
 
-import { firstChild, parseXml } from '@sinete/core/xml';
+import { lerXml, primeiroFilho } from '@sinete/core/xml';
 import type { ComplexType } from '@sinete/schemas';
-import { serialize, validate } from '@sinete/schemas';
+import { serializar, validar } from '@sinete/schemas';
 import type { TIBSCBSMonoTot, TTribNFe } from '@sinete/schemas/nfe/PL_010f';
 import { Decimal } from '../decimal.ts';
 import type { Issues } from '../issues.ts';
@@ -19,12 +19,16 @@ const NFE_NS = 'http://www.portalfiscal.inf.br/nfe';
 export function grupoInvalido(ct: ComplexType, nome: string, value: unknown, path: string, issues: Issues): boolean {
   if (value === undefined) return false;
   try {
-    const doc = parseXml(`<w xmlns="${NFE_NS}">${serialize(ct, nome, value as never, NFE_NS)}</w>`);
-    const el = firstChild(doc.root, nome, NFE_NS);
+    const doc = lerXml(`<w xmlns="${NFE_NS}">${serializar(ct, nome, value as never, NFE_NS)}</w>`);
+    const el = primeiroFilho(doc.raiz, nome, NFE_NS);
     const erros =
-      el === undefined ? [{ path: '', code: 'modelo_de_conteudo', message: 'grupo vazio' }] : validate(ct, el);
+      el === undefined ? [{ caminho: '', code: 'modelo_de_conteudo', mensagem: 'grupo vazio' }] : validar(ct, el);
     for (const e of erros)
-      issues.add(`${path}${e.path.replace(/^\/[^/]+/, '').replace(/\//g, '.')}`, 'schema', `${e.code}: ${e.message}`);
+      issues.add(
+        `${path}${e.caminho.replace(/^\/[^/]+/, '').replace(/\//g, '.')}`,
+        'schema',
+        `${e.code}: ${e.mensagem}`,
+      );
     return erros.length > 0;
   } catch (e) {
     issues.add(path, 'schema', `grupo malformado: ${(e as Error).message}`);

package/src/build/icms.ts

@@ -6,7 +6,7 @@
 import type { TNFe_infNFe_det_imposto_ICMS } from '@sinete/schemas/nfe/PL_010f';
 import type { DecimalInput } from '../decimal.ts';
 import { Decimal } from '../decimal.ts';
-import type { DecimalFormat } from '../format.ts';
+import type { FormatoDecimal } from '../format.ts';
 import { D0302A04, D0302A04_OPC, D1104V, D1302 } from '../format.ts';
 import type {
   Desoneracao,
@@ -74,9 +74,9 @@ export interface IcmsItemBase {
 
 type Out = Record<string, string | undefined>;
 
-const M: DecimalFormat = D1302;
-const P: DecimalFormat = D0302A04;
-const PO: DecimalFormat = D0302A04_OPC;
+const M: FormatoDecimal = D1302;
+const P: FormatoDecimal = D0302A04;
+const PO: FormatoDecimal = D0302A04_OPC;
 
 function nonNeg(d: Decimal): Decimal {
   return d.isNegative() ? Decimal.ZERO : d;
@@ -221,7 +221,7 @@ export function buildIcms(
 
   /** Retido anteriormente (N26 a N26b, N27a a N27c, N34 a N37): informativo, só o FCP retido entra no total. */
   const retido = (i: IcmsStRetido): Out => {
-    const o = (k: keyof IcmsStRetido, f: DecimalFormat): string | undefined =>
+    const o = (k: keyof IcmsStRetido, f: FormatoDecimal): string | undefined =>
       ctx.so(ctx.opt(i[k], `${path}.${k}`, f), f);
     const vFCPSTRet = ctx.opt(i.vFCPSTRet, `${path}.vFCPSTRet`, M);
     if (vFCPSTRet !== undefined) t.vFCPSTRet = t.vFCPSTRet.plus(vFCPSTRet);
@@ -259,7 +259,7 @@ export function buildIcms(
       vFCPDif?: DecimalInput;
       vFCPEfet?: DecimalInput;
     },
-    redFormat: DecimalFormat,
+    redFormat: FormatoDecimal,
     triade: boolean,
   ): Out => {
     const pRedBC = ctx.opt(i.pRedBC, `${path}.pRedBC`, redFormat);

package/src/build/nfce.ts

@@ -7,14 +7,14 @@
  * UF decide, e recusar localmente bloquearia a venda onde a regra não vale.
  */
 
-import type { Ambiente, Signer, Uf } from '@sinete/core';
-import { tpAmbOf } from '@sinete/core';
-import { base64Encode, c14n, firstChild, parseXml, SHA1_DIGEST_INFO_PREFIX } from '@sinete/core/xml';
-import { parseCnpj } from '@sinete/validators';
+import type { Ambiente, Assinador, Uf } from '@sinete/core';
+import { tpAmbDoAmbiente } from '@sinete/core';
+import { c14n, codificarBase64, lerXml, PREFIXO_DIGEST_INFO_SHA1, primeiroFilho } from '@sinete/core/xml';
+import { lerCnpj } from '@sinete/validators';
 import urls from '../data/nfce-urls.json' with { type: 'json' };
 import { Decimal } from '../decimal.ts';
 import type { Issues } from '../issues.ts';
-import type { NfeInput } from '../model.ts';
+import type { DadosNfe } from '../model.ts';
 
 /**
  * Versão do QR Code da NFC-e. A 3 (padrão) dispensa o CSC: na emissão normal leva só chave, versão e ambiente, e na
@@ -60,7 +60,7 @@ function vigente(lista: readonly Entrada[] | undefined, dia: string): Entrada |
 /**
  * Endereços da NFC-e da UF no ambiente e no dia (`data/nfce-urls.json`, das tabelas do Portal Nacional da NFC-e). O
  * `qrCode` é `undefined` onde a tabela não traz o endereço completo (AM e MA publicam sem o protocolo): informe
- * `BuildNfeOptions.urlQrCode`.
+ * `MontarNfeOpcoes.urlQrCode`.
  */
 export function urlsNfce(
   uf: Uf,
@@ -87,10 +87,10 @@ const hex = (b: Uint8Array): string => Array.from(b, (x) => x.toString(16).padSt
  * `797a4759...`).
  */
 async function digValHex(xml: string): Promise<string> {
-  const doc = parseXml(xml);
-  const inf = firstChild(doc.root, 'infNFe', NFE_NS);
+  const doc = lerXml(xml);
+  const inf = primeiroFilho(doc.raiz, 'infNFe', NFE_NS);
   if (inf === undefined) throw new Error('NF-e montada sem infNFe');
-  return hexDoDigestValue(base64Encode(await sha1(te.encode(c14n(inf)))));
+  return hexDoDigestValue(codificarBase64(await sha1(te.encode(c14n(inf)))));
 }
 
 /** O DigestValue em Base64 convertido para hexadecimal, caractere a caractere (Manual 6.0, 4.3.5, passo 1). */
@@ -128,7 +128,7 @@ export async function parametrosQrCode(
   d: DadosQrCode,
   qr: QrCodeNfceOpcoes,
 ): Promise<{ readonly parametros: string; readonly assinar: boolean }> {
-  const tpAmb = tpAmbOf(d.ambiente);
+  const tpAmb = tpAmbDoAmbiente(d.ambiente);
   const offline = d.tpEmis === '9';
   const dia = d.dhEmi.slice(8, 10);
   if (qr.versao === '3') {
@@ -155,14 +155,14 @@ export async function parametrosQrCode(
  * Assinatura dos parâmetros 1 a 7 do QR Code versão 3 off-line: RSA com SHA-1 (PKCS#1 v1.5), em Base64, com o mesmo
  * certificado que assina a NFC-e (Manual 6.0, 4.4.2, parâmetro 8).
  */
-export async function assinarParametros(parametros: string, signer: Signer): Promise<string> {
+export async function assinarParametros(parametros: string, signer: Assinador): Promise<string> {
   const bytes = te.encode(parametros);
-  if (signer.kind === 'data') return base64Encode(await signer.sign(bytes, 'SHA-1'));
+  if (signer.tipo === 'dados') return codificarBase64(await signer.assinar(bytes, 'SHA-1'));
   const h = await sha1(bytes);
-  const di = new Uint8Array(SHA1_DIGEST_INFO_PREFIX.length + h.length);
-  di.set(SHA1_DIGEST_INFO_PREFIX);
-  di.set(h, SHA1_DIGEST_INFO_PREFIX.length);
-  return base64Encode(await signer.signDigestInfo(di));
+  const di = new Uint8Array(PREFIXO_DIGEST_INFO_SHA1.length + h.length);
+  di.set(PREFIXO_DIGEST_INFO_SHA1);
+  di.set(h, PREFIXO_DIGEST_INFO_SHA1.length);
+  return codificarBase64(await signer.assinarDigestInfo(di));
 }
 
 /** CFOP da prestação de serviço tributada pelo ISSQN na NFC-e (MOC 7.0 Anexo I, RV I08-150 a I08-170). */
@@ -192,7 +192,7 @@ export interface IdeNfce {
  * Regras da NFC-e sobre a entrada (origem `entrada`, ADR 0011), todas de aplicação obrigatória. Grupos que a NFC-e
  * não tem saem como `grupo_vedado` no caminho da entrada.
  */
-export function conferirNfce(input: NfeInput, ide: IdeNfce, issues: Issues): void {
+export function conferirNfce(input: DadosNfe, ide: IdeNfce, issues: Issues): void {
   const vedado = (path: string, msg: string): void => issues.add(path, 'grupo_vedado', `NFC-e ${msg}`);
   const invalido = (path: string, msg: string): void => issues.add(path, 'campo_invalido', `NFC-e ${msg}`);
 
@@ -416,8 +416,8 @@ export function pagamentoNfce(pag: PagMontado, vNF: Decimal, issues: Issues): vo
       );
     }
     if (c.CNPJ !== undefined) {
-      const r = parseCnpj(c.CNPJ, { path: `${path}.CNPJ` });
-      if (!r.ok) issues.list.push(r.error);
+      const r = lerCnpj(c.CNPJ, { caminho: `${path}.CNPJ` });
+      if (!r.ok) issues.list.push(r.erro);
     }
   });
 }

package/src/build/pl.ts

@@ -6,10 +6,10 @@
  * `camposForaDoPl` aponta cada campo que sumiria em silêncio.
  */
 
-import type { Ambiente, Clock } from '@sinete/core';
-import { UnsupportedError } from '@sinete/core';
-import type { ComplexType, Particle, VigenciaEntry } from '@sinete/schemas';
-import { isComplexType, isElementParticle, isWildcard, selecionarPl } from '@sinete/schemas';
+import type { Ambiente, Relogio } from '@sinete/core';
+import { ErroNaoSuportado } from '@sinete/core';
+import type { ComplexType, EntradaDeVigencia, Particle } from '@sinete/schemas';
+import { ehComplexType, ehElementParticle, ehWildcard, selecionarPl } from '@sinete/schemas';
 import { TNFe_infNFe as Inf010e } from '@sinete/schemas/nfe/PL_010e';
 import { TNFe_infNFe as Inf010f } from '@sinete/schemas/nfe/PL_010f';
 import type { Issues } from '../issues.ts';
@@ -21,32 +21,32 @@ const INF_NFE: Readonly<Record<string, ComplexType>> = {
 };
 
 export interface PlEscolhido {
-  readonly vigencia: VigenciaEntry;
+  readonly vigencia: EntradaDeVigencia;
   readonly infNFe: ComplexType;
 }
 
 /** PL da NF-e vigente para o ambiente no relógio de emissão (ADR 0002, decisão 6). */
-export function escolherPl(ambiente: Ambiente, emissao: Clock): PlEscolhido {
+export function escolherPl(ambiente: Ambiente, emissao: Relogio): PlEscolhido {
   const vigencia = selecionarPl('nfe', ambiente, emissao);
   const infNFe = INF_NFE[vigencia.modulo];
   if (infNFe === undefined) {
     // A tabela de vigências ganhou um PL que este pacote ainda não conhece: falha explícita, nunca tentativa.
-    throw new UnsupportedError(`@sinete/nfe não conhece o módulo ${vigencia.modulo}; atualize o pacote`);
+    throw new ErroNaoSuportado(`@sinete/nfe não conhece o módulo ${vigencia.modulo}; atualize o pacote`);
   }
   return { vigencia, infNFe };
 }
 
 function memberNames(p: Particle, acc: Set<string>): Set<string> {
-  if (isWildcard(p)) acc.add('$any');
-  else if (isElementParticle(p)) acc.add(p.e);
+  if (ehWildcard(p)) acc.add('$any');
+  else if (ehElementParticle(p)) acc.add(p.e);
   else for (const i of p.i) memberNames(i, acc);
   return acc;
 }
 
 function elementTypes(p: Particle, acc: Map<string, ComplexType>): Map<string, ComplexType> {
-  if (isWildcard(p)) return acc;
-  if (isElementParticle(p)) {
-    if (isComplexType(p.t)) acc.set(p.e, p.t);
+  if (ehWildcard(p)) return acc;
+  if (ehElementParticle(p)) {
+    if (ehComplexType(p.t)) acc.set(p.e, p.t);
   } else for (const i of p.i) elementTypes(i, acc);
   return acc;
 }

package/src/build/rejeicoes.ts

@@ -7,11 +7,11 @@
  * dúvida, a nota vai e a SEFAZ decide, porque recusar localmente uma nota que a SEFAZ aceitaria é pior que a rejeição.
  */
 
-import type { ValidationIssue } from '@sinete/core';
+import type { Ocorrencia } from '@sinete/core';
 import type { Issues } from '../issues.ts';
-import type { NfeInput } from '../model.ts';
+import type { DadosNfe } from '../model.ts';
 import type { Instante } from '../time.ts';
-import { formatDh } from '../time.ts';
+import { formatarDh } from '../time.ts';
 
 /**
  * CFOP em que o CST 50 (suspensão) é aceito com destinatário contribuinte isento: conserto ou reparo e remessa para
@@ -40,7 +40,7 @@ const CFOP_CST50_ISENTO: ReadonlySet<string> = new Set([
  * recusado aqui, seja qual for o documento do destinatário. A exceção 2 (emissão antes de 01/07/2016) não alcança nota
  * montada agora.
  */
-export function cstComIsento(input: NfeInput, idDest: string, issues: Issues): void {
+export function cstComIsento(input: DadosNfe, idDest: string, issues: Issues): void {
   const d = input.destinatario;
   if (d?.indIEDest !== '2') return;
   input.itens.forEach((it, n) => {
@@ -60,7 +60,7 @@ export function cstComIsento(input: NfeInput, idDest: string, issues: Issues): v
 
 /** Data (`AAAA-MM-DD`) do instante no deslocamento dado, em minutos. */
 const dataNoFuso = (instante: Instante, offsetMinutes: number): string =>
-  formatDh(instante, offsetMinutes).slice(0, 10);
+  formatarDh(instante, offsetMinutes).slice(0, 10);
 
 /** Brasília (UTC-3), o fuso das SEFAZ, para a comparação de datas que o MOC faz "desconsiderando a hora". */
 const OFFSET_BRASILIA = -180;
@@ -78,7 +78,7 @@ const OFFSET_BRASILIA = -180;
  * "na data da emissão" só vale quando a data local do `dhEmi`, a de Brasília e a de UTC coincidem.
  */
 export function vencimentos(
-  input: NfeInput,
+  input: DadosNfe,
   emissao: { readonly dhEmi: string; readonly instante: Instante },
   issues: Issues,
 ): void {
@@ -107,22 +107,22 @@ const soDocumento = (s: string): string => s.replace(/[^0-9A-Za-z]/g, '').toUppe
  * - e-CPF: o CPF do emitente é o do certificado, senão rejeição 227 (RV F03A).
  *
  * Só compara documento com documento do mesmo tipo: e-CNPJ assinando nota de emitente CPF (ou o contrário) fica para a
- * SEFAZ. O certificado da SEFAZ que a F03 dispensa só assina a nota avulsa, que o `buildNfe` não monta (procEmi 0).
+ * SEFAZ. O certificado da SEFAZ que a F03 dispensa só assina a nota avulsa, que o `montarNfe` não monta (procEmi 0).
  * Devolve as ocorrências (vazio quando confere), com o caminho da entrada.
  */
 export function conferirEmitenteDoCertificado(
-  nfe: NfeInput,
+  nfe: DadosNfe,
   titular: { readonly cnpj?: string | undefined; readonly cpf?: string | undefined },
-): readonly ValidationIssue[] {
+): readonly Ocorrencia[] {
   const e = nfe.emitente;
   if (e.CNPJ !== undefined && titular.cnpj !== undefined) {
     const base = soDocumento(e.CNPJ).slice(0, 8);
     if (base !== soDocumento(titular.cnpj).slice(0, 8)) {
       return [
         {
-          path: 'emitente.CNPJ',
+          caminho: 'emitente.CNPJ',
           code: 'emitente_difere_do_certificado',
-          message: `CNPJ-base ${base} do emitente difere do CNPJ-base do certificado (F03, rejeição 213)`,
+          mensagem: `CNPJ-base ${base} do emitente difere do CNPJ-base do certificado (F03, rejeição 213)`,
           origem: 'entrada',
         },
       ];
@@ -131,9 +131,9 @@ export function conferirEmitenteDoCertificado(
   if (e.CPF !== undefined && titular.cpf !== undefined && soDocumento(e.CPF) !== soDocumento(titular.cpf)) {
     return [
       {
-        path: 'emitente.CPF',
+        caminho: 'emitente.CPF',
         code: 'emitente_difere_do_certificado',
-        message: 'CPF do emitente difere do CPF do certificado (F03A, rejeição 227)',
+        mensagem: 'CPF do emitente difere do CPF do certificado (F03A, rejeição 227)',
         origem: 'entrada',
       },
     ];

package/src/build/values.ts

@@ -6,8 +6,8 @@
 
 import type { DecimalInput, RoundingMode } from '../decimal.ts';
 import { Decimal } from '../decimal.ts';
-import type { DecimalFormat } from '../format.ts';
-import { formatDecimal, formatProblem } from '../format.ts';
+import type { FormatoDecimal } from '../format.ts';
+import { formatarDecimal, problemaDeFormato } from '../format.ts';
 import type { Issues } from '../issues.ts';
 
 /** Famílias de campo com modo de arredondamento próprio (`data/arredondamento.json`). */
@@ -32,23 +32,23 @@ export class Ctx {
   }
 
   /** Entrada opcional; inválida vira ocorrência e `undefined`. */
-  opt(value: DecimalInput | undefined, path: string, format: DecimalFormat): Decimal | undefined {
+  opt(value: DecimalInput | undefined, path: string, format: FormatoDecimal): Decimal | undefined {
     if (value === undefined) return undefined;
     const d = Decimal.tryOf(value);
     if (d === undefined) {
       this.issues.add(path, 'decimal_invalido', 'número decimal inválido (use ponto como separador, sem milhar)');
       return undefined;
     }
-    const problem = formatProblem(d, format);
+    const problem = problemaDeFormato(d, format);
     if (problem !== undefined) {
-      this.issues.add(path, 'decimal_invalido', `${problem} (${format.name})`);
+      this.issues.add(path, 'decimal_invalido', `${problem} (${format.nome})`);
       return undefined;
     }
     return d;
   }
 
   /** Entrada obrigatória; ausente ou inválida vira ocorrência e zero, para que a montagem siga e junte tudo. */
-  req(value: DecimalInput | undefined, path: string, format: DecimalFormat): Decimal {
+  req(value: DecimalInput | undefined, path: string, format: FormatoDecimal): Decimal {
     if (value === undefined) {
       this.issues.add(path, 'campo_obrigatorio', 'campo obrigatório');
       return Decimal.ZERO;
@@ -57,7 +57,7 @@ export class Ctx {
   }
 
   /** Arredonda um valor calculado no formato do campo pelo modo da família. */
-  round(value: Decimal, format: DecimalFormat, familia: Familia): Decimal {
+  round(value: Decimal, format: FormatoDecimal, familia: Familia): Decimal {
     return value.round(format.max, this.modes[familia]);
   }
 
@@ -73,7 +73,7 @@ export class Ctx {
     given: DecimalInput | undefined,
     padrao: Decimal,
     path: string,
-    format: DecimalFormat,
+    format: FormatoDecimal,
     familia: Familia,
   ): Decimal {
     return this.opt(given, path, format) ?? this.round(padrao, format, familia);
@@ -83,7 +83,7 @@ export class Ctx {
     given: DecimalInput | undefined,
     computed: Decimal,
     path: string,
-    format: DecimalFormat,
+    format: FormatoDecimal,
     familia: Familia,
   ): Decimal {
     const r = this.round(computed, format, familia);
@@ -101,15 +101,15 @@ export class Ctx {
   }
 
   /** Texto no formato do campo. */
-  s(value: Decimal, format: DecimalFormat): string {
-    return formatDecimal(value, format);
+  s(value: Decimal, format: FormatoDecimal): string {
+    return formatarDecimal(value, format);
   }
 
   /** Texto opcional: ausente fica ausente, e zero some nos formatos que não aceitam zero. */
-  so(value: Decimal | undefined, format: DecimalFormat): string | undefined {
+  so(value: Decimal | undefined, format: FormatoDecimal): string | undefined {
     if (value === undefined) return undefined;
-    if (format.nonZero && value.isZero()) return undefined;
-    return formatDecimal(value, format);
+    if (format.naoNulo && value.isZero()) return undefined;
+    return formatarDecimal(value, format);
   }
 }
 

package/src/data/arredondamento.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em BuildNfeOptions.arredondamento.",
+  "descricao": "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em MontarNfeOpcoes.arredondamento.",
   "atualizadoEm": "2026-09-26",
   "familias": {
     "produto": {

package/src/data/cstat.json

@@ -23,14 +23,14 @@
   "consumoIndevido": ["656"],
   "dicas": {
     "656": {
-      "probableCause": "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
-      "suggestedFix": "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
-      "source": "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
+      "causaProvavel": "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
+      "comoCorrigir": "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
+      "fonte": "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
     },
     "217": {
-      "probableCause": "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
-      "suggestedFix": "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
-      "source": "MOC 7.0 Anexo I, serviço de consulta protocolo"
+      "causaProvavel": "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
+      "comoCorrigir": "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
+      "fonte": "MOC 7.0 Anexo I, serviço de consulta protocolo"
     }
   }
 }

package/src/data/fusos.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa offsetMinutes.",
+  "descricao": "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa deslocamentoMin.",
   "atualizadoEm": "2026-09-26",
   "fontes": [
     "Lei 11.662/2008 e Lei 12.876/2013 (fusos horários do Brasil; Acre em UTC-5)",

package/src/data/nfce-urls.json

@@ -1,10 +1,10 @@
 {
-  "descricao": "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe BuildNfeOptions.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
+  "descricao": "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe MontarNfeOpcoes.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
   "atualizadoEm": "2026-09-26",
   "fontes": [
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada QR code: https://nfce.encat.org/desenvolvedor/qrcode/ (coletada em 26/09/2026)",
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada para consulta chave, QR Code versão 2.0: https://nfce.encat.org/desenvolvedor/httpnfce-encat-orgconsulte-sua-nota-qr-code-versao-2-0/ (coletada em 26/09/2026)",
-    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do nfceConsultaUrls do @sinete/transport) (coletada em 26/09/2026)",
+    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do urlsConsultaNfce do @sinete/transport) (coletada em 26/09/2026)",
     "MOC 7.0 Anexo I, regras ZX02-20 e ZX03-20; NT 2025.001 v1.03, grupo ZX (campos ZX02 qrCode e ZX03 urlChave)"
   ],
   "qrCode": {

package/src/data/produtor-rural.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o buildNfe monta).",
+  "descricao": "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o montarNfe monta).",
   "atualizadoEm": "2026-09-28",
   "refNFP": {
     "modelo04": {

package/src/data/resp-tec.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em BuildNfeOptions.",
+  "descricao": "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em MontarNfeOpcoes.",
   "atualizadoEm": "2026-09-26",
   "fonte": "NT 2018.005 v1.50 (responsável técnico e CSRT, adesão a critério da UF)",
   "padrao": { "infRespTec": "opcional", "csrt": "opcional" },

package/src/decimal.ts

@@ -12,7 +12,7 @@
  * Qual modo vale para qual campo é dado (`data/arredondamento.json`), não regra espalhada no código.
  */
 
-import { ConfigError } from '@sinete/core';
+import { ErroDeConfiguracao } from '@sinete/core';
 
 export type RoundingMode = 'HALF_EVEN' | 'HALF_UP' | 'DOWN';
 
@@ -44,7 +44,8 @@ export class Decimal {
 
   /** Constrói a partir do coeficiente e da escala (`fromParts(1234n, 2)` = 12.34). */
   static fromParts(coef: bigint, scale: number): Decimal {
-    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE) throw new ConfigError(`escala inválida: ${scale}`);
+    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE)
+      throw new ErroDeConfiguracao(`escala inválida: ${scale}`);
     return new Decimal(coef, scale);
   }
 
@@ -54,7 +55,7 @@ export class Decimal {
    */
   static of(input: DecimalInput): Decimal {
     const d = Decimal.tryOf(input);
-    if (d === undefined) throw new ConfigError(`número decimal inválido: ${JSON.stringify(String(input))}`);
+    if (d === undefined) throw new ErroDeConfiguracao(`número decimal inválido: ${JSON.stringify(String(input))}`);
     return d;
   }
 
@@ -114,7 +115,7 @@ export class Decimal {
   /** Divisão com o resultado arredondado em `scale` casas pelo modo dado. */
   dividedBy(other: DecimalInput, scale: number, mode: RoundingMode): Decimal {
     const o = Decimal.of(other);
-    if (o.coef === 0n) throw new ConfigError('divisão por zero');
+    if (o.coef === 0n) throw new ErroDeConfiguracao('divisão por zero');
     // (a / 10^sa) / (b / 10^sb) = a * 10^(sb + scale + 1 - sa) / b, com uma casa de guarda para o arredondamento.
     const shift = o.scale + scale + 1 - this.scale;
     const num = shift >= 0 ? this.coef * pow10(shift) : this.coef;
@@ -140,7 +141,7 @@ export class Decimal {
 
   /** Arredonda para `scale` casas. Com `scale` maior que a atual, só completa com zeros. */
   round(scale: number, mode: RoundingMode): Decimal {
-    if (!Number.isInteger(scale) || scale < 0) throw new ConfigError(`casas decimais inválidas: ${scale}`);
+    if (!Number.isInteger(scale) || scale < 0) throw new ErroDeConfiguracao(`casas decimais inválidas: ${scale}`);
     if (scale >= this.scale) return new Decimal(this.coef * pow10(scale - this.scale), scale);
     return roundCoef(this.coef, this.scale, scale, mode, false);
   }
@@ -219,13 +220,13 @@ function roundCoef(coef: bigint, from: number, to: number, mode: RoundingMode, s
 }
 
 /** Atalho para `Decimal.of`. */
-export function dec(input: DecimalInput): Decimal {
-  return Decimal.of(input);
+export function dec(valor: DecimalInput): Decimal {
+  return Decimal.of(valor);
 }
 
 /** Soma uma lista (vazia = zero). */
-export function sum(values: Iterable<Decimal>): Decimal {
+export function sum(valores: Iterable<Decimal>): Decimal {
   let acc = Decimal.ZERO;
-  for (const v of values) acc = acc.plus(v);
+  for (const v of valores) acc = acc.plus(v);
   return acc;
 }