br_nfe 2.1.1 → 2.2.0

data/lib/br_nfe/product/nfe/item_tax/pis.rb

@@ -0,0 +1,138 @@
+module BrNfe
+	module Product
+		module Nfe
+			module ItemTax
+				class Pis < BrNfe::ActiveModelBase
+					# CÓDIGO DA SITUAÇÃO TRIBUTÁRIA do PIS
+					#  01 = Operação Tributável (base de cálculo = valor da operação alíquota normal (cumulativo/não cumulativo));
+					#  02 = Operação Tributável (base de cálculo = valor da operação (alíquota diferenciada));
+					#  03 = Operação Tributável: (base de cálculo = quantidade vendida x alíquota por unidade de produto);
+					#  04 = Operação Tributável (tributação monofásica (alíquota zero));
+					#  05 = Operação Tributável (Substituição Tributária);
+					#  06 = Operação Tributável (alíquota zero);
+					#  07 = Operação Isenta da Contribuição;
+					#  08 = Operação Sem Incidência da Contribuição;
+					#  09 = Operação com Suspensão da Contribuição;
+					#  49 = Outras Operações de Saída;
+					#  50 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
+					#  51 = Operação com Direito a Crédito - Vinculada Exclusivamente a Receita Não Tributada no Mercado Interno;
+					#  52 = Operação com Direito a Crédito – Vinculada Exclusivamente a Receita de Exportação;
+					#  53 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
+					#  54 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
+					#  55 = Operação com Direito a Crédito - Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
+					#  56 = Operação com Direito a Crédito - Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação;
+					#  60 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
+					#  61 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
+					#  62 = Crédito Presumido - Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação;
+					#  63 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
+					#  64 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
+					#  65 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação;
+					#  66 = Crédito Presumido - Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação;
+					#  67 = Crédito Presumido - Outras Operações;
+					#  70 = Operação de Aquisição sem Direito a Crédito;
+					#  71 = Operação de Aquisição com Isenção;
+					#  72 = Operação de Aquisição com Suspensão;
+					#  73 = Operação de Aquisição a Alíquota Zero;
+					#  74 = Operação de Aquisição; sem Incidência da Contribuição;
+					#  75 = Operação de Aquisição por Substituição Tributária;
+					#  98 = Outras Operações de Entrada;
+					#  99 = Outras Operações;
+					# 
+					# <b>Type:     </b> _Number_ <- string
+					# <b>Required: </b> _Yes_
+					# <b>Example:  </b> _00_
+					# <b>Length:   </b> _2_
+					# <b>tag:      </b> CST
+					# 
+					attr_accessor :codigo_cst
+					def codigo_cst
+						"#{@codigo_cst}".rjust(2, '0') if @codigo_cst.present?
+					end
+					alias_attribute :CST, :codigo_cst
+
+					# VALOR DA BASE DE CÁLCULO DO PIS
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst in [01 02])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> vBC
+					# 
+					attr_accessor :total_base_calculo
+					alias_attribute :vBC, :total_base_calculo
+
+					# ALÍQUOTA DO PIS (EM PERCENTUAL)
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst in [01 02])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> pPIS
+					# 
+					attr_accessor :aliquota
+					alias_attribute :pPIS, :aliquota
+
+					# VALOR DO PIS
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _Yes_ (No if cst in [04 05 06 07 08 09])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> vPIS
+					# 
+					attr_accessor :total
+					alias_attribute :vPIS, :total
+
+					# QUANTIDADE VENDIDA
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst is 03)
+					# <b>Example:  </b> _10.0_
+					# <b>Length:   </b> _12v0-4_
+					# <b>tag:      </b> qBCProd
+					# 
+					attr_accessor :quantidade_vendida
+					alias_attribute :qBCProd, :quantidade_vendida
+
+					# ALÍQUOTA DO PIS (EM REAIS)
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst is 03)
+					# <b>Example:  </b> _10.0_
+					# <b>Length:   </b> _11v0-4_
+					# <b>tag:      </b> vAliqProd
+					# 
+					attr_accessor :total_aliquota
+					alias_attribute :vAliqProd, :total_aliquota
+
+					def default_values
+						{
+							codigo_cst: '07'
+						}
+					end
+					
+					validates :codigo_cst, presence: true
+					validates :codigo_cst, inclusion: {in: %w[01 02 03 04 05 06 07 08 09 49 50 51 52 53 54 55 56 60 61 62 63 64 65 66 67 70 71 72 73 74 75 98 99]}
+
+					with_options if: lambda{ |r| r.codigo_cst.in?(%w[01 02]) } do |record|
+						record.validates :total_base_calculo, presence: true
+						record.validates :total_base_calculo, numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+						record.validates :aliquota,           presence: true
+						record.validates :aliquota,           numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+						record.validates :total,              presence: true
+						record.validates :total,              numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					end
+					with_options if: lambda{ |r| r.codigo_cst == '03' } do |record|
+						record.validates :quantidade_vendida, presence: true
+						record.validates :quantidade_vendida, numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+						record.validates :total_aliquota,     presence: true
+						record.validates :total_aliquota,     numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+						record.validates :total,              presence: true
+						record.validates :total,              numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					end
+					with_options if: lambda{ |r| r.codigo_cst.in?(%w[49 50 51 52 53 54 55 56 60 61 62 63 64 65 66 67 70 71 72 73 74 75 98 99]) } do |record|
+						record.validates :total,              presence: true
+						record.validates :total,              numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					end
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/item_tax/pis_st.rb

