br_nfe 2.1.1 → 2.2.0

data/lib/br_nfe/product/operation/base.rb

@@ -0,0 +1,255 @@
+module BrNfe
+	module Product
+		module Operation
+			class Base < BrNfe::Base
+				include NfXmlValue
+
+				# Serve para saber se vai usar o módo de contingência, e se usar,
+				# serve para saber qual o tipo de contingência será utilizado.
+				# Options: [:normal, :svc]
+				#
+				# <b>Required: </b> _Yes_
+				# <b>Default: </b> _:normal_
+				#
+				attr_accessor :tipo_emissao
+
+				# Informações que devem ser informadas quando a operação for em contingência.
+				#
+				attr_accessor :motivo_contingencia
+				attr_accessor :inicio_contingencia # Data e hora do início da contingência
+				def inicio_contingencia
+					convert_to_time(@inicio_contingencia)
+				end
+
+				# String XML que será aplicado o resultado da resposta do serviço
+				# de acordo com a operação.
+				# Por exemplo, quando vai consultar o protocolo da emissão de uma nfe,
+				# deve ser passado por parâmetro o XML da NF-e para que seja possível obter
+				# o XML da nota fiscal junto com o protocolo de autorização.
+				# Também quando for cancelar uma nota fiscal deve passar o XML da nota para
+				# que seja adicionado o protocolo de confirmação de cancelamento junto a nota.
+				#
+				# <b>Required: </b> _No_
+				# <b>Type:     </b> _String_ XML
+				# 
+				attr_accessor :original_xml
+				
+				validates :tipo_emissao, inclusion: {in: [:normal, :svc]}
+				validates :inicio_contingencia, presence: true,                        if: :contingencia?
+				validates :motivo_contingencia, length: { minimum: 15, maximum: 256 }, if: :contingencia?
+
+				def default_values
+					{
+						tipo_emissao:   :normal,
+					}
+				end
+
+				def certificado_obrigatorio?
+					true
+				end
+
+				# Para as Notas fiscais de produto a autenticação via SSL é obrigatória
+				def ssl_request?
+					true
+				end
+
+				# O Gateway é responsável de identificar o Webservice de acordo com o Estado(UF).
+				# Irá identificar o webservice através do valor do método `ibge_code_of_issuer_uf`, 
+				# na qual pode ser setado diretamente ou pego através do endereço do emissor.
+				# Para ver a lista de WebService por estado acesse: http://www.nfe.fazenda.gov.br/portal/webServices.aspx
+				#
+				# <b>Tipo de retorno: </b> _Object (Gateway::Base ou derivados)_
+				#
+				def gateway
+					@gateway ||= case tipo_emissao
+					when :normal
+						get_gateway_by_normal_operation
+					when :svc
+						get_gateway_by_svc_operation					
+					end
+				end
+
+				# WebServices utilizados para contingência em SVC (Servidor Virtual de Contingência)
+				# Existe 2 servidores de contingência para SVC: O `SVC-AN` e `SVC-RS`
+				# Cada estado(UF) é autorizado a emitir notas em contingência em apenas 1 dos servidores.
+				# Esse método é responsável em setar qual o WebService será utilizado para cada UF.
+				#
+				# <b>Tipo de retorno: </b> _Object (::WebServiceSvcRS ou ::WebServiceSvcAN)_
+				#
+				def get_gateway_by_svc_operation
+					case ibge_code_of_issuer_uf
+					#    'AM', 'BA', 'CE', 'GO', 'MA', 'MS', 'MT', 'PA', 'PE', 'PI', 'PR'
+					when '13', '29', '23', '52', '21', '50', '51', '15', '26', '22', '41'
+						BrNfe::Product::Gateway::WebServiceSvcRS.new({env: env})
+					else # AC, AL, AP, DF, ES, MG, PB, RJ, RN, RO, RR, RS, SC, SE, SP, TO 
+						BrNfe::Product::Gateway::WebServiceSvcAN.new({env: env})					
+					end
+				end
+
+				# Seta o WebService quando o tipo de emissão for normal para cada UF
+				#
+				# <b>Tipo de retorno: </b> _Object (Gateway::Base ou derivados)_
+				#
+				def get_gateway_by_normal_operation				
+					case ibge_code_of_issuer_uf
+					when '13'
+						BrNfe::Product::Gateway::WebServiceAM.new({env: env})
+					when '29'
+						BrNfe::Product::Gateway::WebServiceBA.new({env: env})
+					when '23'
+						BrNfe::Product::Gateway::WebServiceCE.new({env: env})
+					when '52'
+						BrNfe::Product::Gateway::WebServiceGO.new({env: env})
+					when '31'
+						BrNfe::Product::Gateway::WebServiceMG.new({env: env})
+					when '50'
+						BrNfe::Product::Gateway::WebServiceMS.new({env: env})
+					when '51'
+						BrNfe::Product::Gateway::WebServiceMT.new({env: env})
+					when '26'
+						BrNfe::Product::Gateway::WebServicePE.new({env: env})
+					when '41'
+						BrNfe::Product::Gateway::WebServicePR.new({env: env})
+					when '43'
+						BrNfe::Product::Gateway::WebServiceRS.new({env: env})
+					when '35'
+						BrNfe::Product::Gateway::WebServiceSP.new({env: env})
+					when '21', '15', '22'
+						BrNfe::Product::Gateway::WebServiceSVAN.new({env: env})
+					else
+						BrNfe::Product::Gateway::WebServiceSVRS.new({env: env})
+					end
+				end
+
+				# Valor utilizado para inserir a url do xmlns nas tags nfeCabecMsg e nfeDadosMsg.
+				# Como a url pode variar de acordo com o tipo de serviço e UF, deve ser sobrescrita
+				# na subclass de cada serviço.
+				#
+				# <b>Tipo de retorno: </b> _String_
+				#
+				def url_xmlns
+					raise "O método #url_xmlns deve ser implementar em cada operação"
+				end
+
+				# Irá retornar a versão setada de acordo com o serviço e estado.
+				# Deve ser sobrescrito para cada serviço e irá pegar a versão do XML
+				# de acordo com o Estado e Serviço, conforme descrito em: http://www.nfe.fazenda.gov.br/portal/webServices.aspx
+				#
+				# <b>Tipo de retorno: </b> _Symbol_
+				#
+				def gateway_xml_version
+					raise "O método #gateway_xml_version deve ser implementar em cada operação"
+				end
+
+				# Versão do XML utilizado na requisição.
+				# Como a versão do XML pode divergir para cada estado/servidor e serviço,
+				# é necessário passar a versão do XML na requisição para o servidor saber qual
+				# validação aplicar e como pegar os dados.
+				# Esse método tem o intuíto de pegar a versão setada no Gateway de cada UF e serviço
+				# e transformar em uma String aplicável no XML.
+				# Exemplo:
+				#    Se a versão do xml for :v3_10
+				#    Esse método irá transformar o valor em '3.10'
+				#
+				# <b>Tipo de retorno: </b> _String_
+				#
+				def xml_version
+					"#{gateway_xml_version}".gsub('_','.').gsub(/[^\d\.]/,'')
+				end
+
+				# Declaro que o método `render_xml` irá verificar os arquivos também presentes
+				# nos diretórios especificados.
+				# O diretório dos XMLs irá variar de acordo com a operação e a versão do XML utilizado.
+				# EX:
+				#   Se a versão do XML que a operação utiliza for a versão 2.0, então irá procurar o arquivo
+				#   XML primeiro no diretório da v2, caso não encontre vai procurar no diretório da v1.
+				#   Já se a versão do XML for a versão 3.1, irá procurar primeiro no diretório v3_10,
+				#   se não contrar irá procurar no diretório da v2_00, e se ainda assim não encontrar, vai procurar
+				#   no diretório v1_00.
+				# Foi construido dessa forma pois algumas tags utilizadas na v3.10 são exatamente iguais
+				# da v2.0, e nesse caso não há a necessidade de duplicar o código.
+				#
+				# <b>Tipo de retorno: </b> _Array_
+				def xml_current_dir_path
+					return @xml_current_dir_path if @xml_current_dir_path.present?
+					paths = ["#{BrNfe.root}/lib/br_nfe/product/xml/v1_00"] # Sempre terá o path da v1_00
+					paths << "#{BrNfe.root}/lib/br_nfe/product/xml/v1_10" if gateway_xml_version >= :v1_10
+					paths << "#{BrNfe.root}/lib/br_nfe/product/xml/v2_00" if gateway_xml_version >= :v2_00
+					paths << "#{BrNfe.root}/lib/br_nfe/product/xml/v2_01" if gateway_xml_version >= :v2_01
+					paths << "#{BrNfe.root}/lib/br_nfe/product/xml/v3_10" if gateway_xml_version == :v3_10
+					
+					@xml_current_dir_path = paths.reverse+["#{BrNfe.root}/lib/br_nfe/product/xml"]+super
+				end
+				
+				# Método utilizado para saber se a operação será em contingência.
+				#
+				# <b>Tipo de retorno: </b> _Boolean_
+				#
+				def contingencia?
+					tipo_emissao != :normal
+				end
+
+				# Código do Tipo de Emissão da NF-e
+				#  ✓ 1=Emissão normal (não em contingência);
+				#  ✕ 2=Contingência FS-IA, com impressão do DANFE em formulário de segurança;
+				#  ✕ 3=Contingência SCAN (Sistema de Contingência do Ambiente Nacional);
+				#  ✕ 4=Contingência DPEC (Declaração Prévia da Emissão em Contingência);
+				#  ✕ 5=Contingência FS-DA, com impressão do DANFE em formulário de segurança;
+				#  ✓ 6=Contingência SVC-AN (SEFAZ Virtual de Contingência do AN);
+				#  ✓ 7=Contingência SVC-RS (SEFAZ Virtual de Contingência do RS);
+				#  ✓ 9=Contingência off-line da NFC-e (as demais opções de contingência são válidas 
+				#      também para a NFC-e).
+				#  Para a NFC-e somente estão disponíveis e são válidas as opções de contingência 5 e 9.
+				def codigo_tipo_emissao(nfe)
+					return 9 if nfe.nfce?
+					case tipo_emissao
+					when :normal 
+						1
+					when :svc
+						if gateway.is_a?(BrNfe::Product::Gateway::WebServiceSvcAN) # SVC-AN
+							6
+						else # SVC-RS
+							7
+						end
+					end
+				end
+
+				def request
+					@savon_response = client_wsdl.call(method_wsdl, xml: soap_xml)
+				rescue Savon::SOAPFault => error
+					return @response = response_class_builder.new.response_class.new(request_status: :soap_error,    request_message_error: error.message)
+				rescue Savon::HTTPError => error
+					return @response = response_class_builder.new.response_class.new(request_status: :http_error,    request_message_error: error.message)
+				rescue Exception => error
+					return @response = response_class_builder.new.response_class.new(request_status: :unknown_error, request_message_error: error.message)
+				end
+
+				def response
+					@response ||= get_response
+				end
+
+			private
+				def emitente_class
+					BrNfe.emitente_product_class
+				end
+
+				def response_class_builder
+					raise NotImplementedError.new("Not implemented #response_class_builder in #{self}.")
+				end
+
+				def builder_response_params
+					{}
+				end
+
+				def get_response
+					builder = response_class_builder.new do |builder|
+						builder.savon_response = @savon_response
+						builder.operation      = self
+					end
+					builder.assign_attributes(builder_response_params)
+					builder.response
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/operation/nfe_autorizacao.rb

