nfcom 0.1.2

data/lib/nfcom/configuration.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+module Nfcom
+  class Configuration
+    AMBIENTES = {
+      homologacao: 2,
+      producao: 1
+    }.freeze
+
+    ESTADOS = {
+      'AC' => '12', 'AL' => '27', 'AP' => '16', 'AM' => '13',
+      'BA' => '29', 'CE' => '23', 'DF' => '53', 'ES' => '32',
+      'GO' => '52', 'MA' => '21', 'MT' => '51', 'MS' => '50',
+      'MG' => '31', 'PA' => '15', 'PB' => '25', 'PR' => '41',
+      'PE' => '26', 'PI' => '22', 'RJ' => '33', 'RN' => '24',
+      'RS' => '43', 'RO' => '11', 'RR' => '14', 'SC' => '42',
+      'SP' => '35', 'SE' => '28', 'TO' => '17'
+    }.freeze
+
+    # Configurações básicas
+    attr_accessor :ambiente, :estado, :timeout
+
+    # Certificado digital
+    attr_accessor :certificado_path, :certificado_senha
+
+    # Dados do emitente
+    attr_accessor :cnpj, :razao_social, :inscricao_estadual, :regime_tributario
+
+    # Configurações de série e numeração
+    attr_accessor :serie_padrao, :numero_inicial
+
+    # Logging
+    attr_accessor :logger
+    attr_reader :log_level
+
+    # Retry
+    attr_accessor :max_tentativas, :tempo_espera_retry
+
+    def initialize
+      @ambiente = :homologacao
+      @estado = 'PE'
+      @timeout = 30
+      @serie_padrao = 1
+      @numero_inicial = 1
+      @max_tentativas = 3
+      @tempo_espera_retry = 2
+      @log_level = :info
+      @logger = Logger.new($stdout)
+      @logger.level = Logger::INFO
+    end
+
+    def ambiente_codigo
+      AMBIENTES[ambiente]
+    end
+
+    def codigo_uf
+      ESTADOS[estado]
+    end
+
+    def homologacao?
+      ambiente == :homologacao
+    end
+
+    def producao?
+      ambiente == :producao
+    end
+
+    def desabilitar_logs
+      @logger = Logger.new(IO::NULL)
+    end
+
+    def habilitar_logs(output = $stdout)
+      @logger = Logger.new(output)
+      atualizar_log_level
+    end
+
+    # Setter para log_level (atualiza também o logger)
+    def log_level=(level)
+      @log_level = level
+      atualizar_log_level
+    end
+
+    def webservice_url(servico)
+      base_url = if homologacao?
+                   webservices_homologacao[estado.to_sym]
+                 else
+                   webservices_producao[estado.to_sym]
+                 end
+
+      return nil unless base_url
+
+      base_url[servico]
+    end
+
+    private
+
+    def atualizar_log_level
+      return unless @logger
+
+      @logger.level = case @log_level
+                      when :debug then Logger::DEBUG
+                      when :info then Logger::INFO
+                      when :warn then Logger::WARN
+                      when :error then Logger::ERROR
+                      when :fatal then Logger::FATAL
+                      else Logger::INFO # rubocop:disable Lint/DuplicateBranch
+                      end
+    end
+
+    def webservices_homologacao
+      {
+        PE: {
+          recepcao: 'https://nfcom-homologacao.svrs.rs.gov.br/WS/NFComRecepcao/NFComRecepcao.asmx',
+          consulta: 'https://nfcom-homologacao.svrs.rs.gov.br/WS/NFComConsulta/NFComConsulta.asmx',
+          status: 'https://nfcom-homologacao.svrs.rs.gov.br/WS/NFComStatusServico/NFComStatusServico.asmx',
+          evento: 'https://nfcom-homologacao.svrs.rs.gov.br/WS/NFComRecepcaoEvento/NFComRecepcaoEvento.asmx'
+        }
+      }
+    end
+
+    def webservices_producao
+      {
+        PE: {
+          recepcao: 'https://nfcom.svrs.rs.gov.br/WS/NFComRecepcao/NFComRecepcao.asmx',
+          consulta: 'https://nfcom.svrs.rs.gov.br/WS/NFComConsulta/NFComConsulta.asmx',
+          status: 'https://nfcom.svrs.rs.gov.br/WS/NFComStatusServico/NFComStatusServico.asmx',
+          evento: 'https://nfcom.svrs.rs.gov.br/WS/NFComRecepcaoEvento/NFComRecepcaoEvento.asmx'
+        }
+      }
+    end
+  end
+end

