br_nfe 2.1.1 → 2.2.0

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

@@ -0,0 +1,70 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeRecepcaoEvento < Base
+
+				# NÚMERO DO LOTE
+				# Identificador de controle do Lote de envio do Evento.
+				# Número sequencial autoincremental único para identificação
+				# do Lote. A responsabilidade de gerar e controlar é exclusiva
+				# do autor do evento. O Web Service não faz qualquer uso
+				# deste identificador.
+				# 
+				# <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
+
+				# EVENTO DE CANCELAMENTO
+				# Só pode haver 1 evento do tipo cancelamento por Lote.
+				#
+				has_one :cancelamento, 'BrNfe.cancelamento_product_class'
+
+				validate_has_one :cancelamento
+
+				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 do webservice para enviar as informações.
+				# Ex:
+				# https://www.sefazvirtual.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx?wsdl
+				def wsdl
+					gateway.wsdl_recepcao_evento
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_recepcao_evento
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_recepcao_evento
+				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_recepcao_evento
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_recepcao_evento
+				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/NfeRecepcaoEvento'
+				end
+			end
+		end
+	end
+end

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

@@ -0,0 +1,63 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeRetAutorizacao < Base
+				# NÚMERO DO RECIBO/PROTOCOLO
+				#  Número gerado pelo Portal da Secretaria de
+				#  Fazenda Estadual
+				# 
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _42201612301355_
+				# <b>Length:   </b> _max: 15_
+				# <b>tag:      </b> nRec
+				#
+				attr_accessor :numero_recibo
+				alias_attribute :nRec, :numero_recibo
+
+				validates :numero_recibo, presence: true
+				validates :numero_recibo, numericality: {only_integer: true}, allow_blank: true
+				validates :numero_recibo, length: {maximum: 15}, 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_retorno_autorizacao
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_retorno_autorizacao
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_retorno_autorizacao
+				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_retorno_autorizacao
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_retorno_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/NfeRetAutorizacao'
+				end
+
+				def response_class_builder
+					BrNfe::Product::Response::Build::NfeRetAutorizacao
+				end
+			end
+		end
+	end
+end

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

@@ -0,0 +1,46 @@
+module BrNfe
+	module Product
+		module Operation
+			class NfeStatusServico < Base
+				# 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_status_servico
+				end
+
+				# URL do webservice para enviar as informações.
+				# Ex:
+				# https://www.sefazvirtual.fazenda.gov.br/NfeInutilizacao2/NfeInutilizacao2.asmx?wsdl
+				def wsdl
+					gateway.wsdl_status_servico
+				end
+
+				# Método SOAP que será chamado para enviar o XML
+				def method_wsdl
+					gateway.operation_status_servico
+				end
+
+				# Versão utilizada pelo webservice do  estado para determinada ação.
+				def gateway_xml_version
+					gateway.version_xml_status_servico
+				end
+
+				# Versão SSL utilizada pelo webservice
+				def ssl_version
+					gateway.ssl_version_status_servico
+				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/NfeStatusServico'
+				end
+
+				def response_class_builder
+					BrNfe::Product::Response::Build::NfeStatusServico
+				end
+			end
+		end
+	end
+end

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

