focus_nfe 1.0.0

data/spec/focus_nfe/recursos/mdfe_spec.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Mdfe do
+  let(:ref) { "manifesto-7" }
+
+  it_behaves_like "um recurso emitível", "mdfe"
+  it_behaves_like "um recurso consultável", "mdfe"
+  it_behaves_like "um recurso cancelável", "mdfe"
+  it_behaves_like "um recurso notificável", "mdfe"
+
+  include_context "com recurso conectado"
+
+  describe "#encerrar" do
+    it "faz POST em /v2/mdfe/{ref}/encerrar com data, UF e município", :aggregate_failures do
+      stub = stub_envio(:post, "mdfe/#{ref}/encerrar",
+                        body: { data: "2026-06-13", sigla_uf: "SP", nome_municipio: "São Paulo" })
+
+      doc = recurso.encerrar(ref, data: "2026-06-13", sigla_uf: "SP", nome_municipio: "São Paulo")
+
+      expect(stub).to have_been_requested
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { recurso.encerrar("manifesto 7", data: "2026-06-13", sigla_uf: "SP", nome_municipio: "São Paulo") }
+        .to raise_error(ArgumentError)
+    end
+
+    context "quando o ambiente é produção" do
+      let(:client) { FocusNfe::Client.new(token_empresa: "tok", environment: :producao) }
+
+      it "usa o host de produção" do
+        stub = stub_request(:post, "https://api.focusnfe.com.br/v2/mdfe/#{ref}/encerrar")
+               .to_return(status: 200, body: "{}", headers: json)
+
+        recurso.encerrar(ref, data: "2026-06-13", sigla_uf: "SP", nome_municipio: "São Paulo")
+
+        expect(stub).to have_been_requested
+      end
+    end
+  end
+
+  describe "#incluir_condutor" do
+    it "faz POST em /v2/mdfe/{ref}/inclusao_condutor com nome e CPF", :aggregate_failures do
+      stub = stub_envio(:post, "mdfe/#{ref}/inclusao_condutor", body: { nome: "João", cpf: "12345678912" })
+
+      doc = recurso.incluir_condutor(ref, nome: "João", cpf: "12345678912")
+
+      expect(stub).to have_been_requested
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+  end
+
+  describe "#incluir_dfe" do
+    let(:documentos) do
+      [{ "chave_nfe" => "3" * 44, "codigo_municipio_descarregamento" => "3550308" }]
+    end
+
+    it "faz POST em /v2/mdfe/{ref}/inclusao_dfe com protocolo, município e documentos", :aggregate_failures do
+      stub = stub_envio(:post, "mdfe/#{ref}/inclusao_dfe",
+                        body: { protocolo: "141250000012345",
+                                codigo_municipio_carregamento: "3550308",
+                                documentos: documentos })
+
+      doc = recurso.incluir_dfe(ref, protocolo: "141250000012345",
+                                     codigo_municipio_carregamento: "3550308",
+                                     documentos: documentos)
+
+      expect(stub).to have_been_requested
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+
+    it "inclui nome_municipio_carregamento no corpo quando informado" do
+      stub = stub_envio(:post, "mdfe/#{ref}/inclusao_dfe",
+                        body: { protocolo: "141250000012345",
+                                codigo_municipio_carregamento: "3550308",
+                                documentos: documentos,
+                                nome_municipio_carregamento: "São Paulo" })
+
+      recurso.incluir_dfe(ref, protocolo: "141250000012345",
+                               codigo_municipio_carregamento: "3550308",
+                               documentos: documentos,
+                               nome_municipio_carregamento: "São Paulo")
+
+      expect(stub).to have_been_requested
+    end
+
+    it "omite nome_municipio_carregamento do corpo quando não informado" do
+      stub_envio(:post, "mdfe/#{ref}/inclusao_dfe")
+
+      recurso.incluir_dfe(ref, protocolo: "141250000012345",
+                               codigo_municipio_carregamento: "3550308",
+                               documentos: documentos)
+
+      requisicao = a_request(:post, "#{homologacao}/v2/mdfe/#{ref}/inclusao_dfe")
+                   .with { |req| !req.body.include?("nome_municipio_carregamento") }
+      expect(requisicao).to have_been_made
+    end
+  end
+end