@@ -0,0 +1,68 @@
+module BrNfe
+	module Product
+		module Nfe
+			module ItemTax
+				class PisSt < BrNfe::ActiveModelBase
+					# VALOR DA BASE DE CÁLCULO DO PIS ST
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst in [01 02])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> vBC
+					# 
+					attr_accessor :total_base_calculo
+					alias_attribute :vBC, :total_base_calculo
+
+					# ALÍQUOTA DO PIS (EM PERCENTUAL)
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst in [01 02])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> pPIS
+					# 
+					attr_accessor :aliquota
+					alias_attribute :pPIS, :aliquota
+
+					# VALOR DO PIS
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _Yes_ (No if cst in [04 05 06 07 08 09])
+					# <b>Example:  </b> _350.47_
+					# <b>tag:      </b> vPIS
+					# 
+					attr_accessor :total
+					alias_attribute :vPIS, :total
+
+					# QUANTIDADE VENDIDA
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst is 03)
+					# <b>Example:  </b> _10.0_
+					# <b>Length:   </b> _12v0-4_
+					# <b>tag:      </b> qBCProd
+					# 
+					attr_accessor :quantidade_vendida
+					alias_attribute :qBCProd, :quantidade_vendida
+
+					# ALÍQUOTA DO PIS (EM REAIS)
+					# 
+					# <b>Type:     </b> _Float_
+					# <b>Required: </b> _No_ (Yes if cst is 03)
+					# <b>Example:  </b> _10.0_
+					# <b>Length:   </b> _11v0-4_
+					# <b>tag:      </b> vAliqProd
+					# 
+					attr_accessor :total_aliquota
+					alias_attribute :vAliqProd, :total_aliquota
+					
+					validates :total, presence: true
+					validates :total,              numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					validates :total_base_calculo, numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					validates :aliquota,           numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					validates :quantidade_vendida, numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+					validates :total_aliquota,     numericality: {greater_than_or_equal_to: 0.0}, allow_blank: true
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/processo_referencia.rb