@@ -0,0 +1,97 @@
+module BrNfe
+	module Product
+		module Response
+			class Base < BrNfe::ActiveModelBase
+
+				# XML ORIGINAL ENVIADO PELA SEFAZ
+				attr_accessor :soap_xml
+
+				# AMBIENTE DO PROCESSAMENTO
+				attr_accessor :environment
+				alias_attribute :tpAmb, :environment
+				def environment
+					if @environment.to_i == 1
+						:production
+					else
+						:test
+					end
+				end
+
+				# Versão do aplicativo da SEFAZ
+				attr_accessor :app_version
+				alias_attribute :verAplic, :app_version
+
+				# DATA E HORA DO PROCESSAMENTO DA REQUISIÇÃO
+				# 
+				attr_accessor :processed_at
+				def processed_at
+					convert_to_time(@processed_at)
+				end
+				alias_attribute :dhRecbto, :processed_at
+
+				# PROTOCOLO / NÚMERO DO RECIBO
+				#  Número do Recibo gerado pelo Portal da
+				#  Secretaria de Fazenda Estadual
+				#
+				attr_accessor :protocol
+				alias_attribute :nRec, :protocol
+				
+				# STATUS PARA SABER SE A REQUISIÇÃO PARA A SEFAZ FOI BEM SUCEDIDA
+				#   Pode ocorrer erros como HTTPError quando o servidor está offline.
+				#   Nesses casos a requsição sempre será tratada e adicionado as mensagens
+				#   de erro no attr :request_message_error
+				#
+				# Status possíveis:
+				#  + :success    = Requisição efetuada com sucesso e contém um XML para verificação dos dados
+				#  + :soap_error = Quando houve um erro do tipo Savon::SOAPFault
+				#  + :http_error = Quando houve um erro do tipo Savon::HTTPError
+				#  + :unknown_error = Quando houve outro erro desconhecido
+				#
+				attr_accessor :request_status
+				attr_accessor :request_message_error
+
+				# STATUS DO PROCESSAMENTO DA OPERAÇÃO
+				#  Esse status é utilizado para saber se a operação 
+				#  foi processada com sucesso ou não.
+				#  Será preenchida apenas se o attr :request_status for :success
+				#
+				#  Retornos possíveis:
+				#    + :success - Quando a operação requisitada foi processada e obteve 
+				#                 sucesso no processamento. Será necessário verificar o 
+				#                 status individual de cada operação.
+				# 
+				#    + :processing - Quando ainda está em processamento e será necessário 
+				#                    fazer uma nova requisição.
+				# 
+				#    + :offline - Quando o serviço estiver offline
+				# 
+				#    + :denied - Quando o acesso foi denegado
+				# 
+				#    + :error - Quando houve algum erro no processamento
+				#
+				attr_accessor :processing_status_code
+				alias_attribute :cStat, :processing_status_code
+				attr_accessor :processing_status_motive
+				alias_attribute :xMotivo, :processing_status_motive
+				
+				def processing_status
+					if "#{processing_status_code}   ".strip.in?( BrNfe::Constants::NFE_STATUS_SUCCESS )
+						:success
+					elsif "#{processing_status_code}".strip.in?( BrNfe::Constants::NFE_STATUS_PROCESSING )
+						:processing
+					elsif "#{processing_status_code}".strip.in?( BrNfe::Constants::NFE_STATUS_OFFLINE )
+						:offline
+					elsif "#{processing_status_code}".strip.in?( BrNfe::Constants::NFE_STATUS_DENIED )
+						:denied
+					else
+						:error
+					end
+				end
+
+				def processed_successfully?
+					processing_status == :success
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/response/build/base.rb

