@sinete/nfe 0.0.0 → 0.2.0

package/src/build/tributos.ts

@@ -0,0 +1,217 @@
+/**
+ * IPI (O), II (P), PIS (Q, R), COFINS (S, T), ISSQN (U) e ICMS para a UF de destino (NA) do item.
+ */
+
+import type {
+  TIpi,
+  TNFe_infNFe_det_imposto_COFINS,
+  TNFe_infNFe_det_imposto_COFINSST,
+  TNFe_infNFe_det_imposto_ICMSUFDest,
+  TNFe_infNFe_det_imposto_II,
+  TNFe_infNFe_det_imposto_ISSQN,
+  TNFe_infNFe_det_imposto_PIS,
+  TNFe_infNFe_det_imposto_PISST,
+} from '@sinete/schemas/nfe/PL_010f';
+import type { DecimalInput } from '../decimal.ts';
+import { Decimal } from '../decimal.ts';
+import { D0302A04, D1104, D1104V, D1204, D1204V, D1302, D1302_OPC } from '../format.ts';
+import type { IcmsUfDest, ImpostoImportacao, Ipi, Issqn, PisCofins, PisCofinsSt } from '../model.ts';
+import type { Ctx } from './values.ts';
+import { clean, digits } from './values.ts';
+
+type Out = Record<string, string | undefined>;
+
+/** IPI: por alíquota `vBC × pIPI` ou por unidade `qUnid × vUnid` (MOC O10 a O14; RV O14-10, nota *4). */
+export function buildIpi(ctx: Ctx, input: Ipi, vOp: Decimal, path: string): { grupo: TIpi; vIPI: Decimal } {
+  const head: Out = {
+    CNPJProd: input.CNPJProd === undefined ? undefined : input.CNPJProd.replace(/[./-]/g, '').toUpperCase(),
+    cSelo: input.cSelo,
+    qSelo: input.qSelo,
+    cEnq: input.cEnq,
+  };
+  if (!['00', '49', '50', '99'].includes(input.CST)) {
+    return { grupo: { ...clean(head), IPINT: { CST: input.CST } } as unknown as TIpi, vIPI: Decimal.ZERO };
+  }
+  const i = input as {
+    CST: string;
+    vBC?: DecimalInput;
+    pIPI?: DecimalInput;
+    qUnid?: DecimalInput;
+    vUnid?: DecimalInput;
+    vIPI?: DecimalInput;
+  };
+  let trib: Out;
+  let vIPI: Decimal;
+  if (i.qUnid !== undefined || i.vUnid !== undefined) {
+    const qUnid = ctx.req(i.qUnid, `${path}.qUnid`, D1204V);
+    const vUnid = ctx.req(i.vUnid, `${path}.vUnid`, D1104);
+    vIPI = ctx.calc(i.vIPI, qUnid.times(vUnid), `${path}.vIPI`, D1302, 'ipi');
+    trib = { CST: i.CST, qUnid: ctx.s(qUnid, D1204V), vUnid: ctx.s(vUnid, D1104), vIPI: ctx.s(vIPI, D1302) };
+  } else {
+    const pIPI = ctx.req(i.pIPI, `${path}.pIPI`, D0302A04);
+    const vBC = ctx.base(i.vBC, vOp, `${path}.vBC`, D1302, 'ipi');
+    vIPI = ctx.calc(i.vIPI, vBC.percent(pIPI), `${path}.vIPI`, D1302, 'ipi');
+    trib = { CST: i.CST, vBC: ctx.s(vBC, D1302), pIPI: ctx.s(pIPI, D0302A04), vIPI: ctx.s(vIPI, D1302) };
+  }
+  return { grupo: { ...clean(head), IPITrib: clean(trib) } as unknown as TIpi, vIPI };
+}
+
+export function buildIi(
+  ctx: Ctx,
+  input: ImpostoImportacao,
+  path: string,
+): { grupo: TNFe_infNFe_det_imposto_II; vII: Decimal } {
+  const vII = ctx.req(input.vII, `${path}.vII`, D1302);
+  return {
+    grupo: {
+      vBC: ctx.s(ctx.req(input.vBC, `${path}.vBC`, D1302), D1302),
+      vDespAdu: ctx.s(ctx.req(input.vDespAdu, `${path}.vDespAdu`, D1302), D1302),
+      vII: ctx.s(vII, D1302),
+      vIOF: ctx.s(ctx.req(input.vIOF, `${path}.vIOF`, D1302), D1302),
+    },
+    vII,
+  };
+}
+
+/**
+ * PIS ou COFINS (Q02 a Q05, S02 a S05): `valor = vBC × aliquota / 100` ou `qBCProd × vAliqProd` (RV Q09-10, S11-10,
+ * nota *4). `tag` escolhe os nomes do leiaute (`PIS`/`pPIS`/`vPIS` ou `COFINS`/`pCOFINS`/`vCOFINS`).
+ */
+export function buildPisCofins(
+  ctx: Ctx,
+  input: PisCofins,
+  tag: 'PIS' | 'COFINS',
+  path: string,
+): { grupo: TNFe_infNFe_det_imposto_PIS | TNFe_infNFe_det_imposto_COFINS; valor: Decimal } {
+  const p = `p${tag}`;
+  const v = `v${tag}`;
+  const cst = input.CST;
+  if (!('vBC' in input) && !('qBCProd' in input)) {
+    return { grupo: { [`${tag}NT`]: { CST: cst } } as unknown as TNFe_infNFe_det_imposto_PIS, valor: Decimal.ZERO };
+  }
+  const i = input as {
+    CST: string;
+    vBC?: DecimalInput;
+    aliquota?: DecimalInput;
+    qBCProd?: DecimalInput;
+    vAliqProd?: DecimalInput;
+    valor?: DecimalInput;
+  };
+  let body: Out;
+  let valor: Decimal;
+  if (i.qBCProd !== undefined) {
+    const q = ctx.req(i.qBCProd, `${path}.qBCProd`, D1204V);
+    const a = ctx.req(i.vAliqProd, `${path}.vAliqProd`, D1104V);
+    valor = ctx.calc(i.valor, q.times(a), `${path}.valor`, D1302, 'pisCofins');
+    body = { CST: cst, qBCProd: ctx.s(q, D1204V), vAliqProd: ctx.s(a, D1104V), [v]: ctx.s(valor, D1302) };
+  } else {
+    const vBC = ctx.req(i.vBC, `${path}.vBC`, D1302);
+    const a = ctx.req(i.aliquota, `${path}.aliquota`, D0302A04);
+    valor = ctx.calc(i.valor, vBC.percent(a), `${path}.valor`, D1302, 'pisCofins');
+    body = { CST: cst, vBC: ctx.s(vBC, D1302), [p]: ctx.s(a, D0302A04), [v]: ctx.s(valor, D1302) };
+  }
+  const nome = cst === '01' || cst === '02' ? 'Aliq' : cst === '03' ? 'Qtde' : 'Outr';
+  return { grupo: { [`${tag}${nome}`]: body } as unknown as TNFe_infNFe_det_imposto_PIS, valor };
+}
+
+/** PIS ST ou COFINS ST (R, T). */
+export function buildPisCofinsSt(
+  ctx: Ctx,
+  input: PisCofinsSt,
+  tag: 'PIS' | 'COFINS',
+  path: string,
+): { grupo: TNFe_infNFe_det_imposto_PISST | TNFe_infNFe_det_imposto_COFINSST; valor: Decimal; soma: boolean } {
+  let body: Out;
+  let valor: Decimal;
+  if (input.qBCProd !== undefined) {
+    const q = ctx.req(input.qBCProd, `${path}.qBCProd`, D1204);
+    const a = ctx.req(input.vAliqProd, `${path}.vAliqProd`, D1104);
+    valor = ctx.calc(input.valor, q.times(a), `${path}.valor`, D1302, 'pisCofins');
+    body = { qBCProd: ctx.s(q, D1204), vAliqProd: ctx.s(a, D1104) };
+  } else {
+    // No XSD o vBC do PISST é TDec_1302Opc (sem zero) e o do COFINSST é TDec_1302 (aceita zero).
+    const fBC = tag === 'PIS' ? D1302_OPC : D1302;
+    const vBC = ctx.req(input.vBC, `${path}.vBC`, fBC);
+    const a = ctx.req(input.aliquota, `${path}.aliquota`, D0302A04);
+    valor = ctx.calc(input.valor, vBC.percent(a), `${path}.valor`, D1302, 'pisCofins');
+    body = { vBC: ctx.s(vBC, fBC), [`p${tag}`]: ctx.s(a, D0302A04) };
+  }
+  body[`v${tag}`] = ctx.s(valor, D1302);
+  body[`indSoma${tag}ST`] = input.indSoma;
+  return { grupo: clean(body) as unknown as TNFe_infNFe_det_imposto_PISST, valor, soma: input.indSoma === '1' };
+}
+
+/** ISSQN: `vISSQN = vBC × vAliq / 100` (RV U04-10, nota *4). */
+export function buildIssqn(
+  ctx: Ctx,
+  input: Issqn,
+  path: string,
+): { grupo: TNFe_infNFe_det_imposto_ISSQN; vBC: Decimal; vISSQN: Decimal; opcionais: Record<string, Decimal> } {
+  const vBC = ctx.req(input.vBC, `${path}.vBC`, D1302);
+  const vAliq = ctx.req(input.vAliq, `${path}.vAliq`, D0302A04);
+  const vISSQN = ctx.calc(input.vISSQN, vBC.percent(vAliq), `${path}.vISSQN`, D1302, 'issqn');
+  const opcionais: Record<string, Decimal> = {};
+  const opt = (k: 'vDeducao' | 'vOutro' | 'vDescIncond' | 'vDescCond' | 'vISSRet'): string | undefined => {
+    const d = ctx.opt(input[k], `${path}.${k}`, D1302);
+    if (d !== undefined) opcionais[k] = d;
+    return ctx.so(d, D1302_OPC);
+  };
+  return {
+    grupo: clean({
+      vBC: ctx.s(vBC, D1302),
+      vAliq: ctx.s(vAliq, D0302A04),
+      vISSQN: ctx.s(vISSQN, D1302),
+      cMunFG: input.cMunFG,
+      cListServ: input.cListServ,
+      vDeducao: opt('vDeducao'),
+      vOutro: opt('vOutro'),
+      vDescIncond: opt('vDescIncond'),
+      vDescCond: opt('vDescCond'),
+      vISSRet: opt('vISSRet'),
+      indISS: input.indISS,
+      cServico: input.cServico,
+      cMun: input.cMun,
+      cPais: input.cPais === undefined ? undefined : digits(input.cPais),
+      nProcesso: input.nProcesso,
+      indIncentivo: input.indIncentivo,
+    }) as TNFe_infNFe_det_imposto_ISSQN,
+    vBC,
+    vISSQN,
+    opcionais,
+  };
+}
+
+/** ICMS para a UF de destino (NA): valores informados; defaults de partilha 100% e remetente zero desde 2019. */
+export function buildIcmsUfDest(
+  ctx: Ctx,
+  input: IcmsUfDest,
+  path: string,
+): { grupo: TNFe_infNFe_det_imposto_ICMSUFDest; vFCPUFDest: Decimal; vICMSUFDest: Decimal; vICMSUFRemet: Decimal } {
+  const pFCPUFDest = ctx.opt(input.pFCPUFDest, `${path}.pFCPUFDest`, D0302A04);
+  const vFCPUFDest = ctx.opt(input.vFCPUFDest, `${path}.vFCPUFDest`, D1302);
+  if (pFCPUFDest !== undefined && vFCPUFDest === undefined) {
+    ctx.issues.add(`${path}.vFCPUFDest`, 'campo_obrigatorio', 'pFCPUFDest informado exige vFCPUFDest');
+  }
+  const vICMSUFDest = ctx.req(input.vICMSUFDest, `${path}.vICMSUFDest`, D1302);
+  const vICMSUFRemet = ctx.opt(input.vICMSUFRemet, `${path}.vICMSUFRemet`, D1302) ?? Decimal.ZERO;
+  const vBCFCPUFDest = ctx.opt(input.vBCFCPUFDest, `${path}.vBCFCPUFDest`, D1302);
+  return {
+    grupo: clean({
+      vBCUFDest: ctx.s(ctx.req(input.vBCUFDest, `${path}.vBCUFDest`, D1302), D1302),
+      vBCFCPUFDest: ctx.so(vBCFCPUFDest, D1302),
+      pFCPUFDest: ctx.so(pFCPUFDest, D0302A04),
+      pICMSUFDest: ctx.s(ctx.req(input.pICMSUFDest, `${path}.pICMSUFDest`, D0302A04), D0302A04),
+      pICMSInter: input.pICMSInter,
+      pICMSInterPart: ctx.s(
+        ctx.opt(input.pICMSInterPart, `${path}.pICMSInterPart`, D0302A04) ?? Decimal.HUNDRED,
+        D0302A04,
+      ),
+      vFCPUFDest: ctx.so(vFCPUFDest, D1302),
+      vICMSUFDest: ctx.s(vICMSUFDest, D1302),
+      vICMSUFRemet: ctx.s(vICMSUFRemet, D1302),
+    }) as TNFe_infNFe_det_imposto_ICMSUFDest,
+    vFCPUFDest: vFCPUFDest ?? Decimal.ZERO,
+    vICMSUFDest,
+    vICMSUFRemet,
+  };
+}