@@ -0,0 +1,118 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeAutorizacao < Base
+
+				# NÚMERO DO LOTE
+				# Identificador de controle do envio do lote.
+				# Número sequencial autoincremental, de controle
+				# correspondente ao identificador único do lote
+				# enviado. A responsabilidade de gerar e controlar
+				# esse número é exclusiva do contribuinte.
+				# 
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _20161230135547_
+				# <b>Length:   </b> _max: 15_
+				# <b>tag:      </b> idLote
+				#
+				attr_accessor :numero_lote
+				alias_attribute :idLote, :numero_lote
+
+				# INDICADOR DO PROCESSAMENTO SINCRONO OU ASINCRONO
+				# false = 0=Não. (Default)
+				# true  = 1=Empresa solicita processamento síncrono do
+				#         Lote de NF-e (sem a geração de Recibo para consulta futura);
+				#
+				# Nota: O processamento síncrono do Lote corresponde a entrega 
+				# da resposta do processamento das NF-e do Lote, sem a geração
+				# de um Recibo de Lote para consulta futura. A resposta de forma 
+				# síncrona pela SEFAZ Autorizadora só ocorrerá se:
+				# - a empresa solicitar e constar unicamente uma NF-e no Lote;
+				# - a SEFAZ Autorizadora implementar o processamento síncrono 
+				#   para a resposta do Lote de NF-e.
+				# 
+				# <b>Type:     </b> _Boolean_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _true_
+				# <b>Default:  </b> _false_
+				# <b>tag:      </b> indSinc
+				#
+				attr_accessor :sincrono
+				def sincrono
+					convert_to_boolean(@sincrono)
+				end
+				alias_attribute :indSinc, :sincrono
+				
+				# Array com as notas fiscais a serem emitidas
+				# Pode ser adicionado os dados das notas fiscais em forma de `Hash` ou
+				# O próprio objeto da NF-e.
+				#
+				# Exemplo com Hash:
+				#    self.notas_fiscais = [{serie: 1, numero_nf: 1143, ...},{serie: 1, numero_nf: 1144, ...}]
+				#    self.notas_fiscais << {serie: 1, numero_nf: 1145, ...}
+				#    self.notas_fiscais << {serie: 1, numero_nf: 1146, ...}
+				#
+				# Exemplo com Objetos:
+				#    self.notas_fiscais = [BrNfe::Product::NotaFiscal.new({serie: 1, numero_nf: 1143, ...}),{serie: 1, numero_nf: 1144, ...}]
+				#    self.notas_fiscais << BrNfe::Product::NotaFiscal.new({serie: 1, numero_nf: 1145, ...})
+				#    self.notas_fiscais << {serie: 1, numero_nf: 1146, ...}
+				#
+				# Sempre vai retornar um Array de objetos da class configurada em `BrNfe.nota_fiscal_product_class`
+				#
+				# <b>Tipo: </b> _BrNfe.nota_fiscal_product_class (BrNfe::Product::NotaFiscal)_
+				# <b>Min: </b> _1_
+				# <b>Max: </b> _50_
+				# <b>Default: </b> _[]_
+				#
+				has_many :notas_fiscais, 'BrNfe.nota_fiscal_product_class'
+
+				
+				validate_has_many :notas_fiscais, message: :invalid_invoice
+				validates :notas_fiscais, length: {in: 1..50}
+				validates :numero_lote, presence: true
+				validates :numero_lote, numericality: {only_integer: true}, allow_blank: true
+				validates :numero_lote, length: {maximum: 15}, allow_blank: true
+
+				# URL que será setada no atribto xmlns do XML;
+				# Ex:
+				# nfeCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NfeStatusServico2"
+				def url_xmlns
+					gateway.url_xmlns_autorizacao
+				end
+
+				# URL do webservice para enviar as informações.
+				# Ex:
+				# https://www.sefazvirtual.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx?wsdl
+				def wsdl
+					gateway.wsdl_autorizacao
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_autorizacao
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_autorizacao
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_autorizacao
+				end
+
+				# XML que será enviado no body da requisição SOAP contendo as informações
+				# específicas de cada operação.
+				def xml_builder
+					@xml_builder ||= render_xml 'root/NfeAutorizacao'
+				end
+
+				def response_class_builder
+					BrNfe::Product::Response::Build::NfeAutorizacao
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/operation/nfe_consulta_protocolo.rb