@@ -0,0 +1,287 @@
+module BrNfe
+	module Product
+		module Response
+			module Build
+				class Base < BrNfe::ActiveModelBase
+					attr_accessor :savon_response
+					attr_accessor :operation
+
+					def original_xml
+						@original_xml ||= operation.original_xml || operation.xml_builder
+					end
+					
+					# Responsável por instanciar o objeto de resposta contendo os valores
+					# pertinentes a cada operação.
+					#
+					def response
+						return @response if @response
+						@response = response_class.new({
+							soap_xml: savon_response.try(:xml).try(:force_encoding, 'UTF-8'),
+							request_status: :success
+						})
+						@response.assign_attributes(specific_attributes)
+						@response
+					end
+
+					# Responsável por definir a classe da resposta que será instânciada
+					# para cada operação.
+					# Esse método deve ser sobrescrito para cada operação.
+					#
+					# <b>Type: </b> _Class_
+					#
+					def response_class
+						BrNfe::Product::Response::Base
+					end
+
+					# É utilizado para setar os atributos específicos para
+					# o retorno de cada operação.
+					# É útil para evitar sobrescrever e duplicar código do 
+					# método response
+					#
+					# <b>Type: </b> _Hash_
+					#
+					def specific_attributes
+						{}
+					end
+
+					# Responsável por identificar o xmlns principal da resposta.
+					# Esse valor é utilizado para dar o Start para encontrar o conteúdo
+					# na arvore de tags xml.
+					#
+					# <b>Type: </b> _String_
+					#
+					def url_xmlns_retorno
+						@url_xmlns_retorno ||= header_xml.collect_namespaces['xmlns']
+					end
+
+					# Responsável por trazer qual a versão do layout o XML da resposta
+					# foi feito.
+					# Irá converter a versão em Symbol e alterar o ponto(.) em underline(_).
+					# Também irá acrescentar um 'v' na frente da versão.
+					# Irá pegar a versão a partir da tag 'versaoDados' presente no Header 
+					# da requisição Soap.
+					# É útil para saber como pegar as informações do XML, pois como cada
+					#  versão pode ter uma estrutura diferente, o conteúdo desse método
+					#  irá auxiliar na decisão de como buscar o conteúdo.
+					#
+					# Exemplos:
+					#  Versão do XML      Retorno
+					#      '1.00'     =>    :v1_00
+					#      '2.01'     =>    :v2_01
+					#      '3.10'     =>    :v3_10
+					#
+					# # <b>Type: </b> _Symbol_
+					#
+					def xml_version
+						return @xml_version if @xml_version
+						version = header_xml.xpath('//nf:nfeCabecMsg/nf:versaoDados', nf: url_xmlns_retorno).text
+						@xml_version = "v#{version.gsub('.','_')}".to_sym
+					end
+					# Versão do XML em forma de String
+					# ex: '3.10'
+					def xml_version_str
+						return @xml_version_str if @xml_version_str
+						@xml_version_str = header_xml.xpath('//nf:nfeCabecMsg/nf:versaoDados', nf: url_xmlns_retorno).text
+					end
+
+					# Responsável por pegar o conteúdo presente dentro da tag
+					# Body da resposta Soap.
+					# É útil para facilitar a busca e manupilação do XML presente
+					# dentro do Body da resposta Soap
+					# 
+					# # <b>Type: </b> _Nokogiri::XML::Document_
+					#
+					def body_xml
+						@body_xml ||= parse_nokogiri_xml( response_xml.xpath('//soap:Envelope/soap:Body', 'xmlns:soap' => "http://www.w3.org/2003/05/soap-envelope").try(:children).try(:to_xml) )
+					end
+
+					# Responsável por pegar o conteúdo presente dentro da tag
+					# Header da resposta Soap.
+					# É útil para facilitar a busca e manupilação do XML presente
+					# dentro do Header da resposta Soap
+					# 
+					# # <b>Type: </b> _Nokogiri::XML::Document_
+					#
+					def header_xml
+						@header_xml ||= parse_nokogiri_xml( response_xml.xpath('//soap:Envelope/soap:Header', 'xmlns:soap' => "http://www.w3.org/2003/05/soap-envelope").try(:children).try(:to_xml) )
+					end
+
+					# Responsável por converter a string xml a ser modificado
+					# em um Nokogiri::XML::Document
+					# É útil para evitar ficar dando o parse no xml toda vez que precisa
+					# ser utilizado.
+					# 
+					# # <b>Type: </b> _Nokogiri::XML::Document_
+					#
+					def doc_original_xml
+						@doc_original_xml ||= parse_nokogiri_xml( original_xml )
+					end
+
+					# Contém o XML completo da resposta Soap.
+					# É útil para evitar ficar dando o parse no xml toda vez que precisa
+					# ser utilizado.
+					#
+					# # <b>Type: </b> _Nokogiri::XML::Document_
+					#
+					def response_xml
+						@response_xml ||= parse_nokogiri_xml(savon_response.try(:xml))
+					end
+
+					# XMLNS PADRÃO DA NOTA FISCAL
+					#
+					def nf_xmlns
+						'http://www.portalfiscal.inf.br/nfe'
+					end
+
+				private
+
+					# Reponsável por converter uma string(XML) em um elemento 
+					# da classe Nokogiri::XML::Document.
+					#
+					def parse_nokogiri_xml str_xml
+						if str_xml.include?('<?xml')
+							Nokogiri::XML(str_xml)
+						else
+							Nokogiri::XML('<?xml version="1.0" encoding="UTF-8"?>'+str_xml)
+						end
+					end
+
+					# Rsponsável por instânciar uma nota fiscal a partir da tag protNFe.
+					# Também vai setar o atributo xml específico da nota fiscal a partir
+					# do valor setado em :original_xml
+					#
+					# Deve ser passado por parâmetro um objeto da class Nokogiri::XML::Document
+					# com a estrutura do protocolo da NFE. EX:
+					#   <protNFe versao="3.10">
+					#     <infProt>
+					#       <tpAmb>2</tpAmb>
+					#       <verAplic>SVRS201611281548</verAplic>
+					#       <chNFe>42161208897094000155550010000000031201601010</chNFe>
+					#       <dhRecbto>2016-12-23T15:02:01-02:00</dhRecbto>
+					#       <nProt>342160000820227</nProt>
+					#       <digVal>eoBzPod21zF9/46jjOS2kLRyTPM=</digVal>
+					#       <cStat>100</cStat>
+					#       <xMotivo>Autorizado o uso da NF-e</xMotivo>
+					#     </infProt>
+					#   </protNFe>
+					# 
+					# <b>Type: </b> _BrNfe.nota_fiscal_product_class_
+					#
+					def build_invoice_by_prot_nfe prot_nfe
+						invoice = BrNfe.nota_fiscal_product_class.new do |nfe|
+							nfe.processed_at    = get_processed_at_from_prot_nfe(  prot_nfe )
+							nfe.protocol        = get_protocol_from_prot_nfe(      prot_nfe )
+							nfe.digest_value    = get_digest_value_from_prot_nfe(  prot_nfe )
+							nfe.status_code     = get_status_code_from_prot_nfe(   prot_nfe )
+							nfe.status_motive   = get_status_motive_from_prot_nfe( prot_nfe )
+							nfe.chave_de_acesso = get_access_key_from_prot_nfe(    prot_nfe )
+						end
+						# 1° - Seta os valores possíveis encontrados na chave de acesso da NF-e
+						set_invoice_values_by_access_key!( invoice )
+
+						# 2° - Seta o XML da respectiva NF-e no objeto já com a tag <nfeProc>
+						#      e a tag do protocolo(<protNFe>)
+						set_invoice_xml_with_prot_nfe!( invoice, prot_nfe )
+						invoice
+					end
+
+					def get_processed_at_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/dhRecbto').text
+					end
+					def get_protocol_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/nProt').text
+					end
+					def get_digest_value_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/digVal').text
+					end
+					def get_status_code_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/cStat').text
+					end
+					def get_status_motive_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/xMotivo').text
+					end
+					def get_access_key_from_prot_nfe prot_nfe
+						prot_nfe.xpath('//protNFe/infProt/chNFe').text
+					end
+
+					# Seta os valores que estão concatenados na chave da NF-e
+					# como o número da nota fiscal, cnpj do emitente, entre outros 
+					# valores.
+					#
+					def set_invoice_values_by_access_key!(invoice)
+						if invoice.chave_de_acesso.present?
+							invoice.emitente.cnpj = invoice.chave_de_acesso[6..19]
+							invoice.modelo_nf = invoice.chave_de_acesso[20..21]
+							invoice.serie     = invoice.chave_de_acesso[22..24]
+							invoice.numero_nf = invoice.chave_de_acesso[25..33].to_i
+							invoice.codigo_nf = invoice.chave_de_acesso[35..42].to_i
+						end
+					end
+
+					# Responsável por adicionar a tag <protNFe> dentro da tag <nfeProc>.
+					# Também irá setar o XMl atualizado no attr :xml da nota fiscal
+					#
+					def set_invoice_xml_with_prot_nfe!(invoice, prot_nfe)
+						if nfeProc = find_or_create_nfeProc_of_invoice_xml_by_access_key( invoice )
+							# Só adiciona o protocolo se a nota foi emitida com sucesso
+							if invoice.status == :success 
+								add_prot_nfe_into_nfe_proc( nfeProc, prot_nfe )
+							end
+
+							invoice.xml = '<?xml version="1.0" encoding="UTF-8"?>'+canonicalize( nfeProc.to_xml )
+						end
+					end
+
+					# Responsável por adicionar o protocolo da NFe dentro da tag nfeProc
+					# a baixo da tag NFe.
+					# Caso já exista a tag protNFe não irá adiciona-lo novamente.
+					#
+					def add_prot_nfe_into_nfe_proc nfe_proc, prot_nfe
+						if nfe_proc.xpath('//nf:nfeProc/nf:protNFe', nf: nf_xmlns).blank?
+							nfe_proc.xpath('//nf:nfeProc', nf: nf_xmlns).
+							        children.last.try(:add_next_sibling, prot_nfe.root.to_xml )
+						end
+					end
+
+					# Responsável por Encontrar ou Criar a estrutura nfeProc de uma
+					# Determinada nota fiscal.
+					# 1° Verifica se existe algum XML setado no objeto da nota, e se existir,
+					#    irá montar a nfeProc da nota e retornar o documento XML
+					# 2° Caso não encontre o xml direto na NF, irá procurar o xml através
+					#    do método original_xml.
+					# 
+					# Estrutura de retorno:
+					#   <nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="3.10">
+					#     <NFe>...</NFe>
+					#   </nfeProc>
+					# 
+					# <b>Type: </b> _Nokogiri::XML::Document_
+					#
+					def find_or_create_nfeProc_of_invoice_xml_by_access_key invoice
+						doc_nf = "#{invoice.xml}".strip.present? ? parse_nokogiri_xml("#{invoice.xml}") : parse_nokogiri_xml(original_xml)
+						if node = doc_nf.search("NFe/infNFe[@Id*=\"#{invoice.chave_de_acesso}\"]").first
+							if doc_nf.xpath('/*').first.try(:name) == 'nfeProc'
+								doc_nf
+							else
+								parse_nokogiri_xml( create_proc_tag( node.parent.to_s ) )
+							end
+						end
+					end
+
+					# Responsável por criar a tag <nfeProc> e adicionar o conteúdo 
+					# passado por parâmetro dentro da tag.
+					# Deve ser passado o xml em forma de String.
+					#
+					# <b>Type: </b> _String_
+					#
+					def create_proc_tag nfe_xml
+						xml = "<nfeProc xmlns=\"#{nf_xmlns}\" versao=\"#{xml_version_str}\">"
+						xml << nfe_xml
+						xml << '</nfeProc>'
+						xml
+					end
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/response/build/nfe_autorizacao.rb