package/src/build/values.ts

@@ -0,0 +1,126 @@
+/**
+ * Contexto de uma montagem: coleta ocorrências e converte as entradas numéricas conferindo cada uma contra o formato do
+ * campo no leiaute. As contas usam o valor já na precisão do XML (uma alíquota com 5 casas é recusada, não
+ * arredondada em silêncio), para que o que vai no XML seja exatamente o que entrou na conta.
+ */
+
+import type { DecimalInput, RoundingMode } from '../decimal.ts';
+import { Decimal } from '../decimal.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`). */
+export type Familia = 'produto' | 'icms' | 'ipi' | 'pisCofins' | 'issqn' | 'ibsCbs';
+
+/** Tolerância das regras de validação de valor (MOC 7.0 Anexo I, nota (*4); NT 2025.002, observações das RV UB). */
+export const TOLERANCIA: Decimal = Decimal.of('0.01');
+
+export class Ctx {
+  readonly issues: Issues;
+  readonly modes: Readonly<Record<Familia, RoundingMode>>;
+  /**
+   * Confere o valor informado contra o calculado. Desligado na NF-e complementar e na de ajuste (finNFe 2 e 3), cujos
+   * valores complementam outra nota e não seguem a conta do item (MOC 7.0 Anexo I, RV I11: "Se NF-e Normal").
+   */
+  readonly conferir: boolean;
+
+  constructor(issues: Issues, modes: Readonly<Record<Familia, RoundingMode>>, conferir = true) {
+    this.issues = issues;
+    this.modes = modes;
+    this.conferir = conferir;
+  }
+
+  /** Entrada opcional; inválida vira ocorrência e `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 = problemaDeFormato(d, format);
+    if (problem !== undefined) {
+      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: FormatoDecimal): Decimal {
+    if (value === undefined) {
+      this.issues.add(path, 'campo_obrigatorio', 'campo obrigatório');
+      return Decimal.ZERO;
+    }
+    return this.opt(value, path, format) ?? Decimal.ZERO;
+  }
+
+  /** Arredonda um valor calculado no formato do campo pelo modo da família. */
+  round(value: Decimal, format: FormatoDecimal, familia: Familia): Decimal {
+    return value.round(format.max, this.modes[familia]);
+  }
+
+  /**
+   * Valor derivado: sem valor informado, o calculado (arredondado); com valor informado, o informado, conferido
+   * contra o calculado com a tolerância das regras de validação.
+   */
+  /**
+   * Base de cálculo: a informada prevalece sem conferência (a base legal varia por operação, UF e regime); o padrão
+   * só vale quando nada veio.
+   */
+  base(
+    given: DecimalInput | undefined,
+    padrao: Decimal,
+    path: string,
+    format: FormatoDecimal,
+    familia: Familia,
+  ): Decimal {
+    return this.opt(given, path, format) ?? this.round(padrao, format, familia);
+  }
+
+  calc(
+    given: DecimalInput | undefined,
+    computed: Decimal,
+    path: string,
+    format: FormatoDecimal,
+    familia: Familia,
+  ): Decimal {
+    const r = this.round(computed, format, familia);
+    if (given === undefined) return r;
+    const g = this.opt(given, path, format);
+    if (g === undefined) return r;
+    if (this.conferir && g.minus(r).abs().gt(TOLERANCIA)) {
+      this.issues.add(
+        path,
+        'valor_divergente',
+        `valor informado difere do calculado (${r.toFixed(format.max)}) em mais de ${TOLERANCIA.toString()}`,
+      );
+    }
+    return g;
+  }
+
+  /** Texto no formato do campo. */
+  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: FormatoDecimal): string | undefined {
+    if (value === undefined) return undefined;
+    if (format.naoNulo && value.isZero()) return undefined;
+    return formatarDecimal(value, format);
+  }
+}
+
+/** Remove as chaves com `undefined` (o serializer ignora, mas o objeto devolvido fica limpo e comparável). */
+export function clean<T extends object>(o: T): T {
+  const out: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(o)) if (v !== undefined) out[k] = v;
+  return out as T;
+}
+
+/** Só dígitos (tira máscara de CEP, CNPJ numérico, telefone). */
+export function digits(s: string): string {
+  return s.replace(/\D/g, '');
+}