data/lib/nfcom/errors.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Nfcom
+  module Errors
+    class Error < StandardError; end
+
+    class ConfigurationError < Error; end
+    class CertificateError < Error; end
+    class ValidationError < Error; end
+    class XmlError < Error; end
+    class SefazError < Error; end
+    class SefazIndisponivel < SefazError; end
+
+    class NotaRejeitada < SefazError
+      attr_reader :codigo, :motivo
+
+      def initialize(codigo, motivo)
+        @codigo = codigo
+        @motivo = motivo
+        super("Nota rejeitada [#{codigo}]: #{motivo}")
+      end
+    end
+
+    class NotaDenegada < SefazError; end
+    class TimeoutError < Error; end
+  end
+end

data/lib/nfcom/helpers/consulta.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Nfcom
+  module Helpers
+    module Consulta
+      # Returns the URL to confirm an already-authorized NFCom
+      #
+      # @param chave [String] Chave de acesso da NFCom (44 chars)
+      # @param ambiente [Symbol] :homologacao or :producao (optional, defaults to current config)
+      # @return [String] URL to confirm the nota
+      def self.url(chave:, ambiente: Nfcom.configuration.ambiente)
+        raise ArgumentError, 'Chave de acesso inválida' unless chave&.length == 44
+
+        tp_amb = (ambiente == :producao ? 1 : 2)
+        "https://dfe-portal.svrs.rs.gov.br/nfcom/qrcode?chNFCom=#{chave}&tpAmb=#{tp_amb}"
+      end
+
+      # Optional: parse the chave from a full XML string
+      #
+      # @param xml [String] NFCom XML (as stored in :xml_autorizado)
+      # @return [String] chave de acesso
+      def self.chave_from_xml(xml)
+        doc = Nokogiri::XML(xml)
+        doc.at_xpath('//NFCom/infNFCom/@Id')&.value&.sub(/^NFCom/, '')
+      end
+    end
+  end
+end