@@ -0,0 +1,102 @@
+module BrNfe
+	module Product
+		module Response
+			module Build
+				class NfeAutorizacao < Base
+					
+					def notas_fiscais
+						operation.notas_fiscais
+					end
+
+					# Responsável por definir qual classe será instânciada para
+					# setar os valores de retorno referentes a cada operação.
+					#
+					# <b>Type: </b> _Class_
+					#
+					def response_class
+						BrNfe::Product::Response::NfeAutorizacao
+					end
+					
+					# Responsável por setar os atributos específicos para
+					# cada tipo de operação.
+					#
+					# <b>Type: </b> _Hash_
+					#
+					def specific_attributes
+						attrs = {
+							environment:              body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:tpAmb',    nf: nf_xmlns, ret: url_xmlns_retorno).text,
+							app_version:              body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:verAplic', nf: nf_xmlns, ret: url_xmlns_retorno).text,
+							processed_at:             request_processed_at,
+
+							processing_status_code:   get_processing_status_code,
+							processing_status_motive: get_processing_status_motive,
+						}
+
+						if async_protocol.present?
+							# Se entrar aqui é porque o lote é assíncrono e tem um protocolo
+							attrs[:protocol]    = async_protocol
+							attrs[:tempo_medio] = body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:infRec/nf:tMed', nf: nf_xmlns, ret: url_xmlns_retorno).text
+						else
+							attrs[:protocol] = body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:protNFe/nf:infProt/nf:nProt', nf: nf_xmlns, ret: url_xmlns_retorno).text
+						end
+
+						manage_invoices!
+						attrs[:notas_fiscais] = notas_fiscais
+
+						attrs
+					end
+
+					def async_protocol
+						@async_protocol ||= body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:infRec/nf:nRec', nf: nf_xmlns, ret: url_xmlns_retorno).text
+					end
+
+					def node_prot_nfe
+						body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:protNFe', nf: nf_xmlns, ret: url_xmlns_retorno)
+					end
+
+					def manage_invoices!
+						if async_protocol.present?
+							notas_fiscais.each do |nf| 
+								nf.protocol = async_protocol
+								nf.processed_at = request_processed_at
+								nf.status_code = get_processing_status_code
+								nf.status_motive = get_processing_status_motive
+							end
+						elsif node_prot_nfe.present?
+							notas_fiscais.each do |nfe|
+								prot_nfe = parse_nokogiri_xml( node_prot_nfe.to_xml )
+								set_invoice_protocol!(nfe, prot_nfe)
+							end
+						end
+					end
+
+					def set_invoice_protocol! invoice, prot_nfe
+						invoice.processed_at    = get_processed_at_from_prot_nfe(  prot_nfe )
+						invoice.protocol        = get_protocol_from_prot_nfe(      prot_nfe )
+						invoice.digest_value    = get_digest_value_from_prot_nfe(  prot_nfe )
+						invoice.status_code     = get_status_code_from_prot_nfe(   prot_nfe )
+						invoice.status_motive   = get_status_motive_from_prot_nfe( prot_nfe )
+						invoice.chave_de_acesso = get_access_key_from_prot_nfe(    prot_nfe )
+						
+						# Seta o XML da respectiva NF-e no objeto já com a tag <nfeProc>
+						# e a tag do protocolo(<protNFe>)
+						set_invoice_xml_with_prot_nfe!( invoice, prot_nfe ) if invoice.status == :success
+					end
+
+				private
+
+					def request_processed_at
+						@request_processed_at ||= body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:dhRecbto', nf: nf_xmlns, ret: url_xmlns_retorno).text
+					end
+
+					def get_processing_status_code
+						@get_processing_status_code ||= body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:cStat',    nf: nf_xmlns, ret: url_xmlns_retorno).text
+					end
+					def get_processing_status_motive
+						@get_processing_status_motive ||= body_xml.xpath('//ret:nfeAutorizacaoLoteResult/nf:retEnviNFe/nf:xMotivo',  nf: nf_xmlns, ret: url_xmlns_retorno).text
+					end
+				end
+			end
+		end
+	end
+end