package/src/data/arredondamento.json

@@ -0,0 +1,30 @@
+{
+  "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": {
+      "modo": "HALF_UP",
+      "fonte": "MOC 7.0 Anexo I, nota (*4): o produto de multiplicações arredonda em 2 casas, com tolerância de R$ 0,01; o modo não é fixado. vProd = qCom x vUnCom (I11)."
+    },
+    "icms": {
+      "modo": "HALF_UP",
+      "fonte": "MOC 7.0 Anexo I, nota (*4) das regras N17, N16a, N16c, N23d: 2 casas, tolerância de R$ 0,01, modo não fixado."
+    },
+    "ipi": {
+      "modo": "HALF_UP",
+      "fonte": "MOC 7.0 Anexo I, nota (*4): 2 casas, tolerância de R$ 0,01."
+    },
+    "pisCofins": {
+      "modo": "HALF_UP",
+      "fonte": "MOC 7.0 Anexo I, nota (*4): 2 casas, tolerância de R$ 0,01."
+    },
+    "issqn": {
+      "modo": "HALF_UP",
+      "fonte": "MOC 7.0 Anexo I, nota (*4): 2 casas, tolerância de R$ 0,01."
+    },
+    "ibsCbs": {
+      "modo": "HALF_EVEN",
+      "fonte": "NT 2025.002 v1.51, RV UB35-10 e seguintes (tolerância de 0,01) e ADR 0007 (a Calculadora da RFB arredonda em HALF_EVEN)."
+    }
+  }
+}