data/spec/focus_nfe/recursos/municipios_spec.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Municipios do
+  include_context "com recurso conectado"
+
+  let(:codigo) { "1302603" }
+
+  it_behaves_like "um recurso listável", "municipios"
+  it_behaves_like "um recurso localizável", "municipios"
+
+  describe "#listar_codigos_tributarios" do
+    it "faz GET no sub-recurso de códigos tributários e devolve uma Pagina" do
+      stub_get("municipios/#{codigo}/codigos_tributarios_municipio", body: "[]")
+
+      expect(recurso.listar_codigos_tributarios(codigo)).to be_a(FocusNfe::Modelos::Pagina)
+    end
+
+    it "repassa os filtros como query string" do
+      stub = stub_get("municipios/#{codigo}/codigos_tributarios_municipio", query: { offset: 50 })
+
+      recurso.listar_codigos_tributarios(codigo, offset: 50)
+
+      expect(stub).to have_been_requested
+    end
+  end
+
+  describe "#listar_itens_lista_servico" do
+    it "faz GET no sub-recurso de itens da lista de serviço e devolve uma Pagina" do
+      stub_get("municipios/#{codigo}/itens_lista_servico", body: "[]")
+
+      expect(recurso.listar_itens_lista_servico(codigo)).to be_a(FocusNfe::Modelos::Pagina)
+    end
+  end
+
+  describe "#consultar_codigo_tributario" do
+    it "faz GET no código tributário por código e devolve o corpo cru" do
+      stub_get("municipios/#{codigo}/codigos_tributarios_municipio/1.06", body: '{"codigo":"1.06"}')
+
+      expect(recurso.consultar_codigo_tributario(codigo, "1.06")).to eq("codigo" => "1.06")
+    end
+  end
+
+  describe "#consultar_item_lista_servico" do
+    it "faz GET no item da lista de serviço por código e devolve o corpo cru" do
+      stub_get("municipios/#{codigo}/itens_lista_servico/1.06", body: '{"codigo":"1.06"}')
+
+      expect(recurso.consultar_item_lista_servico(codigo, "1.06")).to eq("codigo" => "1.06")
+    end
+  end
+
+  describe "#consultar_json" do
+    it "faz GET no JSON de exemplo do município e devolve o corpo cru" do
+      stub_get("municipios/#{codigo}/json", body: '{"prestador":{}}')
+
+      expect(recurso.consultar_json(codigo)).to eq("prestador" => {})
+    end
+  end
+end

data/spec/focus_nfe/recursos/ncms_spec.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Ncms do
+  it_behaves_like "um recurso listável", "ncms"
+  it_behaves_like "um recurso localizável", "ncms"
+
+  include_context "com recurso conectado"
+
+  describe "#buscar" do
+    it "é um apelido de #listar" do
+      stub_get("ncms", query: { capitulo: "85" }, body: "[]")
+
+      expect(recurso.buscar(capitulo: "85")).to be_a(FocusNfe::Modelos::Pagina)
+    end
+  end
+end

data/spec/focus_nfe/recursos/nfce_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Nfce do
+  it_behaves_like "um recurso emitível", "nfce"
+  it_behaves_like "um recurso consultável", "nfce"
+  it_behaves_like "um recurso cancelável", "nfce"
+  it_behaves_like "um recurso inutilizável", "nfce"
+  it_behaves_like "um recurso enviável por email", "nfce"
+  it_behaves_like "um recurso conciliável", "nfce"
+end

data/spec/focus_nfe/recursos/nfcom_spec.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Nfcom do
+  it_behaves_like "um recurso emitível", "nfcom"
+  it_behaves_like "um recurso consultável", "nfcom"
+  it_behaves_like "um recurso cancelável", "nfcom"
+  it_behaves_like "um recurso notificável", "nfcom"
+end

data/spec/focus_nfe/recursos/nfe_spec.rb