@@ -0,0 +1,61 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeConsultaProtocolo < Base
+				# CHAVE DE ACESSO DA NF-E.
+				# 
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _42000082176983000186550000000000006313331836_
+				# <b>Length:   </b> _44_
+				# <b>tag:      </b> chNFe
+				#
+				attr_accessor :chave_nfe
+				alias_attribute :chNFe, :chave_nfe
+
+
+				validates :chave_nfe, presence: true
+				validates :chave_nfe, length: {is: 44}, allow_blank: true
+
+				# URL do webservice para enviar as informações.
+				# Ex:
+				# https://www.sefazvirtual.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx?wsdl
+				def wsdl
+					gateway.wsdl_consulta_protocolo
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_consulta_protocolo
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_consulta_protocolo
+				end
+
+				# URL que será setada no atribto xmlns do XML;
+				# Ex:
+				# nfeCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NfeStatusServico2"
+				def url_xmlns
+					gateway.url_xmlns_consulta_protocolo
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_consulta_protocolo
+				end
+
+				# XML que será enviado no body da requisição SOAP contendo as informações
+				# específicas de cada operação.
+				def xml_builder
+					@xml_builder ||= render_xml 'root/NfeConsultaProtocolo'
+				end
+
+				def response_class_builder
+					BrNfe::Product::Response::Build::NfeConsultaProtocolo
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/operation/nfe_download_nf.rb