package/src/data/cstat.json

@@ -0,0 +1,36 @@
+{
+  "descricao": "Códigos de status de sucesso e de processamento (MOC 7.0 Anexo I, tabela 4.4.1) e os códigos que o @sinete/nfe trata de forma própria. Rejeições e denegações com mensagem oficial estão no @sinete/rejeicoes; aqui fica só o desfecho de cada código por serviço.",
+  "fonte": "MOC 7.0 Anexo I, tabela 4.4.1 (códigos de sucesso) e 4.4.2 (denegação 301, 302, 303); NT 2014.002 (Distribuição DF-e, 137 e 138); NT 2011.004 (lote em processamento, 105); MOC 7.0 Anexo I, consulta protocolo J03 a J06 (561, 562 e 613: a numeração da chave consultada tem outra NF-e)",
+  "atualizadoEm": "2026-09-26",
+  "autorizada": ["100", "150"],
+  "denegada": ["110", "301", "302", "303"],
+  "cancelada": ["101", "151", "155"],
+  "loteRecebido": ["103"],
+  "loteProcessado": ["104"],
+  "loteEmProcessamento": ["105"],
+  "loteNaoLocalizado": ["106"],
+  "servicoEmOperacao": ["107"],
+  "inutilizacaoHomologada": ["102"],
+  "eventoRegistrado": ["135", "136", "155"],
+  "loteEventoProcessado": ["128"],
+  "cadastroEncontrado": ["111", "112"],
+  "distribuicaoNenhumDocumento": ["137"],
+  "distribuicaoDocumentos": ["138"],
+  "duplicidade": ["204"],
+  "duplicidadeChaveDiferente": ["539"],
+  "naoConsta": ["217"],
+  "outraNfeNoNumero": ["561", "562", "613"],
+  "consumoIndevido": ["656"],
+  "dicas": {
+    "656": {
+      "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": {
+      "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

@@ -0,0 +1,17 @@
+{
+  "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)",
+    "Decreto 9.772/2019 (fim do horário de verão)"
+  ],
+  "padrao": -180,
+  "ufs": {
+    "AC": -300,
+    "AM": -240,
+    "MS": -240,
+    "MT": -240,
+    "RO": -240,
+    "RR": -240
+  }
+}

package/src/data/nfce-urls.json

@@ -0,0 +1,170 @@
+{
+  "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 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": {
+    "producao": {
+      "AC": [{ "url": "http://www.sefaznet.ac.gov.br/nfce/qrcode" }],
+      "AL": [{ "url": "http://nfce.sefaz.al.gov.br/QRCode/consultarNFCe.jsp" }],
+      "AP": [{ "url": "https://www.sefaz.ap.gov.br/nfce/nfcep.php" }],
+      "AM": [
+        { "url": null, "nota": "tabela do ENCAT sem protocolo: sistemas.sefaz.am.gov.br/nfceweb/consultarNFCe.jsp" }
+      ],
+      "BA": [{ "url": "http://nfe.sefaz.ba.gov.br/servicos/nfce/qrcode.aspx" }],
+      "CE": [{ "url": "http://nfce.sefaz.ce.gov.br/pages/ShowNFCe.html" }],
+      "DF": [{ "url": "http://www.fazenda.df.gov.br/nfce/qrcode" }],
+      "ES": [{ "url": "http://app.sefaz.es.gov.br/ConsultaNFCe/" }],
+      "GO": [
+        { "url": "http://nfe.sefaz.go.gov.br/nfeweb/sites/nfce/danfeNFCe" },
+        { "url": "https://nfeweb.sefaz.go.gov.br/nfeweb/sites/nfce/danfeNFCe", "desde": "2025-06-16" }
+      ],
+      "MA": [{ "url": null, "nota": "tabela do ENCAT sem protocolo: nfce.sefaz.ma.gov.br/portal/consultarNFCe.jsp" }],
+      "MT": [{ "url": "http://www.sefaz.mt.gov.br/nfce/consultanfce" }],
+      "MS": [{ "url": "http://www.dfe.ms.gov.br/nfce/qrcode" }],
+      "MG": [
+        { "url": "https://nfce.fazenda.mg.gov.br/portalnfce/sistema/qrcode.xhtml" },
+        { "url": "https://portalsped.fazenda.mg.gov.br/portalnfce/sistema/qrcode.xhtml", "desde": "2022-03-21" }
+      ],
+      "PA": [{ "url": "https://appnfc.sefa.pa.gov.br/portal/view/consultas/nfce/nfceForm.seam" }],
+      "PB": [{ "url": "http://www.sefaz.pb.gov.br/nfce" }],
+      "PR": [{ "url": "http://www.fazenda.pr.gov.br/nfce/qrcode" }],
+      "PE": [{ "url": "http://nfce.sefaz.pe.gov.br/nfce/consulta" }],
+      "PI": [{ "url": "http://www.sefaz.pi.gov.br/nfce/qrcode" }],
+      "RJ": [
+        { "url": "http://www4.fazenda.rj.gov.br/consultaNFCe/QRCode" },
+        { "url": "https://consultadfe.fazenda.rj.gov.br/consultaNFCe/QRCode", "desde": "2023-12-19" }
+      ],
+      "RN": [
+        { "url": "http://nfce.set.rn.gov.br/consultarNFCe.aspx" },
+        { "url": "https://nfce.sefaz.rn.gov.br/consultarNFCe.aspx", "desde": "2026-05-25" }
+      ],
+      "RS": [{ "url": "https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx" }],
+      "RO": [{ "url": "http://www.nfce.sefin.ro.gov.br/consultanfce/consulta.jsp" }],
+      "RR": [{ "url": "https://www.sefaz.rr.gov.br/nfce/servlet/qrcode" }],
+      "SC": [{ "url": "https://sat.sef.sc.gov.br/nfce/consulta" }],
+      "SP": [
+        {
+          "url": "https://www.nfce.fazenda.sp.gov.br/NFCeConsultaPublica/Paginas/ConsultaQRCode.aspx",
+          "nota": "a tabela do ENCAT lista também https://www.nfce.fazenda.sp.gov.br/qrcode"
+        }
+      ],
+      "SE": [{ "url": "http://www.nfce.se.gov.br/nfce/qrcode" }],
+      "TO": [{ "url": "http://www.sefaz.to.gov.br/nfce/qrcode" }]
+    },
+    "homologacao": {
+      "AC": [{ "url": "http://www.hml.sefaznet.ac.gov.br/nfce/qrcode" }],
+      "AL": [{ "url": "http://nfce.sefaz.al.gov.br/QRCode/consultarNFCe.jsp" }],
+      "AP": [{ "url": "https://www.sefaz.ap.gov.br/nfcehml/nfce.php" }],
+      "AM": [
+        { "url": null, "nota": "tabela do ENCAT sem protocolo: homnfce.sefaz.am.gov.br/nfceweb/consultarNFCe.jsp" }
+      ],
+      "BA": [{ "url": "http://hnfe.sefaz.ba.gov.br/servicos/nfce/qrcode.aspx" }],
+      "CE": [{ "url": "http://nfceh.sefaz.ce.gov.br/pages/ShowNFCe.html" }],
+      "DF": [{ "url": "http://www.fazenda.df.gov.br/nfce/qrcode" }],
+      "ES": [{ "url": "http://homologacao.sefaz.es.gov.br/ConsultaNFCe/" }],
+      "GO": [
+        { "url": "http://homolog.sefaz.go.gov.br/nfeweb/sites/nfce/danfeNFCe" },
+        { "url": "https://nfewebhomolog.sefaz.go.gov.br/nfeweb/sites/nfce/danfeNFCe", "desde": "2025-06-16" }
+      ],
+      "MA": [
+        { "url": null, "nota": "tabela do ENCAT sem protocolo: homologacao.sefaz.ma.gov.br/portal/consultarNFCe.jsp" }
+      ],
+      "MT": [{ "url": "http://homologacao.sefaz.mt.gov.br/nfce/consultanfce" }],
+      "MS": [{ "url": "http://www.dfe.ms.gov.br/nfce/qrcode" }],
+      "MG": [
+        { "url": "https://nfce.fazenda.mg.gov.br/portalnfce/sistema/qrcode.xhtml" },
+        { "url": "https://portalsped.fazenda.mg.gov.br/portalnfce/sistema/qrcode.xhtml", "desde": "2022-03-21" }
+      ],
+      "PA": [{ "url": "https://appnfc.sefa.pa.gov.br/portal-homologacao/view/consultas/nfce/nfceForm.seam" }],
+      "PB": [{ "url": "http://www.sefaz.pb.gov.br/nfcehom" }],
+      "PR": [{ "url": "http://www.fazenda.pr.gov.br/nfce/qrcode" }],
+      "PE": [{ "url": "http://nfcehomolog.sefaz.pe.gov.br/nfce/consulta" }],
+      "PI": [{ "url": "http://www.sefaz.pi.gov.br/nfce/qrcode" }],
+      "RJ": [
+        { "url": "http://www4.fazenda.rj.gov.br/consultaNFCe/QRCode" },
+        { "url": "https://consultadfe.fazenda.rj.gov.br/consultaNFCe/QRCode", "desde": "2023-12-19" }
+      ],
+      "RN": [
+        { "url": "http://hom.nfce.set.rn.gov.br/consultarNFCe.aspx" },
+        { "url": "https://hom.nfce.sefaz.rn.gov.br/consultarNFCe.aspx", "desde": "2026-05-25" }
+      ],
+      "RS": [{ "url": "https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx" }],
+      "RO": [{ "url": "http://www.nfce.sefin.ro.gov.br/consultanfce/consulta.jsp" }],
+      "RR": [{ "url": "http://200.174.88.103:8080/nfce/servlet/qrcode" }],
+      "SC": [{ "url": "https://hom.sat.sef.sc.gov.br/nfce/consulta" }],
+      "SP": [
+        {
+          "url": "https://www.homologacao.nfce.fazenda.sp.gov.br/NFCeConsultaPublica/Paginas/ConsultaQRCode.aspx",
+          "nota": "a tabela do ENCAT lista também https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode"
+        }
+      ],
+      "SE": [{ "url": "http://www.hom.nfe.se.gov.br/nfce/qrcode" }],
+      "TO": [{ "url": "http://homologacao.sefaz.to.gov.br/nfce/qrcode" }]
+    }
+  },
+  "urlChave": {
+    "producao": {
+      "AC": [{ "url": "www.sefaznet.ac.gov.br/nfce/consulta" }],
+      "AL": [{ "url": "www.sefaz.al.gov.br/nfce/consulta" }],
+      "AP": [{ "url": "www.sefaz.ap.gov.br/nfce/consulta" }],
+      "AM": [{ "url": "www.sefaz.am.gov.br/nfce/consulta" }],
+      "BA": [{ "url": "www.sefaz.ba.gov.br/nfce/consulta" }],
+      "CE": [{ "url": "www.sefaz.ce.gov.br/nfce/consulta" }],
+      "DF": [{ "url": "www.fazenda.df.gov.br/nfce/consulta" }],
+      "ES": [{ "url": "www.sefaz.es.gov.br/nfce/consulta" }],
+      "GO": [{ "url": "www.sefaz.go.gov.br/nfce/consulta" }],
+      "MA": [{ "url": "www.sefaz.ma.gov.br/nfce/consulta" }],
+      "MT": [{ "url": "http://www.sefaz.mt.gov.br/nfce/consultanfce" }],
+      "MS": [{ "url": "www.dfe.ms.gov.br/nfce/consulta" }],
+      "MG": [{ "url": "https://portalsped.fazenda.mg.gov.br/portalnfce" }],
+      "PA": [{ "url": "www.sefa.pa.gov.br/nfce/consulta" }],
+      "PB": [{ "url": "www.receita.pb.gov.br/nfce/consulta" }],
+      "PR": [{ "url": "http://www.fazenda.pr.gov.br/nfce/consulta" }],
+      "PE": [{ "url": "nfce.sefaz.pe.gov.br/nfce/consulta" }],
+      "PI": [{ "url": "www.sefaz.pi.gov.br/nfce/consulta" }],
+      "RJ": [{ "url": "www.fazenda.rj.gov.br/nfce/consulta" }],
+      "RN": [{ "url": "www.set.rn.gov.br/nfce/consulta" }],
+      "RS": [{ "url": "www.sefaz.rs.gov.br/nfce/consulta" }],
+      "RO": [{ "url": "www.sefin.ro.gov.br/nfce/consulta" }],
+      "RR": [{ "url": "www.sefaz.rr.gov.br/nfce/consulta" }],
+      "SC": [{ "url": "https://sat.sef.sc.gov.br/nfce/consulta" }],
+      "SP": [{ "url": "https://www.nfce.fazenda.sp.gov.br/consulta" }],
+      "SE": [{ "url": "http://www.nfce.se.gov.br/nfce/consulta" }],
+      "TO": [{ "url": "www.sefaz.to.gov.br/nfce/consulta" }]
+    },
+    "homologacao": {
+      "AC": [{ "url": "www.sefaznet.ac.gov.br/nfce/consulta" }],
+      "AL": [{ "url": "www.sefaz.al.gov.br/nfce/consulta" }],
+      "AP": [{ "url": "www.sefaz.ap.gov.br/nfce/consulta" }],
+      "AM": [{ "url": "www.sefaz.am.gov.br/nfce/consulta" }],
+      "BA": [{ "url": "http://hinternet.sefaz.ba.gov.br/nfce/consulta" }],
+      "CE": [{ "url": "www.sefaz.ce.gov.br/nfce/consulta" }],
+      "DF": [{ "url": "www.fazenda.df.gov.br/nfce/consulta" }],
+      "ES": [{ "url": "www.sefaz.es.gov.br/nfce/consulta" }],
+      "GO": [{ "url": "www.sefaz.go.gov.br/nfce/consulta" }],
+      "MA": [{ "url": "www.sefaz.ma.gov.br/nfce/consulta" }],
+      "MT": [{ "url": "http://homologacao.sefaz.mt.gov.br/nfce/consultanfce" }],
+      "MS": [{ "url": "www.dfe.ms.gov.br/nfce/consulta" }],
+      "MG": [{ "url": "https://hportalsped.fazenda.mg.gov.br/portalnfce" }],
+      "PA": [{ "url": "www.sefa.pa.gov.br/nfce/consulta" }],
+      "PB": [{ "url": "www.receita.pb.gov.br/nfcehom" }],
+      "PR": [{ "url": "http://www.fazenda.pr.gov.br/nfce/consulta" }],
+      "PE": [{ "url": "nfce.sefaz.pe.gov.br/nfce/consulta" }],
+      "PI": [{ "url": "www.sefaz.pi.gov.br/nfce/consulta" }],
+      "RJ": [{ "url": "www.fazenda.rj.gov.br/nfce/consulta" }],
+      "RN": [{ "url": "www.set.rn.gov.br/nfce/consulta" }],
+      "RS": [{ "url": "www.sefaz.rs.gov.br/nfce/consulta" }],
+      "RO": [{ "url": "www.sefin.ro.gov.br/nfce/consulta" }],
+      "RR": [{ "url": "www.sefaz.rr.gov.br/nfce/consulta" }],
+      "SC": [{ "url": "https://hom.sat.sef.sc.gov.br/nfce/consulta" }],
+      "SP": [{ "url": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta" }],
+      "SE": [{ "url": "http://www.hom.nfe.se.gov.br/nfce/consulta" }],
+      "TO": [{ "url": "http://homologacao.sefaz.to.gov.br/nfce/consulta.jsf" }]
+    }
+  }
+}

package/src/data/produtor-rural.json

@@ -0,0 +1,17 @@
+{
+  "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": {
+      "vedadaDesde": "2601",
+      "fonte": "Ajuste SINIEF 10/2022 (extinção da nota fiscal de produtor modelo 4, com prazos prorrogados até 05/01/2026) e avisos das SEFAZ (RS e SP: fim do talão em 05/01/2026)."
+    },
+    "ufs": {}
+  },
+  "series": {
+    "cpf": [920, 969],
+    "fonte": "MOC 7.0 Anexo I, RV B07 e BA02-30: séries 920 a 969 reservadas à NF-e emitida por pessoa física (CPF).",
+    "cnpj": [0, 889],
+    "fonteCnpj": "MOC 7.0 Anexo I, RV C02-30 (emitente CNPJ: séries 0 a 909, rejeição 503) e B26-10 (emissão pelo contribuinte, procEmi 0: séries 0 a 889 ou 920 a 969, rejeição 244): as duas juntas deixam 0 a 889. A NT 2026.001 v1.02b (PAA, produção em 05/10/2026) abre 980 a 989 na C02-30 e mantém a B26-10, então a faixa continua 0 a 889."
+  }
+}

package/src/data/reforma.json

@@ -0,0 +1,6 @@
+{
+  "descricao": "Parâmetros da reforma tributária no total do item e da nota. vItemSomaTributosDesde: a partir desta data do fato gerador (Brasília), vItem soma vIBS, vCBS, vIS e os totais monofásicos; antes dela, não soma (exceção de 2025 e 2026).",
+  "atualizadoEm": "2026-09-26",
+  "vItemSomaTributosDesde": "2027-01-01",
+  "fonte": "NT 2025.002 v1.51, RV VB01-10 e VB01-20, Exceção 1: em 2025 e 2026 não somar vIBS, vCBS, vIS, vTotIBSMonoItem e vTotCBSMonoItem."
+}

package/src/data/resp-tec.json

@@ -0,0 +1,13 @@
+{
+  "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" },
+  "ufs": {
+    "PR": {
+      "csrt": { "homologacao": "2025-03-02", "producao": "2025-09-15" },
+      "infRespTec": { "homologacao": "2025-03-02", "producao": "2025-09-15" },
+      "fonte": "SEFAZ-PR, NT 2018.005 v1.50: CSRT obrigatório na NF-e em homologação desde 02/03/2025 e em produção desde 15/09/2025 (aviso da SEFAZ-PR, reproduzido em https://inventti.com.br/nf-e-nfc-e-nt-2018-005-versao-1-50-prorroga-regras-de-validacao-para-uf-do-parana/)."
+    }
+  }
+}