@@ -0,0 +1,262 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Nfe do
+  subject(:nfe) { described_class.new(client.connection) }
+
+  let(:client) { FocusNfe::Client.new(token_empresa: "tok", environment: environment) }
+  let(:environment) { :homologacao }
+  let(:json) { { "Content-Type" => "application/json" } }
+  let(:dados) { { "natureza_operacao" => "Venda" } }
+  let(:processando) { '{"status":"processando_autorizacao"}' }
+
+  def homologacao = "https://homologacao.focusnfe.com.br"
+  def producao = "https://api.focusnfe.com.br"
+
+  def stub_nfe(verb, path, host: homologacao, status: 200, body: "{}")
+    stub_request(verb, "#{host}/v2/#{path}").to_return(status: status, body: body, headers: json)
+  end
+
+  it_behaves_like "um recurso corrigível", "nfe"
+  it_behaves_like "um recurso inutilizável", "nfe"
+  it_behaves_like "um recurso visualizável", "nfe/danfe"
+  it_behaves_like "um recurso notificável", "nfe"
+  it_behaves_like "um recurso enviável por email", "nfe"
+  it_behaves_like "um recurso conciliável", "nfe"
+
+  describe "#emitir" do
+    before { stub_nfe(:post, "nfe?ref=pedido-42", status: 202, body: processando) }
+
+    it "envia POST em /v2/nfe?ref= com o JSON dos dados" do
+      nfe.emitir(ref: "pedido-42", dados: dados)
+
+      expect(a_request(:post, "#{homologacao}/v2/nfe?ref=pedido-42").with(body: JSON.generate(dados))).to have_been_made
+    end
+
+    it "devolve um Documento processando com a ref", :aggregate_failures do
+      doc = nfe.emitir(ref: "pedido-42", dados: dados)
+
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+      expect(doc).to be_processando
+      expect(doc.ref).to eq("pedido-42")
+    end
+
+    context "quando o ambiente é produção" do
+      let(:environment) { :producao }
+
+      it "usa o host de produção" do
+        stub = stub_nfe(:post, "nfe?ref=pedido-42", host: producao, status: 202, body: processando)
+
+        nfe.emitir(ref: "pedido-42", dados: dados)
+
+        expect(stub).to have_been_requested
+      end
+    end
+
+    it "propaga erro tipado da API (422)" do
+      stub_nfe(:post, "nfe?ref=pedido-42", status: 422, body: '{"erros":[]}')
+
+      expect { nfe.emitir(ref: "pedido-42", dados: dados) }.to raise_error(FocusNfe::Errors::ValidationError)
+    end
+
+    it "rejeita ref inválida sem requisição", :aggregate_failures do
+      expect { nfe.emitir(ref: "pedido 42", dados: dados) }.to raise_error(ArgumentError)
+      expect(a_request(:post, "#{homologacao}/v2/nfe")).not_to have_been_made
+    end
+  end
+
+  describe "#consultar" do
+    it "faz GET em /v2/nfe/{ref} e devolve o Documento autorizado", :aggregate_failures do
+      stub_nfe(:get, "nfe/pedido-42", body: '{"status":"autorizado","chave_nfe":"3520"}')
+      doc = nfe.consultar("pedido-42")
+
+      expect(doc).to be_autorizado
+      expect(doc.chave_nfe).to eq("3520")
+    end
+
+    it "envia ?completa=1 quando completa: true" do
+      stub = stub_nfe(:get, "nfe/pedido-42?completa=1", body: '{"status":"autorizado"}')
+
+      nfe.consultar("pedido-42", completa: true)
+
+      expect(stub).to have_been_requested
+    end
+
+    it "não envia completa por padrão" do
+      stub = stub_nfe(:get, "nfe/pedido-42", body: '{"status":"autorizado"}')
+
+      nfe.consultar("pedido-42")
+
+      expect(stub).to have_been_requested
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.consultar("pedido 42") }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#cancelar" do
+    it "faz DELETE em /v2/nfe/{ref} com a justificativa no corpo", :aggregate_failures do
+      stub_nfe(:delete, "nfe/pedido-42", body: '{"status":"cancelado"}')
+      doc = nfe.cancelar("pedido-42", justificativa: "erro")
+      enviado = a_request(:delete, "#{homologacao}/v2/nfe/pedido-42").with(body: '{"justificativa":"erro"}')
+
+      expect(doc).to be_cancelado
+      expect(enviado).to have_been_made
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.cancelar("pedido 42", justificativa: "x") }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#importar" do
+    let(:xml) { "<nfeProc><NFe/></nfeProc>" }
+
+    it "faz POST em /v2/nfe/importacao com o XML cru e Content-Type application/xml" do
+      stub_nfe(:post, "nfe/importacao", body: '{"status":"processando_autorizacao"}')
+      nfe.importar(xml)
+
+      enviado = a_request(:post, "#{homologacao}/v2/nfe/importacao")
+                .with(body: xml, headers: { "Content-Type" => "application/xml" })
+      expect(enviado).to have_been_made
+    end
+
+    it "envia ?ref= quando a referência é informada", :aggregate_failures do
+      stub = stub_nfe(:post, "nfe/importacao?ref=pedido-42", body: '{"status":"processando_autorizacao"}')
+
+      doc = nfe.importar(xml, ref: "pedido-42")
+
+      expect(stub).to have_been_requested
+      expect(doc.ref).to eq("pedido-42")
+    end
+
+    it "omite ref por padrão" do
+      stub = stub_nfe(:post, "nfe/importacao", body: "{}")
+
+      nfe.importar(xml)
+
+      expect(stub).to have_been_requested
+    end
+
+    context "quando o ambiente é produção" do
+      let(:environment) { :producao }
+
+      it "usa o host de produção" do
+        stub = stub_nfe(:post, "nfe/importacao", host: producao, body: "{}")
+
+        nfe.importar(xml)
+
+        expect(stub).to have_been_requested
+      end
+    end
+  end
+
+  describe "#emitir_evento" do
+    let(:corpo) do
+      { tipo_evento: "prorrogacao_suspensao_icms",
+        itens_prorrogacao_suspensao_icms: [{ numero_item: "1", quantidade_item: 1 }] }
+    end
+
+    it "faz POST em /v2/nfe/{ref}/evento com tipo_evento e itens", :aggregate_failures do
+      stub_nfe(:post, "nfe/pedido-42/evento")
+
+      doc = nfe.emitir_evento("pedido-42", **corpo)
+
+      enviado = a_request(:post, "#{homologacao}/v2/nfe/pedido-42/evento").with(body: JSON.generate(corpo))
+      expect(enviado).to have_been_made
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.emitir_evento("pedido 42", tipo_evento: "x") }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#cancelar_evento" do
+    it "faz DELETE em /v2/nfe/{ref}/evento com tipo_evento no corpo", :aggregate_failures do
+      stub_nfe(:delete, "nfe/pedido-42/evento")
+
+      nfe.cancelar_evento("pedido-42", tipo_evento: "prorrogacao_suspensao_icms")
+
+      enviado = a_request(:delete, "#{homologacao}/v2/nfe/pedido-42/evento")
+                .with(body: JSON.generate(tipo_evento: "prorrogacao_suspensao_icms"))
+      expect(enviado).to have_been_made
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.cancelar_evento("pedido 42", tipo_evento: "x") }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#registrar_ator_interessado" do
+    it "faz POST em /v2/nfe/{ref}/ator_interessado com o CNPJ e a autorização", :aggregate_failures do
+      stub_nfe(:post, "nfe/pedido-42/ator_interessado")
+
+      nfe.registrar_ator_interessado("pedido-42", permite_autorizacao_terceiros: true, cnpj: "12345678000190")
+
+      corpo = JSON.generate(permite_autorizacao_terceiros: true, cnpj: "12345678000190")
+      expect(a_request(:post, "#{homologacao}/v2/nfe/pedido-42/ator_interessado").with(body: corpo))
+        .to have_been_made
+    end
+
+    it "omite cpf e cnpj quando não informados" do
+      stub_nfe(:post, "nfe/pedido-42/ator_interessado")
+
+      nfe.registrar_ator_interessado("pedido-42", permite_autorizacao_terceiros: false)
+
+      corpo = JSON.generate(permite_autorizacao_terceiros: false)
+      expect(a_request(:post, "#{homologacao}/v2/nfe/pedido-42/ator_interessado").with(body: corpo))
+        .to have_been_made
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.registrar_ator_interessado("pedido 42", permite_autorizacao_terceiros: true) }
+        .to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#registrar_insucesso_entrega" do
+    let(:insucesso) do
+      { data_tentativa_entrega: "2024-07-24T10:30:56-03:00", motivo_insucesso: 4,
+        hash_tentativa_entrega: "yzmPGyT1YM5KqilP56w+oPlVkx8=", justificativa_insucesso: "endereço incorreto" }
+    end
+
+    it "faz POST em /v2/nfe/{ref}/insucesso_entrega com os campos obrigatórios e opcionais" do
+      stub_nfe(:post, "nfe/pedido-42/insucesso_entrega")
+      nfe.registrar_insucesso_entrega("pedido-42", **insucesso)
+
+      enviado = a_request(:post, "#{homologacao}/v2/nfe/pedido-42/insucesso_entrega")
+                .with(body: JSON.generate(insucesso))
+      expect(enviado).to have_been_made
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.registrar_insucesso_entrega("pedido 42", **insucesso) }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#cancelar_insucesso_entrega" do
+    it "faz DELETE em /v2/nfe/{ref}/insucesso_entrega sem corpo", :aggregate_failures do
+      stub_nfe(:delete, "nfe/pedido-42/insucesso_entrega")
+
+      doc = nfe.cancelar_insucesso_entrega("pedido-42")
+
+      expect(a_request(:delete, "#{homologacao}/v2/nfe/pedido-42/insucesso_entrega").with(body: nil))
+        .to have_been_made
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+
+    it "rejeita ref inválida sem requisição" do
+      expect { nfe.cancelar_insucesso_entrega("pedido 42") }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe "#previa com validar: true" do
+    it "levanta ErroDeValidacao sem fazer requisição quando faltam obrigatórios", :aggregate_failures do
+      stub = stub_nfe(:post, "nfe/danfe", body: "%PDF-1.4")
+
+      expect { nfe.previa(dados: {}, validar: true) }.to raise_error(FocusNfe::Esquemas::ErroDeValidacao)
+      expect(stub).not_to have_been_requested
+    end
+  end
+end