@@ -0,0 +1,48 @@
+# Grupo Processo referenciado
+# (NT 2012/003)
+#
+# <b>Type:     </b> _Group_
+# <b>Length:   </b> _max: 100_
+# <b>tag:      </b> procRef
+#
+module BrNfe
+	module Product
+		module Nfe
+			class ProcessoReferencia < BrNfe::ActiveModelBase
+				# IDENTIFICADOR DO PROCESSO OU ATO CONCESSÓRIO
+				# 
+				# <b>Type:     </b> _String_
+				# <b>Required: </b> _Yes_
+				# <b>Example:  </b> _PRF226482_
+				# <b>Length:   </b> _max: 60_
+				# <b>tag:      </b> nProc
+				#
+				attr_accessor :numero_processo
+				alias_attribute :nProc, :numero_processo
+
+				# INDICADOR DA ORIGEM DO PROCESSO
+				#  0 = SEFAZ;
+				#  1 = Justiça Federal;
+				#  2 = Justiça Estadual;
+				#  3 = Secex/RFB;
+				#  9 = Outros
+				# 
+				# <b>Type:     </b> _Number_
+				# <b>Required: </b> _Yes_
+				# <b>Default:  </b> _0_
+				# <b>Example:  </b> _1_
+				# <b>Length:   </b> _max: 60_
+				# <b>tag:      </b> indProc
+				#
+				attr_accessor :indicador
+				def indicador
+					@indicador.to_i
+				end
+				alias_attribute :indProc, :indicador
+
+				validates :indicador,       inclusion: {in: [0,1,2,3,9]}
+				validates :numero_processo, presence: true
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/transporte/base.rb