@@ -0,0 +1,86 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeDownloadNf < Base
+				# UTILIZADO PARA FORÇAR A UTILIZAÇÃO DE OUTRO GATEWAY
+				#  O Gateway padrão da GEM para o download da NF é o
+				#  webservice do AN(Ambiente Nacional) (Exceto para o estado do
+				#  Ceará(CE), na qual possui url própria para download da NF).
+				#  Outro Webservice que pode ser utilizado é do SVAN (Servidor Virtual do
+				#  Ambiente Nacional).
+				#  Pode ser modificado o servidor passando o attr :force_gateway com 
+				#  um dos seguintes valores:
+				#  - :SVAN - Na qual irá forçar o uso do Servidor Virtual do Ambiente Nacional
+				#  - :AN - Na qual irá forçar o uso do Ambiente Nacional (apenas para o estado
+				#          do Ceará, já que esse é o servidor padrão para os demais estados)
+				# 
+				# <b>Type:     </b> _Symbol_
+				# <b>Required: </b> _No_
+				# <b>Example:  </b> _:SVAN_
+				# <b>Default:  </b> _nil_
+				#
+				attr_accessor :force_gateway
+				def force_gateway=(value)
+					@force_gateway = "#{value}".to_sym
+				end
+
+				# CHAVE DE ACESSO DA NF-E.
+				# 
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _42000082176983000186550000000000006313331836_
+				# <b>Length:   </b> _44_
+				# <b>tag:      </b> chNFe
+				#
+				attr_accessor :chave_nfe
+				alias_attribute :chNFe, :chave_nfe
+
+				validates :chave_nfe, presence: true
+				validates :chave_nfe, length: {is: 44}
+
+				def gateway
+					@gateway ||= case force_gateway
+					when :SVAN
+						BrNfe::Product::Gateway::WebServiceSVAN.new({env: env})
+					when :AN
+						BrNfe::Product::Gateway::Base.new({env: env})
+					else
+						super
+					end
+				end
+
+
+				# URL do webservice para enviar as informações.
+				def wsdl
+					gateway.wsdl_download_nf
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_download_nf
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_download_nf
+				end
+
+				# URL que será setada no atribto xmlns do XML;
+				def url_xmlns
+					gateway.url_xmlns_download_nf
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_download_nf
+				end
+
+				# XML que será enviado no body da requisição SOAP contendo as informações
+				# específicas de cada operação.
+				def xml_builder
+					@xml_builder ||= render_xml 'root/NfeDownloadNf'
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/operation/nfe_inutilizacao.rb