data/spec/focus_nfe/recursos/nfes_recebidas_spec.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::NfesRecebidas do
+  include_context "com recurso conectado"
+
+  let(:chave) { "35200114200166000187550010000000201234567890" }
+
+  it_behaves_like "um recurso listável", "nfes_recebidas"
+  it_behaves_like "um recurso baixável", "nfes_recebidas"
+  it_behaves_like "um recurso notificável", "nfes_recebidas"
+
+  describe "#consultar" do
+    it "faz GET em /v2/nfes_recebidas/{chave} e devolve o corpo cru" do
+      stub_get("nfes_recebidas/#{chave}", body: '{"situacao":"autorizada"}')
+
+      expect(recurso.consultar(chave)).to eq("situacao" => "autorizada")
+    end
+
+    it "envia ?completa=1 quando completa: true" do
+      stub = stub_get("nfes_recebidas/#{chave}", query: { completa: 1 })
+
+      recurso.consultar(chave, completa: true)
+
+      expect(stub).to have_been_requested
+    end
+  end
+
+  describe "#manifestar" do
+    it "faz POST em /{chave}/manifesto com tipo e justificativa" do
+      corpo = '{"tipo":"ciencia","justificativa":"Ciente da operação."}'
+      stub = stub_envio(:post, "nfes_recebidas/#{chave}/manifesto", body: corpo)
+
+      recurso.manifestar(chave, tipo: "ciencia", justificativa: "Ciente da operação.")
+
+      expect(stub).to have_been_requested
+    end
+
+    it "omite a justificativa quando não informada" do
+      stub = stub_envio(:post, "nfes_recebidas/#{chave}/manifesto", body: '{"tipo":"confirmacao"}')
+
+      recurso.manifestar(chave, tipo: "confirmacao")
+
+      expect(stub).to have_been_requested
+    end
+  end
+
+  describe "#emitir_evento" do
+    it "faz POST em /{chave}/evento e devolve um Documento", :aggregate_failures do
+      corpo = '{"tipo_evento":"imobilizacao_item","item":1}'
+      stub = stub_envio(:post, "nfes_recebidas/#{chave}/evento", body: corpo)
+
+      doc = recurso.emitir_evento(chave, tipo_evento: "imobilizacao_item", item: 1)
+
+      expect(stub).to have_been_requested
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+  end
+
+  describe "#cancelar_evento" do
+    it "faz DELETE em /{chave}/evento e devolve um Documento", :aggregate_failures do
+      stub = stub_envio(:delete, "nfes_recebidas/#{chave}/evento")
+
+      doc = recurso.cancelar_evento(chave)
+
+      expect(stub).to have_been_requested
+      expect(doc).to be_a(FocusNfe::Modelos::Documento)
+    end
+  end
+
+  describe "#download_xml_cancelamento" do
+    it "faz GET em /{chave}/cancelamento.xml e devolve o XML cru" do
+      stub_get("nfes_recebidas/#{chave}/cancelamento.xml",
+               body: "<procEventoNFe/>", headers: { "Content-Type" => "application/xml" })
+
+      expect(recurso.download_xml_cancelamento(chave)).to eq("<procEventoNFe/>")
+    end
+  end
+
+  describe "#download_xml_carta_correcao" do
+    it "faz GET em /{chave}/carta_correcao.xml e devolve o XML cru" do
+      stub_get("nfes_recebidas/#{chave}/carta_correcao.xml",
+               body: "<procEventoNFe/>", headers: { "Content-Type" => "application/xml" })
+
+      expect(recurso.download_xml_carta_correcao(chave)).to eq("<procEventoNFe/>")
+    end
+  end
+end