@@ -0,0 +1,264 @@
+module BrNfe
+	module Product
+		module Nfe
+			module Transporte
+				class Base < BrNfe::ActiveModelBase
+					
+					# Modalidade do frete
+					# 0- Por conta do emitente; 
+					# 1- Por conta do destinatário/remetente; 
+					# 2- Por conta de terceiros; 
+					# 9- Sem frete
+					# 
+					# <b>Type:     </b> _Number_
+					# <b>Required: </b> _Yes_
+					# <b>Default:  </b> _9_
+					# <b>Length:   </b> _1_
+					# <b>tag:      </b> modFrete
+					#
+					attr_accessor :modalidade_frete
+					alias_attribute :modFrete, :modalidade_frete
+
+
+					##############################################################################
+					#################### Dados da retenção ICMS do Transporte ####################
+						
+						# Método para saber se há retenção de ICMS, e se houver,
+						# aplica as validações e adiciona a tag no XML
+						#
+						# <b>Type: </b> _Boolean_
+						# <b>tag:  </b> retTransp
+						#
+						def retencao_icms?
+							retencao_valor_sevico.to_f > 0.0
+						end
+
+						# Valor do serviço
+						#
+						# <b>Type:     </b> _Float_
+						# <b>Required: </b> _No_
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> vServ
+						#
+						attr_accessor :retencao_valor_sevico
+						alias_attribute :vServ, :retencao_valor_sevico
+
+						# Base de Cálculo da Retenção do ICMS
+						#
+						# <b>Type:     </b> _Float_
+						# <b>Required: </b> _No_
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> vBCRet
+						#
+						attr_accessor :retencao_base_calculo_icms
+						alias_attribute :vBCRet, :retencao_base_calculo_icms
+
+						# Percentual de aliquota da retenção do ICMS
+						# Exemplo: 
+						#  Se a aliquota for de 2,56% então deve setar o valor para
+						#  o atrubuto assim: self.retencao_aliquota = 2.56
+						#
+						# <b>Type:     </b> _Float_
+						# <b>Required: </b> _No_
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> pICMSRet
+						#
+						attr_accessor :retencao_aliquota
+						alias_attribute :pICMSRet, :retencao_aliquota
+
+						# Valor do ICMS Retido
+						# Caso não seja setado nenhum valor, irá calcular automaticamente
+						# através dos atributos 'retencao_base_calculo_icms' e 'retencao_aliquota'
+						#
+						# <b>Type:     </b> _Float_
+						# <b>Required: </b> _No_
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> vICMSRet
+						#
+						attr_accessor :retencao_valor_icms
+						def retencao_valor_icms
+							@retencao_valor_icms || calculate_retencao_valor_icms
+						end
+						alias_attribute :vICMSRet, :retencao_valor_icms
+
+						# CFOP de Serviço de Transporte
+						#
+						# <b>Type:     </b> _Number_
+						# <b>Required: </b> _No_ (Yes if retencao_icms?)
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> CFOP
+						#
+						attr_accessor :retencao_cfop
+						alias_attribute :CFOP, :retencao_cfop
+
+						# Código do município de ocorrência do fato gerador 
+						# do ICMS do transporte
+						#
+						# <b>Type:     </b> _Number_
+						# <b>Required: </b> _No_ (Yes if retencao_icms?)
+						# <b>Default:  </b> _nil_
+						# <b>tag:      </b> cMunFG
+						#
+						attr_accessor :retencao_codigo_municipio
+						alias_attribute :cMunFG, :retencao_codigo_municipio
+
+					# Attr utilizado para saber como será validado os dados do 
+					# 'veiculo' utilizado para transportar a carga.
+					#
+					# <b>Type: </b> _Symbol_
+					# <b>Allowed:   </b> _:veiculo, :balsa, :vagao_
+					# <b>Required:  </b> _Yes_
+					# <b>Default:   </b> _:veiculo_
+					#
+					attr_accessor :forma_transporte
+					
+					# Veículo de transporte
+					# Utilizado quando a forma de transporte for com :veiculo
+					#
+					# <b>Type:     </b> _BrNfe.veiculo_product_class_
+					# <b>Required: </b> _No_ (Yes if forma_transporte == :veiculo)
+					# <b>Default:  </b> _nil_
+					# <b>tag:      </b> veicTransp
+					#
+					has_one :veiculo, 'BrNfe.veiculo_product_class'
+					alias_attribute :veicTransp, :veiculo
+
+
+					# Identificação da balsa (v2.0)
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _No_ (Yes if forma_transporte == :balsa)
+					# <b>tag:      </b> balsa
+					#
+					attr_accessor :identificacao_balsa
+					alias_attribute :balsa, :identificacao_balsa
+
+					# Identificação do vagao (v2.0)
+					#
+					# <b>Type: </b> _String_
+					# <b>Required: </b> _No_ (Yes if forma_transporte == :vagao)
+					# <b>tag:      </b> vagao
+					#
+					attr_accessor :identificacao_vagao
+					alias_attribute :vagao, :identificacao_vagao
+
+					# Array com os reboques utilizados para transportar a carga
+					# Pode ser adicionado os dados dos reboques em forma de `Hash` ou
+					# O próprio objeto da classe Veiculo.
+					#
+					# Exemplo com Hash:
+					#    self.reboques = [{placa: 'XXX6644', uf: 'SP', ...},{placa: 'XXX6644', uf: 'SC', ...}]
+					#    self.reboques << {placa: 'XXX6644', uf: 'MG', ...}
+					#    self.reboques << {placa: 'XXX6644', uf: 'GO', ...}
+					#
+					# Exemplo com Objetos:
+					#    self.reboques = [BrNfe::Product::Nfe::Transporte::Veiculo.new({placa: 'XXX6644', uf: 'PI', ...}),{placa: 'XXX6644', uf: 'RS', ...}]
+					#    self.reboques << BrNfe::Product::Nfe::Transporte::Veiculo.new({placa: 'XXX6644', uf: 'PR', ...})
+					#    self.reboques << {placa: 'XXX6644', uf: 'DF', ...}
+					#
+					# Sempre vai retornar um Array de objetos da class configurada em `BrNfe.veiculo_product_class`
+					#
+					# <b>Tipo:    </b> _BrNfe.veiculo_product_class (BrNfe::Product::Nfe::Transporte::Veiculo)_
+					# <b>Length:  </b> _min: 0, max: 5_
+					# <b>Default: </b> _[]_
+					# <b>tag:     </b> reboque
+					#
+					has_many :reboques, 'BrNfe.veiculo_product_class'
+
+					# Array com os volumes utilizados para transportar a carga
+					# Pode ser adicionado os dados dos volumes em forma de `Hash` ou
+					# O próprio objeto da classe Volume.
+					#
+					# Exemplo com Hash:
+					#    self.volumes = [{marca: 'XXX6644', quantidade: 8, ...},{marca: 'XXX6644', quantidade: 9, ...}]
+					#    self.volumes << {marca: 'XXX6644', quantidade: 10, ...}
+					#    self.volumes << {marca: 'XXX6644', quantidade: 11, ...}
+					#
+					# Exemplo com Objetos:
+					#    self.volumes = [BrNfe::Product::Nfe::Transporte::Volume.new({marca: 'XXX6644', quantidade: 12, ...}),{marca: 'XXX6644', quantidade: 13, ...}]
+					#    self.volumes << BrNfe::Product::Nfe::Transporte::Volume.new({marca: 'XXX6644', quantidade: 14, ...})
+					#    self.volumes << {marca: 'XXX6644', quantidade: 15, ...}
+					#
+					# Sempre vai retornar um Array de objetos da class configurada em `BrNfe.volume_transporte_product_class`
+					#
+					# <b>Tipo:    </b> _BrNfe.volume_transporte_product_class (BrNfe::Product::Nfe::Transporte::Volume)_
+					# <b>Default: </b> _[]_
+					# <b>tag:     </b> vol
+					#
+					has_many :volumes, 'BrNfe.volume_transporte_product_class'
+					alias_attribute :vol, :volumes
+
+					# Transportador da mercadoria
+					# Dados da transportadora que irá `transportar` a mercadoria.
+					#
+					# <b>Type:     </b> _BrNfe.transportador_product_class_
+					# <b>Required: </b> _No_
+					# <b>Default:  </b> _nil_
+					# <b>tag:      </b> transporta
+					#
+					has_one :transportador, 'BrNfe.transportador_product_class'
+					alias_attribute :transporta, :transportador
+					
+					
+					def default_values
+						{
+							modalidade_frete: 9,        # 9 = Sem frete
+							forma_transporte: :veiculo, # Define qualer tipo de veículo terrestre (Caminhão, van, etc..)
+						}
+					end
+
+					validates :modalidade_frete, inclusion: [0, '0', 1, '1', 2, '2', 9, '9']
+					validates :forma_transporte, presence: true
+					validates :forma_transporte, inclusion: [:veiculo, :balsa, :vagao]
+					validate_has_one :transportador
+					
+					validate_has_many :volumes, message: :invalid_volume
+					validate_has_many :reboques, message: :invalid_reboque
+					validates :reboques,         length: {maximum: 5}
+
+					with_options if: lambda { |rec| rec.have_carriage? && rec.forma_transporte_veiculo? } do |record|
+						record.validates :veiculo, presence: true
+						record.validate_has_one :veiculo
+					end
+					validates :identificacao_balsa, presence: true, if: lambda { |rec| rec.have_carriage? && rec.forma_transporte_balsa? }
+					validates :identificacao_vagao, presence: true, if: lambda { |rec| rec.have_carriage? && rec.forma_transporte_vagao? }
+
+					with_options if: :retencao_icms? do |record|
+						record.validates :retencao_codigo_municipio, :retencao_cfop, presence: true
+						record.validates :retencao_base_calculo_icms, numericality: true,             allow_blank: true
+						record.validates :retencao_aliquota,          numericality: {less_than: 100}, allow_blank: true
+						record.validates :retencao_valor_icms,        numericality: true,             allow_blank: true
+					end
+
+					def have_carriage?
+						modalidade_frete.to_i != 9
+					end
+
+					def forma_transporte_veiculo?
+						forma_transporte == :veiculo
+					end
+
+					def forma_transporte_balsa?
+						forma_transporte == :balsa
+					end
+
+					def forma_transporte_vagao?
+						forma_transporte == :vagao
+					end
+
+				private
+
+					##################################  CÁLCULOS  ##################################
+					# Método utilizado apra calcular o valor do ICMS retido no caso
+					# de não informar o valor manualmente.
+					# O Cálculo é em base do valor da base de cálculo multiplicado
+					# pelo percentual da aliquota de retenção.
+					#
+					def calculate_retencao_valor_icms
+						((retencao_aliquota.to_f/100.0)*retencao_base_calculo_icms.to_f).round(2)
+					end
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/transporte/transportador.rb