@@ -0,0 +1,168 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeInutilizacao < Base
+
+				# Identificador da TAG a ser assinada formada com:
+				# 01-02 = Literal 'ID' (2 posições) +
+				# 03-04 = Código da UF (2 posições) + 
+				# 05-06 = Ano (2 posições) + 
+				# 07-20 = CNPJ (14 posições) +
+				# 21-22 = modelo (2 posições) +
+				# 23-25 = série (3 posições) + 
+				# 26-34 = Numeração inicial (9 posições) +
+				# 35-43 = Numeração final (9 posições)
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _ID41140616149400017255001000000002000000002_
+				# <b>Length:   </b> _43_
+				# <b>tag:      </b> Id
+				#
+				attr_accessor :chave
+				def chave
+					@chave = generate_key if @chave.blank?
+					@chave
+				end
+				alias_attribute :Id, :chave
+
+				# ANO DE INUTILIZAÇÃO DA NUMERAÇÃO
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _17_
+				# <b>Length:   </b> _2_
+				# <b>tag:      </b> Id
+				#
+				attr_accessor :ano
+
+				# Código do Modelo do Documento Fiscal
+				# 55=NF-e emitida em substituição ao modelo 1 ou 1A; (Default)
+				# 65=NFC-e, utilizada nas operações de venda no varejo (a critério da UF aceitar este modelo de documento).
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Default:  </b> _55_
+				# <b>Length:   </b> _2_
+				# <b>tag:      </b> mod
+				#
+				attr_accessor :modelo_nf
+				alias_attribute :mod, :modelo_nf
+
+				# Série da NF-e
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Default:  </b> _nil_
+				# <b>Length:   </b> _max: 3_
+				# <b>tag:      </b> serie
+				#
+				attr_accessor :serie
+
+				# Número da NF-e inicial a ser inutilizada
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Length:   </b> _max: 9_
+				# <b>tag:      </b> nNFIni
+				#
+				attr_accessor :numero_nf_inicial
+				alias_attribute :nNFIni, :numero_nf_inicial
+
+				# Número da NF-e final a ser inutilizada
+				#
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Default:  </b> _self.numero_nf_inicial_
+				# <b>Length:   </b> _max: 9_
+				# <b>tag:      </b> nNFFin
+				#
+				attr_accessor :numero_nf_final
+				def numero_nf_final
+					@numero_nf_final ||= numero_nf_inicial
+				end
+				alias_attribute :nNFFin, :numero_nf_final
+
+				# Informar a justificativa do pedido de inutilização
+				#
+				# <b>Type:     </b> _String_
+				# <b>Required: </b> _Yes_
+				# <b>Length:   </b> _min: 15, max: 255_
+				# <b>tag:      </b> xJust
+				#
+				attr_accessor :justificativa
+				alias_attribute :xJust, :justificativa
+
+				validates :chave, presence: true
+				validates :chave, length: {is: 43}, allow_blank: true
+				validates :ano, presence: true
+				validates :ano, length: {is: 2}, allow_blank: true
+
+				validates :modelo_nf, presence: true
+				validates :modelo_nf, inclusion: [55, 65, '55', '65']
+
+				validates :serie, presence: true
+				validates :serie, numericality: { only_integer: true }
+				validates :serie, length: { maximum: 3 }
+
+				validates :numero_nf_inicial, :numero_nf_final, presence: true
+				validates :numero_nf_inicial, :numero_nf_final, numericality: { only_integer: true }, allow_blank: true
+				validates :numero_nf_inicial, :numero_nf_final, length: { maximum: 9 }, allow_blank: true
+
+				validates :justificativa, length: { in: 15..255 }
+				
+				# URL do webservice para enviar as informações.
+				# Ex:
+				# https://www.sefazvirtual.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx?wsdl
+				def wsdl
+					gateway.wsdl_inutilizacao
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_inutilizacao
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_inutilizacao
+				end
+
+				# URL que será setada no atribto xmlns do XML;
+				# Ex:
+				# nfeCabecMsg xmlns="http://www.portalfiscal.inf.br/nfe/wsdl/NfeStatusServico2"
+				def url_xmlns
+					gateway.url_xmlns_inutilizacao
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_inutilizacao
+				end
+
+				# XML que será enviado no body da requisição SOAP contendo as informações
+				# específicas de cada operação.
+				def xml_builder
+					@xml_builder ||= render_xml 'root/NfeInutilizacao'
+				end
+			private
+
+				def response_class_builder
+					BrNfe::Product::Response::Build::NfeInutilizacao
+				end
+
+				def generate_key
+					key =  'ID'
+					key << ibge_code_of_issuer_uf # 03-04 = Código da UF (2 posições)
+					key << "#{ano}".rjust(2, '0') # 05-06 = Ano (2 posições) + 
+					key << "#{emitente.cnpj}".rjust(14, '0') # 07-20 = CNPJ (14 posições) +
+					key << "#{modelo_nf}" # 21-22 = modelo (2 posições) +
+					key << "#{serie}".rjust(3, '0') # 23-25 = série (3 posições) + 
+					key << "#{numero_nf_inicial}".rjust(9, '0')# 26-34 = Numeração inicial (9 posições) +
+					key << "#{numero_nf_final}".rjust(9, '0')# 35-43 = Numeração final (9 posições)
+					key
+				end
+			end
+		end
+	end
+end