data/lib/nfcom/models/assinante.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module Nfcom
+  module Models
+    # Representa os dados do assinante do serviço de comunicação
+    class Assinante
+      include Utils::Helpers
+
+      attr_accessor :codigo,                # iCodAssinante - Código único (1-30 chars)
+                    :tipo,                  # tpAssinante - Tipo de assinante (1-8, 99)
+                    :tipo_servico,          # tpServUtil - Tipo de serviço (1-7)
+                    :numero_contrato,       # nContrato - Número do contrato (opcional)
+                    :data_inicio_contrato,  # dContratoIni - Data início (opcional)
+                    :data_fim_contrato,     # dContratoFim - Data fim (opcional)
+                    :terminal_principal,    # NroTermPrinc - Terminal principal (condicional)
+                    :uf_terminal_principal, # cUFPrinc - UF do terminal (condicional)
+                    :terminais_adicionais   # Array de { numero:, uf: } (opcional)
+
+      # Tipos de assinante (tpAssinante) - Domain D18
+      TIPO_COMERCIAL = 1
+      TIPO_INDUSTRIAL = 2
+      TIPO_RESIDENCIAL = 3
+      TIPO_PRODUTOR_RURAL = 4
+      TIPO_ORGAO_PUBLICO = 5
+      TIPO_PRESTADOR_TELECOM = 6
+      TIPO_DIPLOMATICO = 7
+      TIPO_RELIGIOSO = 8
+      TIPO_OUTROS = 99
+
+      # Tipos de serviço (tpServUtil) - Domain D24
+      SERVICO_TELEFONIA = 1
+      SERVICO_DADOS = 2
+      SERVICO_TV = 3
+      SERVICO_INTERNET = 4
+      SERVICO_MULTIMIDIA = 5
+      SERVICO_OUTROS = 6
+      SERVICO_VARIOS = 7
+
+      def initialize(attrs = {})
+        @codigo = attrs[:codigo]
+        @tipo = attrs[:tipo]
+        @tipo_servico = attrs[:tipo_servico]
+        @numero_contrato = attrs[:numero_contrato]
+        @data_inicio_contrato = attrs[:data_inicio_contrato]
+        @data_fim_contrato = attrs[:data_fim_contrato]
+        @terminal_principal = attrs[:terminal_principal]
+        @uf_terminal_principal = attrs[:uf_terminal_principal]
+        @terminais_adicionais = attrs[:terminais_adicionais] || []
+      end
+
+      def valido?
+        erros.empty?
+      end
+
+      def erros # rubocop:disable Metrics/MethodLength
+        errors = []
+
+        # Validações de campos obrigatórios
+        errors << 'Código do assinante é obrigatório' if codigo.to_s.strip.empty?
+        errors << 'Tipo de assinante é obrigatório' if tipo.nil?
+        errors << 'Tipo de serviço é obrigatório' if tipo_servico.nil?
+
+        # Validações declarativas de formato/schema
+        campos = {
+          codigo: { valor: codigo, validador: :er59, nome: 'Código do assinante' }
+        }
+
+        # Só valida tipo se não for nil (já checado acima)
+        campos[:tipo] = { valor: tipo, validador: :d18, nome: 'Tipo de assinante' } unless tipo.nil?
+        unless tipo_servico.nil?
+          campos[:tipo_servico] =
+            { valor: tipo_servico, validador: :d24, nome: 'Tipo de serviço' }
+        end
+
+        # Adicionar campos opcionais apenas se informados
+        if numero_contrato && !numero_contrato.to_s.strip.empty?
+          campos[:numero_contrato] = { valor: numero_contrato, validador: :er60, nome: 'Número do contrato' }
+        end
+
+        if data_inicio_contrato && !data_inicio_contrato.to_s.strip.empty?
+          campos[:data_inicio] = { valor: data_inicio_contrato, validador: :er48, nome: 'Data de início' }
+        end
+
+        if data_fim_contrato && !data_fim_contrato.to_s.strip.empty?
+          campos[:data_fim] = { valor: data_fim_contrato, validador: :er48, nome: 'Data de fim' }
+        end
+
+        # Executar validações declarativas
+        errors.concat(Validators::SchemaValidator.validar_campos(campos))
+
+        # Validação lógica: data fim >= data início
+        if data_inicio_contrato && data_fim_contrato &&
+           !data_inicio_contrato.to_s.strip.empty? && !data_fim_contrato.to_s.strip.empty?
+          begin
+            inicio = Date.parse(data_inicio_contrato.to_s)
+            fim = Date.parse(data_fim_contrato.to_s)
+            errors << 'Data de fim do contrato não pode ser anterior à data de início' if fim < inicio
+          rescue ArgumentError
+            # Erro de parsing já foi capturado pelas validações declarativas
+          end
+        end
+
+        # Validações de terminal principal (condicional)
+        if terminal_principal && !terminal_principal.to_s.strip.empty?
+          # Se informou terminal, UF é obrigatória
+          if uf_terminal_principal.to_s.strip.empty?
+            errors << 'UF do terminal principal é obrigatória quando o número do terminal é informado'
+          else
+            # Validar formato do terminal e UF
+            campos_terminal = {
+              terminal: { valor: terminal_principal, validador: :telefone, nome: 'Terminal principal' },
+              uf_terminal: { valor: uf_terminal_principal, validador: :d5, nome: 'UF do terminal' }
+            }
+            errors.concat(Validators::SchemaValidator.validar_campos(campos_terminal))
+          end
+        elsif uf_terminal_principal && !uf_terminal_principal.to_s.strip.empty?
+          # Se informou UF mas não informou terminal
+          errors << 'Número do terminal principal é obrigatório quando a UF é informada'
+        end
+
+        # Validações de terminais adicionais
+        terminais_adicionais&.each_with_index do |terminal, index|
+          if terminal[:numero].to_s.strip.empty?
+            errors << "Terminal adicional #{index + 1}: número é obrigatório"
+          else
+            campos_adicional = {
+              numero: { valor: terminal[:numero], validador: :telefone, nome: "Terminal adicional #{index + 1}" }
+            }
+            errors.concat(Validators::SchemaValidator.validar_campos(campos_adicional))
+          end
+
+          if terminal[:uf].to_s.strip.empty?
+            errors << "Terminal adicional #{index + 1}: UF é obrigatória"
+          else
+            campos_uf = {
+              uf: { valor: terminal[:uf], validador: :d5, nome: "UF do terminal adicional #{index + 1}" }
+            }
+            errors.concat(Validators::SchemaValidator.validar_campos(campos_uf))
+          end
+        end
+
+        errors
+      end
+    end
+  end
+end