@@ -0,0 +1,15 @@
+module BrNfe
+	module Product
+		module Nfe
+			module Transporte
+				class Transportador  < BrNfe::Person
+					
+				private
+					def validate_regime_tributario?
+						false
+					end
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/transporte/veiculo.rb

@@ -0,0 +1,53 @@
+module BrNfe
+	module Product
+		module Nfe
+			module Transporte
+				class Veiculo < BrNfe::ActiveModelBase
+					# Placa do veículo (NT2011/004)
+					# Conforme a documentação oficial:
+					#    Informar em um dos seguintes formatos: XXX9999, XXX999, XX9999 ou XXXX999.
+					#    Informar a placa em informações complementares quando a placa do veículo 
+					#    tiver lei de formação diversa. (NT 2011/005)
+					# Porém a gem permite informar a placa com o - (hífen), Exemplo:
+					#      XXX-0000, XXX9999, XXX999, XX9999 ou XXXX999.
+					# Esse attr só irá considerar as letras e números, onde as letras sempre
+					# vai converter para maiúsculo
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _Yes_
+					# <b>tag:      </b> placa
+					#
+					attr_accessor :placa
+					def placa
+						"#{@placa}".gsub(/[^\d\w]/, '').upcase
+					end
+
+					# Sigla da UF
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _Yes_
+					# <b>Length:   </b> _2_
+					# <b>tag:      </b> UF
+					#
+					attr_accessor :uf
+
+					# Registro Nacional de Transportador de Carga (ANTT)
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _No_
+					# <b>Length:   </b> _max: 20_
+					# <b>tag:      </b> RNTC
+					#
+					attr_accessor :rntc
+
+
+					validates :placa, :uf, presence: true
+					validates :uf,  inclusion: { in: BrNfe::Constants::SIGLAS_UF} , allow_blank: true
+					validates :rntc,  length: { maximum: 20 }
+					validates :placa, length: { is: 7 }
+
+				end
+			end
+		end
+	end
+end

