ghinfe 0.6.0

package/src/nfse/NFSeMunicipioResolver.js

@@ -0,0 +1,42 @@
+import { NFSE_MUNICIPIOS } from './constants/municipios.js';
+import { GhinfeError } from '../errors/GhinfeError.js';
+
+/**
+ * Resolve endpoint NFS-e por código IBGE do município.
+ */
+export class NFSeMunicipioResolver {
+  /** @type {Record<string, object>} */
+  static #custom = {};
+
+  /**
+   * Registra endpoint customizado para um município.
+   * @param {string} codigoMunicipio IBGE 7 dígitos
+   * @param {{ nome?: string, homologacao: string, producao: string, layout?: string }} config
+   */
+  static registrar(codigoMunicipio, config) {
+    this.#custom[codigoMunicipio] = config;
+  }
+
+  /**
+   * @param {string} codigoMunicipio
+   * @param {number} [ambiente] 1=Produção, 2=Homologação
+   */
+  static resolver(codigoMunicipio, ambiente = 2) {
+    const config = this.#custom[codigoMunicipio] ?? NFSE_MUNICIPIOS[codigoMunicipio];
+
+    if (!config) {
+      throw new GhinfeError(
+        `Endpoint NFS-e não configurado para município ${codigoMunicipio}. Use NFSeMunicipioResolver.registrar()`,
+        'NFSE_MUNICIPIO_NOT_FOUND'
+      );
+    }
+
+    const url = ambiente === 1 ? config.producao : config.homologacao;
+    return { url, layout: config.layout ?? 'abrasf', nome: config.nome };
+  }
+
+  /** @returns {string[]} */
+  static listarMunicipios() {
+    return [...new Set([...Object.keys(NFSE_MUNICIPIOS), ...Object.keys(this.#custom)])];
+  }
+}

package/src/nfse/builders/NFSeEventoXmlBuilder.js

@@ -0,0 +1,92 @@
+import { create } from 'xmlbuilder2';
+import { NFSE_NAMESPACE } from '../constants/municipios.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+
+/**
+ * XML de cancelamento e substituição de NFS-e (padrão ABRASF 2.04).
+ */
+export class NFSeEventoXmlBuilder {
+  /**
+   * @param {{
+   *   numeroNfse: string,
+   *   cnpjPrestador: string,
+   *   inscricaoMunicipal: string,
+   *   codigoMunicipio: string,
+   *   codigoCancelamento?: string,
+   * }} dados
+   */
+  buildCancelamento(dados) {
+    if (!dados.numeroNfse) throw new GhinfeError('numeroNfse é obrigatório', 'NFSE_CANCEL_NUMERO');
+    if (!dados.cnpjPrestador) throw new GhinfeError('cnpjPrestador é obrigatório', 'NFSE_CANCEL_CNPJ');
+
+    const id = `Cancelamento_${dados.numeroNfse}`;
+    const doc = create({ version: '1.0', encoding: 'UTF-8' })
+      .ele('CancelarNfseEnvio', { xmlns: NFSE_NAMESPACE })
+      .ele('Pedido')
+      .ele('InfPedidoCancelamento', { Id: id });
+
+    const inf = doc;
+    const ident = inf.ele('IdentificacaoNfse');
+    ident.ele('Numero').txt(String(dados.numeroNfse)).up();
+    ident.ele('Cnpj').txt(dados.cnpjPrestador.replace(/\D/g, '')).up();
+    ident.ele('InscricaoMunicipal').txt(dados.inscricaoMunicipal).up();
+    ident.ele('CodigoMunicipio').txt(dados.codigoMunicipio).up();
+    ident.up();
+    inf.ele('CodigoCancelamento').txt(dados.codigoCancelamento ?? '2').up();
+
+    return doc.end({ prettyPrint: false, headless: false });
+  }
+
+  /**
+   * Substituição = pedido de cancelamento da NFS-e substituída + novo RPS.
+   * O XML do novo RPS deve ser passado já montado (GerarNfseEnvio / lote).
+   *
+   * @param {{
+   *   numeroNfseSubstituida: string,
+   *   cnpjPrestador: string,
+   *   inscricaoMunicipal: string,
+   *   codigoMunicipio: string,
+   *   codigoCancelamento?: string,
+   *   xmlRpsSubstituto: string,
+   * }} dados
+   */
+  buildSubstituicao(dados) {
+    if (!dados.numeroNfseSubstituida) {
+      throw new GhinfeError('numeroNfseSubstituida é obrigatório', 'NFSE_SUBST_NUMERO');
+    }
+    if (!dados.xmlRpsSubstituto) {
+      throw new GhinfeError('xmlRpsSubstituto é obrigatório', 'NFSE_SUBST_RPS');
+    }
+
+    const cancelamento = this.buildCancelamento({
+      numeroNfse: dados.numeroNfseSubstituida,
+      cnpjPrestador: dados.cnpjPrestador,
+      inscricaoMunicipal: dados.inscricaoMunicipal,
+      codigoMunicipio: dados.codigoMunicipio,
+      codigoCancelamento: dados.codigoCancelamento ?? '1',
+    });
+
+    // Extrai InfPedidoCancelamento e Rps interno do RPS substituto
+    const pedidoMatch = cancelamento.match(/<Pedido>[\s\S]*?<\/Pedido>/);
+    const rpsInner = this.#extrairRps(dados.xmlRpsSubstituto);
+
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<SubstituirNfseEnvio xmlns="${NFSE_NAMESPACE}">
+  <SubstituicaoNfse Id="Substituicao_${dados.numeroNfseSubstituida}">
+    ${pedidoMatch?.[0] ?? ''}
+    <Rps>${rpsInner}</Rps>
+  </SubstituicaoNfse>
+</SubstituirNfseEnvio>`;
+  }
+
+  /** @param {string} xmlRps */
+  #extrairRps(xmlRps) {
+    const inf = xmlRps.match(/<(InfRps|InfDeclaracaoPrestacaoServico)[\s\S]*?<\/\1>/);
+    if (inf) return inf[0];
+    const rps = xmlRps.match(/<Rps[\s\S]*?<\/Rps>/);
+    if (rps) {
+      return rps[0].replace(/^<Rps[^>]*>/, '').replace(/<\/Rps>$/, '');
+    }
+    return xmlRps.replace(/^<\?xml[^?]*\?>/, '').trim();
+  }
+}

package/src/nfse/builders/NFSeXmlBuilder.js

@@ -0,0 +1,16 @@
+import { obterAdapter } from '../layouts/adapters.js';
+import { NFSE_LAYOUTS } from '../constants/municipios.js';
+
+/**
+ * Gera XML RPS conforme layout municipal (ABRASF, GINFES, Betha, ISSNet).
+ */
+export class NFSeXmlBuilder {
+  /**
+   * @param {import('../types/NFSeDocument.js').NFSeDocumento} documento
+   * @param {string} [layout] abrasf | ginfes | betha | issnet
+   * @returns {string}
+   */
+  buildGerarNfse(documento, layout = NFSE_LAYOUTS.ABRASF) {
+    return obterAdapter(layout).build(documento);
+  }
+}

package/src/nfse/constants/municipios.js

@@ -0,0 +1,82 @@
+/** Layouts NFS-e suportados pela biblioteca. */
+export const NFSE_LAYOUTS = {
+  ABRASF: 'abrasf',
+  GINFES: 'ginfes',
+  BETHA: 'betha',
+  ISSNET: 'issnet',
+};
+
+/** Layout ABRASF 2.04 — padrão mais adotado pelos municípios. */
+export const NFSE_LAYOUT = '2.04';
+export const NFSE_NAMESPACE = 'http://www.abrasf.org.br/nfse.xsd';
+export const GINFES_NAMESPACE = 'http://www.ginfes.com.br/servico_enviar_lote_rps_envio';
+export const BETHA_NAMESPACE = 'http://www.betha.com.br/e-nota-contribuinte-ws';
+export const ISSNET_NAMESPACE = 'http://www.issnetonline.com.br/webserviceabrasf/vsd/servico_enviar_lote_rps_envio.xsd';
+
+/**
+ * Endpoints NFS-e por município (IBGE).
+ * layout: abrasf | ginfes | betha | issnet
+ * URLs são exemplos — valide com a prefeitura / provedor.
+ */
+export const NFSE_MUNICIPIOS = {
+  '3550308': {
+    nome: 'São Paulo/SP',
+    layout: NFSE_LAYOUTS.ABRASF,
+    homologacao: 'https://nfe.prefeitura.sp.gov.br/ws/lotenfe.asmx',
+    producao: 'https://nfe.prefeitura.sp.gov.br/ws/lotenfe.asmx',
+  },
+  '3304557': {
+    nome: 'Rio de Janeiro/RJ',
+    layout: NFSE_LAYOUTS.ABRASF,
+    homologacao: 'https://notacarioca.rio.gov.br/WSNacional/nfse.asmx',
+    producao: 'https://notacarioca.rio.gov.br/WSNacional/nfse.asmx',
+  },
+  '3106200': {
+    nome: 'Belo Horizonte/MG',
+    layout: NFSE_LAYOUTS.ABRASF,
+    homologacao: 'https://bhissdigital.pbh.gov.br/bhiss-ws/nfse',
+    producao: 'https://bhissdigital.pbh.gov.br/bhiss-ws/nfse',
+  },
+  '4106902': {
+    nome: 'Curitiba/PR',
+    layout: NFSE_LAYOUTS.ABRASF,
+    homologacao: 'https://isscuritiba.curitiba.pr.gov.br/Iss.NfseWebService/NfseService.svc',
+    producao: 'https://isscuritiba.curitiba.pr.gov.br/Iss.NfseWebService/NfseService.svc',
+  },
+  '4314902': {
+    nome: 'Porto Alegre/RS',
+    layout: NFSE_LAYOUTS.BETHA,
+    homologacao: 'https://e-gov.betha.com.br/e-nota-contribuinte-ws/nfseWS',
+    producao: 'https://e-gov.betha.com.br/e-nota-contribuinte-ws/nfseWS',
+  },
+  '4205407': {
+    nome: 'Florianópolis/SC',
+    layout: NFSE_LAYOUTS.BETHA,
+    homologacao: 'https://e-gov.betha.com.br/e-nota-contribuinte-test-ws/nfseWS',
+    producao: 'https://e-gov.betha.com.br/e-nota-contribuinte-ws/nfseWS',
+  },
+  '2927408': {
+    nome: 'Salvador/BA',
+    layout: NFSE_LAYOUTS.GINFES,
+    homologacao: 'https://homologacao.ginfes.com.br/ServiceGinfesImpl',
+    producao: 'https://producao.ginfes.com.br/ServiceGinfesImpl',
+  },
+  '2611606': {
+    nome: 'Recife/PE',
+    layout: NFSE_LAYOUTS.ISSNET,
+    homologacao: 'https://www.issnetonline.com.br/webserviceabrasf/homologacao/servicos.asmx',
+    producao: 'https://www.issnetonline.com.br/webserviceabrasf/producao/servicos.asmx',
+  },
+  '2304400': {
+    nome: 'Fortaleza/CE',
+    layout: NFSE_LAYOUTS.ISSNET,
+    homologacao: 'https://iss.fortaleza.ce.gov.br/group/guest/nfe',
+    producao: 'https://iss.fortaleza.ce.gov.br/group/guest/nfe',
+  },
+  mock: {
+    nome: 'Mock GHINFE',
+    layout: NFSE_LAYOUTS.ABRASF,
+    homologacao: 'http://localhost/mock/nfse',
+    producao: 'http://localhost/mock/nfse',
+  },
+};

package/src/nfse/layouts/adapters.js

@@ -0,0 +1,202 @@
+import { create } from 'xmlbuilder2';
+import {
+  NFSE_NAMESPACE,
+  GINFES_NAMESPACE,
+  BETHA_NAMESPACE,
+  ISSNET_NAMESPACE,
+  NFSE_LAYOUTS,
+} from '../constants/municipios.js';
+import { formatSefazDateTime } from '../../utils/date.utils.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+
+/**
+ * Monta o bloco InfRps / InfDeclaracaoPrestacaoServico comum aos layouts.
+ * @param {import('xmlbuilder2').XMLBuilder} parent
+ * @param {import('../types/NFSeDocument.js').NFSeDocumento} documento
+ * @param {string} idAttr
+ */
+function appendInfRps(parent, documento, idAttr = 'InfRps') {
+  const dataEmissao = formatSefazDateTime();
+  const idRps = `RPS${documento.numero}`;
+  const valorServicos = documento.servico.valorServicos;
+  const valorIss = documento.servico.valorIss ?? 0;
+  const baseCalculo = valorServicos - (documento.servico.valorDeducoes ?? 0);
+  const valorLiquido =
+    valorServicos -
+    (documento.servico.descontoIncondicionado ?? 0) -
+    (documento.servico.descontoCondicionado ?? 0);
+
+  const inf = parent.ele(idAttr, { Id: idRps });
+
+  const idRpsNode = inf.ele('IdentificacaoRps');
+  idRpsNode.ele('Numero').txt(String(documento.numero)).up();
+  idRpsNode.ele('Serie').txt(documento.serie ?? 'NF').up();
+  idRpsNode.ele('Tipo').txt(String(documento.tipo ?? 1)).up();
+  idRpsNode.up();
+
+  inf
+    .ele('DataEmissao').txt(dataEmissao).up()
+    .ele('NaturezaOperacao').txt(String(documento.naturezaOperacao ?? 1)).up()
+    .ele('OptanteSimplesNacional').txt(String(documento.optanteSimplesNacional ?? 1)).up()
+    .ele('IncentivadorCultural').txt(String(documento.incentivadorCultural ?? 2)).up()
+    .ele('Status').txt('1').up();
+
+  const servico = inf.ele('Servico');
+  const valores = servico.ele('Valores');
+  valores
+    .ele('ValorServicos').txt(dec(valorServicos)).up()
+    .ele('ValorDeducoes').txt(dec(documento.servico.valorDeducoes ?? 0)).up()
+    .ele('ValorPis').txt(dec(documento.servico.valorPis ?? 0)).up()
+    .ele('ValorCofins').txt(dec(documento.servico.valorCofins ?? 0)).up()
+    .ele('ValorInss').txt(dec(documento.servico.valorInss ?? 0)).up()
+    .ele('ValorIr').txt(dec(documento.servico.valorIr ?? 0)).up()
+    .ele('ValorCsll').txt(dec(documento.servico.valorCsll ?? 0)).up()
+    .ele('IssRetido').txt(String(documento.servico.issRetido ?? 2)).up()
+    .ele('ValorIss').txt(dec(valorIss)).up()
+    .ele('BaseCalculo').txt(dec(baseCalculo)).up()
+    .ele('Aliquota').txt(dec(documento.servico.aliquotaIss ?? 0, 4)).up()
+    .ele('ValorLiquidoNfse').txt(dec(valorLiquido)).up()
+    .ele('DescontoIncondicionado').txt(dec(documento.servico.descontoIncondicionado ?? 0)).up()
+    .ele('DescontoCondicionado').txt(dec(documento.servico.descontoCondicionado ?? 0)).up();
+  valores.up();
+
+  servico
+    .ele('ItemListaServico').txt(documento.servico.itemListaServico).up()
+    .ele('Discriminacao').txt(documento.servico.discriminacao).up()
+    .ele('CodigoMunicipio').txt(documento.servico.codigoMunicipio).up();
+  servico.up();
+
+  const prestador = inf.ele('Prestador');
+  prestador
+    .ele('Cnpj').txt(documento.cnpjPrestador.replace(/\D/g, '')).up()
+    .ele('InscricaoMunicipal').txt(documento.inscricaoMunicipal).up();
+  prestador.up();
+
+  const tomador = inf.ele('Tomador');
+  const identTomador = tomador.ele('IdentificacaoTomador').ele('CpfCnpj');
+  const docTomador = (documento.tomador.cnpj ?? documento.tomador.cpf ?? '').replace(/\D/g, '');
+  if (docTomador.length === 14) identTomador.ele('Cnpj').txt(docTomador).up();
+  else if (docTomador.length === 11) identTomador.ele('Cpf').txt(docTomador).up();
+  identTomador.up().up();
+  tomador.ele('RazaoSocial').txt(documento.tomador.razaoSocial).up();
+
+  if (documento.tomador.endereco) {
+    const end = tomador.ele('Endereco');
+    const e = documento.tomador.endereco;
+    end.ele('Endereco').txt(e.logradouro).up();
+    end.ele('Numero').txt(e.numero).up();
+    if (e.complemento) end.ele('Complemento').txt(e.complemento).up();
+    end.ele('Bairro').txt(e.bairro).up();
+    end.ele('CodigoMunicipio').txt(e.codigoMunicipio).up();
+    end.ele('Uf').txt(e.uf).up();
+    end.ele('Cep').txt(e.cep.replace(/\D/g, '')).up();
+    end.up();
+  }
+
+  if (documento.tomador.email) {
+    tomador.ele('Contato').ele('Email').txt(documento.tomador.email).up().up();
+  }
+  tomador.up();
+
+  if (documento.informacoesComplementares) {
+    inf.ele('Observacao').txt(documento.informacoesComplementares).up();
+  }
+
+  return inf;
+}
+
+/** @param {number} v @param {number} [d] */
+function dec(v, d = 2) {
+  return Number(v).toFixed(d);
+}
+
+/**
+ * @param {import('../types/NFSeDocument.js').NFSeDocumento} documento
+ */
+function validarDocumento(documento) {
+  if (!documento.numero) throw new GhinfeError('numero do RPS é obrigatório', 'NFSE_NUMERO_REQUIRED');
+  if (!documento.cnpjPrestador) throw new GhinfeError('cnpjPrestador é obrigatório', 'NFSE_CNPJ_REQUIRED');
+  if (!documento.inscricaoMunicipal) throw new GhinfeError('inscricaoMunicipal é obrigatória', 'NFSE_IM_REQUIRED');
+  if (!documento.servico) throw new GhinfeError('servico é obrigatório', 'NFSE_SERVICO_REQUIRED');
+  if (!documento.tomador) throw new GhinfeError('tomador é obrigatório', 'NFSE_TOMADOR_REQUIRED');
+}
+
+/**
+ * Adapters de layout municipal.
+ * Mantêm o mesmo objeto de domínio e trocam o wrapper/namespace XML.
+ */
+export const NFSeLayoutAdapters = {
+  [NFSE_LAYOUTS.ABRASF]: {
+    nome: 'ABRASF 2.04',
+    build(documento) {
+      validarDocumento(documento);
+      const doc = create({ version: '1.0', encoding: 'UTF-8' })
+        .ele('GerarNfseEnvio', { xmlns: NFSE_NAMESPACE });
+      const rps = doc.ele('Rps');
+      appendInfRps(rps, documento, 'InfRps');
+      return doc.end({ prettyPrint: false, headless: false });
+    },
+  },
+
+  [NFSE_LAYOUTS.GINFES]: {
+    nome: 'GINFES',
+    build(documento) {
+      validarDocumento(documento);
+      const doc = create({ version: '1.0', encoding: 'UTF-8' })
+        .ele('EnviarLoteRpsEnvio', { xmlns: GINFES_NAMESPACE });
+      const lote = doc.ele('LoteRps', { Id: `Lote${documento.numero}`, versao: '3.00' });
+      lote.ele('NumeroLote').txt(String(documento.numero)).up();
+      lote.ele('Cnpj').txt(documento.cnpjPrestador.replace(/\D/g, '')).up();
+      lote.ele('InscricaoMunicipal').txt(documento.inscricaoMunicipal).up();
+      lote.ele('QuantidadeRps').txt('1').up();
+      const lista = lote.ele('ListaRps').ele('Rps');
+      appendInfRps(lista, documento, 'InfRps');
+      return doc.end({ prettyPrint: false, headless: false });
+    },
+  },
+
+  [NFSE_LAYOUTS.BETHA]: {
+    nome: 'Betha',
+    build(documento) {
+      validarDocumento(documento);
+      const doc = create({ version: '1.0', encoding: 'UTF-8' })
+        .ele('GerarNfseEnvio', { xmlns: BETHA_NAMESPACE });
+      const rps = doc.ele('Rps');
+      appendInfRps(rps, documento, 'InfDeclaracaoPrestacaoServico');
+      return doc.end({ prettyPrint: false, headless: false });
+    },
+  },
+
+  [NFSE_LAYOUTS.ISSNET]: {
+    nome: 'ISSNet',
+    build(documento) {
+      validarDocumento(documento);
+      const doc = create({ version: '1.0', encoding: 'UTF-8' })
+        .ele('EnviarLoteRpsEnvio', { xmlns: ISSNET_NAMESPACE });
+      const lote = doc.ele('LoteRps', { Id: `Lote${documento.numero}`, versao: '2.04' });
+      lote.ele('NumeroLote').txt(String(documento.numero)).up();
+      lote.ele('CpfCnpj').ele('Cnpj').txt(documento.cnpjPrestador.replace(/\D/g, '')).up().up();
+      lote.ele('InscricaoMunicipal').txt(documento.inscricaoMunicipal).up();
+      lote.ele('QuantidadeRps').txt('1').up();
+      const lista = lote.ele('ListaRps').ele('Rps');
+      appendInfRps(lista, documento, 'InfDeclaracaoPrestacaoServico');
+      return doc.end({ prettyPrint: false, headless: false });
+    },
+  },
+};
+
+/**
+ * @param {string} layout
+ * @returns {typeof NFSeLayoutAdapters[string]}
+ */
+export function obterAdapter(layout) {
+  const key = (layout ?? NFSE_LAYOUTS.ABRASF).toLowerCase();
+  const adapter = NFSeLayoutAdapters[key];
+  if (!adapter) {
+    throw new GhinfeError(
+      `Layout NFS-e não suportado: ${layout}. Use: ${Object.keys(NFSE_LAYOUTS).join(', ')}`,
+      'NFSE_LAYOUT_UNSUPPORTED'
+    );
+  }
+  return adapter;
+}

package/src/nfse/mocks/nfse-responses.js

@@ -0,0 +1,142 @@
+/**
+ * Respostas mock NFS-e para desenvolvimento.
+ */
+export const NFSE_MOCK_RESPONSES = {
+  autorizada: {
+    sucesso: true,
+    codigo: 'E000',
+    mensagem: 'NFS-e autorizada com sucesso',
+    numeroNfse: '2026000001',
+    codigoVerificacao: 'ABC1-DEF2',
+  },
+  rejeicao: {
+    sucesso: false,
+    codigo: 'E001',
+    mensagem: 'Rejeição: RPS já convertido em NFS-e',
+  },
+  cancelada: {
+    sucesso: true,
+    codigo: 'E000',
+    mensagem: 'NFS-e cancelada com sucesso',
+    numeroNfse: '2026000001',
+  },
+  substituida: {
+    sucesso: true,
+    codigo: 'E000',
+    mensagem: 'NFS-e substituída com sucesso',
+    numeroNfse: '2026000002',
+    codigoVerificacao: 'XYZ9-SUB1',
+    numeroNfseSubstituida: '2026000001',
+  },
+};
+
+/**
+ * @param {string} numeroRps
+ * @param {{ codigo: string, mensagem: string, numeroNfse?: string, codigoVerificacao?: string }} resultado
+ */
+export function buildMockGerarNfseResponse(numeroRps, resultado) {
+  const dh = new Date().toISOString();
+
+  if (resultado.codigo === 'E000') {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<GerarNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <ListaNfse>
+    <CompNfse>
+      <Nfse versao="2.04">
+        <InfNfse Id="NFS${resultado.numeroNfse}">
+          <Numero>${resultado.numeroNfse}</Numero>
+          <CodigoVerificacao>${resultado.codigoVerificacao}</CodigoVerificacao>
+          <DataEmissao>${dh}</DataEmissao>
+          <IdentificacaoRps>
+            <Numero>${numeroRps}</Numero>
+            <Serie>NF</Serie>
+            <Tipo>1</Tipo>
+          </IdentificacaoRps>
+        </InfNfse>
+      </Nfse>
+    </CompNfse>
+  </ListaNfse>
+</GerarNfseResposta>`;
+  }
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<GerarNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <ListaMensagemRetorno>
+    <MensagemRetorno>
+      <Codigo>${resultado.codigo}</Codigo>
+      <Mensagem>${resultado.mensagem}</Mensagem>
+    </MensagemRetorno>
+  </ListaMensagemRetorno>
+</GerarNfseResposta>`;
+}
+
+/**
+ * @param {string} numeroNfse
+ * @param {{ codigo: string, mensagem: string }} resultado
+ */
+export function buildMockCancelarNfseResponse(numeroNfse, resultado) {
+  const dh = new Date().toISOString();
+  if (resultado.codigo === 'E000') {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<CancelarNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <RetCancelamento>
+    <NfseCancelamento>
+      <Confirmacao>
+        <Pedido>
+          <InfPedidoCancelamento>
+            <IdentificacaoNfse>
+              <Numero>${numeroNfse}</Numero>
+            </IdentificacaoNfse>
+          </InfPedidoCancelamento>
+        </Pedido>
+        <DataHora>${dh}</DataHora>
+      </Confirmacao>
+    </NfseCancelamento>
+  </RetCancelamento>
+</CancelarNfseResposta>`;
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<CancelarNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <ListaMensagemRetorno>
+    <MensagemRetorno>
+      <Codigo>${resultado.codigo}</Codigo>
+      <Mensagem>${resultado.mensagem}</Mensagem>
+    </MensagemRetorno>
+  </ListaMensagemRetorno>
+</CancelarNfseResposta>`;
+}
+
+/**
+ * @param {{ codigo: string, mensagem: string, numeroNfse?: string, codigoVerificacao?: string, numeroNfseSubstituida?: string }} resultado
+ */
+export function buildMockSubstituirNfseResponse(resultado) {
+  const dh = new Date().toISOString();
+  if (resultado.codigo === 'E000') {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<SubstituirNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <RetSubstituicao>
+    <NfseSubstituida>
+      <InfNfse>
+        <Numero>${resultado.numeroNfseSubstituida ?? '2026000001'}</Numero>
+      </InfNfse>
+    </NfseSubstituida>
+    <NfseSubstituidora>
+      <InfNfse Id="NFS${resultado.numeroNfse}">
+        <Numero>${resultado.numeroNfse}</Numero>
+        <CodigoVerificacao>${resultado.codigoVerificacao}</CodigoVerificacao>
+        <DataEmissao>${dh}</DataEmissao>
+      </InfNfse>
+    </NfseSubstituidora>
+  </RetSubstituicao>
+</SubstituirNfseResposta>`;
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<SubstituirNfseResposta xmlns="http://www.abrasf.org.br/nfse.xsd">
+  <ListaMensagemRetorno>
+    <MensagemRetorno>
+      <Codigo>${resultado.codigo}</Codigo>
+      <Mensagem>${resultado.mensagem}</Mensagem>
+    </MensagemRetorno>
+  </ListaMensagemRetorno>
+</SubstituirNfseResposta>`;
+}