data/lib/nfcom/models/destinatario.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+module Nfcom
+  module Models
+    # Representa o destinatário (cliente) da NF-COM
+    #
+    # O destinatário é o tomador do serviço de comunicação/telecomunicação,
+    # podendo ser pessoa física (CPF) ou pessoa jurídica (CNPJ).
+    #
+    # @example Criar destinatário pessoa física
+    #   destinatario = Nfcom::Models::Destinatario.new(
+    #     cpf: '12345678901',
+    #     razao_social: 'João da Silva',
+    #     tipo_assinante: :residencial,
+    #     email: 'joao@email.com',
+    #     endereco: {
+    #       logradouro: 'Rua das Flores',
+    #       numero: '123',
+    #       bairro: 'Centro',
+    #       municipio: 'Recife',
+    #       uf: 'PE',
+    #       cep: '50000-000',
+    #       codigo_municipio: '2611606'
+    #     }
+    #   )
+    #
+    # @example Criar destinatário pessoa jurídica
+    #   destinatario = Nfcom::Models::Destinatario.new(
+    #     cnpj: '12345678000100',
+    #     razao_social: 'Empresa LTDA',
+    #     tipo_assinante: :comercial,
+    #     inscricao_estadual: '0123456789',
+    #     email: 'contato@empresa.com',
+    #     endereco: { ... }
+    #   )
+    #
+    # @example Validar destinatário
+    #   if destinatario.valido?
+    #     puts "Destinatário válido"
+    #   else
+    #     puts "Erros: #{destinatario.erros.join(', ')}"
+    #   end
+    #
+    # Tipos de assinante disponíveis:
+    # - :comercial (1) - Estabelecimentos comerciais
+    # - :industrial (2) - Indústrias
+    # - :residencial (3) - Residências (padrão para provedores)
+    # - :produtor_rural (4) - Produtores rurais
+    # - :orgao_publico (5) - Órgãos públicos
+    # - :prestador_servico (6) - Prestadores de serviço
+    # - :concessionaria (7) - Concessionárias
+    # - :outros (99) - Outros
+    #
+    # Atributos obrigatórios:
+    # - CNPJ ou CPF (pelo menos um)
+    # - razao_social (nome ou razão social)
+    # - endereco completo
+    #
+    # Atributos opcionais:
+    # - inscricao_estadual (apenas para PJ)
+    # - email (recomendado para envio da nota)
+    #
+    # Validações automáticas:
+    # - Validação de dígitos verificadores de CPF/CNPJ
+    # - Rejeita CPF/CNPJ com todos dígitos iguais
+    # - Valida campos obrigatórios do endereço
+    class Destinatario
+      include Utils::Helpers
+
+      attr_accessor :cnpj, :cpf, :razao_social, :inscricao_estadual,
+                    :tipo_assinante, :endereco, :email
+
+      # Tipos de assinante
+      TIPO_ASSINANTE = {
+        comercial: 1,
+        industrial: 2,
+        residencial: 3,
+        produtor_rural: 4,
+        orgao_publico: 5,
+        prestador_servico: 6,
+        concessionaria: 7,
+        outros: 99
+      }.freeze
+
+      def initialize(attributes = {})
+        @endereco = Endereco.new
+        @tipo_assinante = :residencial # padrão para provedor de internet
+
+        attributes.each do |key, value|
+          if key == :endereco && value.is_a?(Hash)
+            @endereco = Endereco.new(value)
+          elsif respond_to?("#{key}=")
+            send("#{key}=", value)
+          end
+        end
+      end
+
+      def valido?
+        erros.empty?
+      end
+
+      def erros
+        errors = []
+        errors << 'CNPJ ou CPF é obrigatório' if cnpj.to_s.strip.empty? && cpf.to_s.strip.empty?
+        errors << 'CNPJ inválido' if !cnpj.to_s.strip.empty? && !cnpj_valido?(cnpj)
+        errors << 'CPF inválido' if !cpf.to_s.strip.empty? && !cpf_valido?(cpf)
+        errors << 'Razão social é obrigatória' if razao_social.to_s.strip.empty?
+        errors.concat(endereco.erros.map { |e| "Endereço: #{e}" }) unless endereco.valido?
+
+        campos = {}
+
+        campos[:razao_social] = {
+          valor: razao_social,
+          validador: :er47,
+          nome: 'Razão social',
+          max: 60
+        }
+
+        campos[:email] = { valor: email, validador: :er72, nome: 'Email' } if email && !email.to_s.strip.empty?
+        errors.concat(Validators::SchemaValidator.validar_campos(campos))
+
+        errors
+      end
+
+      def tipo_assinante_codigo
+        TIPO_ASSINANTE[tipo_assinante] || TIPO_ASSINANTE[:residencial]
+      end
+
+      def pessoa_fisica?
+        !cpf.to_s.strip.empty?
+      end
+
+      def pessoa_juridica?
+        !cnpj.to_s.strip.empty?
+      end
+    end
+  end
+end