data/lib/br_nfe/product/nfe/transporte/volume.rb

@@ -0,0 +1,89 @@
+module BrNfe
+	module Product
+		module Nfe
+			module Transporte
+				class Volume < BrNfe::ActiveModelBase
+					# Quantidade de volumes transportados
+					#
+					# <b>Type:     </b> _Number_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> qVol
+					#
+					attr_accessor :quantidade
+					alias_attribute :qVol, :quantidade
+
+					# Espécie dos volumes transportados
+					# Exemplo: 'CAIXA', 'SACOLA', 'MALOTE'
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> esp
+					#
+					attr_accessor :especie
+					alias_attribute :esp, :especie
+
+					# Marca dos volumes transportados
+					# Exemplo: 'LINDOYA', 'NIKE', 'COCA COLA'
+					#
+					# <b>Type:     </b> _String_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> marca
+					#
+					attr_accessor :marca
+
+					# Numeração dos volumes transportados
+					# Exemplo: 'EXT12124', '500'
+					#
+					# <b>Type: </b> _String_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> nVol
+					#
+					attr_accessor :numercao
+					alias_attribute :nVol, :numercao
+
+					# Peso líquido do volume EM Kg
+					# Exemplo: 
+					#   13.5 = 13 Kilos e 500 gramas
+					#   100.003 = 100 Kilos e 3 gramas
+					#
+					# <b>Type: </b> _Number_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> pesoL
+					#
+					attr_accessor :peso_liquido
+					alias_attribute :pesoL, :peso_liquido
+
+					# Peso bruto do volume EM Kg
+					# Exemplo: 
+					#   13.5 = 13 Kilos e 500 gramas
+					#   100.003 = 100 Kilos e 3 gramas
+					#
+					# <b>Type:     </b> _Number_
+					# <b>Required: </b> _No_
+					# <b>tag:      </b> pesoB
+					#
+					attr_accessor :peso_bruto
+					alias_attribute :pesoB, :peso_bruto
+
+					# Número dos Lacres (NT 2012/003)
+					# Exemplo: 
+					#   ['XYZ10231486', 123456879]
+					#
+					# <b>Type:     </b> _Array_
+					# <b>Required: </b> _No_
+					# <b>Length:   </b> _max: 5000_
+					# <b>tag:      </b> lacres
+					#
+					attr_accessor :lacres
+					def lacres
+						@lacres = [@lacres].flatten.reject(&:blank?)
+						@lacres
+					end
+
+					validates :lacres, length: {maximum: 5_000}
+					validates :especie, :marca, :numercao, length: {maximum: 60}
+				end
+			end
+		end
+	end
+end