data/spec/focus_nfe/recursos/nfgas_spec.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Nfgas do
+  it_behaves_like "um recurso emitível", "nfgas"
+  it_behaves_like "um recurso consultável", "nfgas"
+  it_behaves_like "um recurso cancelável", "nfgas"
+  it_behaves_like "um recurso notificável", "nfgas"
+end

data/spec/focus_nfe/recursos/nfse_nacional_spec.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::NfseNacional do
+  it_behaves_like "um recurso emitível", "nfse_nacional"
+  it_behaves_like "um recurso consultável", "nfse_nacional"
+  it_behaves_like "um recurso cancelável", "nfse_nacional"
+  it_behaves_like "um recurso notificável", "nfse_nacional"
+end

data/spec/focus_nfe/recursos/nfse_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Nfse do
+  it_behaves_like "um recurso emitível", "nfse"
+  it_behaves_like "um recurso consultável", "nfse"
+  it_behaves_like "um recurso cancelável", "nfse"
+  it_behaves_like "um recurso notificável", "nfse"
+  it_behaves_like "um recurso enviável por email", "nfse"
+end

data/spec/focus_nfe/recursos/nfses_nacionais_recebidas_spec.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::NfsesNacionaisRecebidas do
+  it_behaves_like "um recurso listável", "nfsens_recebidas"
+  it_behaves_like "um recurso baixável", "nfsens_recebidas"
+  it_behaves_like "um recurso notificável", "nfsens_recebidas"
+
+  include_context "com recurso conectado"
+
+  describe "#download_html" do
+    it "baixa o DANFSe em HTML cru" do
+      stub_get("nfsens_recebidas/CHAVE.html", body: "<html></html>", headers: { "Content-Type" => "text/html" })
+
+      expect(recurso.download_html("CHAVE")).to eq("<html></html>")
+    end
+  end
+end

data/spec/focus_nfe/recursos/webhooks_spec.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+RSpec.describe FocusNfe::Recursos::Webhooks do
+  include_context "com recurso conectado"
+
+  it_behaves_like "um recurso listável", "hooks"
+  it_behaves_like "um recurso localizável", "hooks"
+  it_behaves_like "um recurso removível", "hooks"
+
+  it "usa o caminho_base 'hooks'" do
+    expect(recurso.caminho_base).to eq("hooks")
+  end
+
+  describe "#criar" do
+    it "faz POST em /v2/hooks com os dados e devolve o corpo cru" do
+      dados = { "event" => "nfe", "url" => "https://meu.app/hooks/nfe" }
+      stub_envio(:post, "hooks", body: JSON.generate(dados), resposta: '{"id":9}')
+
+      expect(recurso.criar(dados: dados)).to eq("id" => 9)
+    end
+  end
+end