data/lib/nfcom/models/emitente.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Nfcom
+  module Models
+    # Representa o emitente da NF-COM
+    #
+    # O emitente é a empresa prestadora do serviço de comunicação que está
+    # emitindo a nota fiscal. Deve ser sempre pessoa jurídica (CNPJ).
+    #
+    # @example Criar emitente completo
+    #   emitente = Nfcom::Models::Emitente.new(
+    #     cnpj: '12345678000100',
+    #     razao_social: 'Provedor Internet LTDA',
+    #     nome_fantasia: 'Meu Provedor',
+    #     inscricao_estadual: '0123456789',
+    #     inscricao_municipal: '987654',
+    #     cnae: '6190-6/01',
+    #     regime_tributario: :simples_nacional,
+    #     endereco: {
+    #       logradouro: 'Av. Principal',
+    #       numero: '1000',
+    #       complemento: 'Sala 101',
+    #       bairro: 'Centro',
+    #       municipio: 'Recife',
+    #       uf: 'PE',
+    #       cep: '50000-000',
+    #       codigo_municipio: '2611606'
+    #     }
+    #   )
+    #
+    # @example Validar emitente
+    #   if emitente.valido?
+    #     puts "Emitente válido"
+    #   else
+    #     puts "Erros: #{emitente.erros.join(', ')}"
+    #   end
+    #
+    # Atributos obrigatórios:
+    # - cnpj (14 dígitos, com validação)
+    # - razao_social (razão social da empresa)
+    # - inscricao_estadual (IE do estado)
+    # - endereco completo
+    #
+    # Atributos opcionais:
+    # - nome_fantasia (nome de fantasia/comercial)
+    # - inscricao_municipal (IM do município)
+    # - cnae (classificação da atividade econômica)
+    # - regime_tributario (1=Simples Nacional, 2=Simples Excesso, 3=Normal)
+    #
+    # Validações automáticas:
+    # - Validação de dígitos verificadores do CNPJ
+    # - Rejeita CNPJ com todos dígitos iguais
+    # - Valida presença de campos obrigatórios
+    # - Valida campos obrigatórios do endereço
+    #
+    # @note O emitente deve estar cadastrado e credenciado na SEFAZ para
+    #   emissão de NF-COM antes de usar esta gem.
+    class Emitente
+      include Utils::Helpers
+
+      attr_accessor :cnpj, :razao_social, :nome_fantasia, :inscricao_estadual,
+                    :inscricao_municipal, :cnae, :regime_tributario, :endereco
+
+      # Códigos de Regime Tributário (CRT)
+      REGIME_TRIBUTARIO = {
+        simples_nacional: 1,
+        simples_excesso: 2,
+        normal: 3
+      }.freeze
+
+      def initialize(attributes = {})
+        @endereco = Endereco.new
+        @regime_tributario = :normal # Padrão: Regime Normal
+
+        attributes.each do |key, value|
+          if key == :endereco && value.is_a?(Hash)
+            @endereco = Endereco.new(value)
+          elsif respond_to?("#{key}=")
+            send("#{key}=", value)
+          end
+        end
+      end
+
+      # Retorna o código do regime tributário para o XML
+      # @return [Integer] Código do regime tributário (1, 2 ou 3)
+      def regime_tributario_codigo
+        REGIME_TRIBUTARIO[regime_tributario] || REGIME_TRIBUTARIO[:normal]
+      end
+
+      def valido?
+        erros.empty?
+      end
+
+      def erros
+        errors = []
+        errors << 'CNPJ é obrigatório' if cnpj.to_s.strip.empty?
+        errors << 'CNPJ inválido' unless cnpj_valido?(cnpj)
+        errors << 'Razão social é obrigatória' if razao_social.to_s.strip.empty?
+        errors << 'Inscrição estadual é obrigatória' if inscricao_estadual.to_s.strip.empty?
+        errors.concat(endereco.erros.map { |e| "Endereço: #{e}" }) unless endereco.valido?
+        errors
+      end
+    end
+  end
+end