facturapi 0.0.1 → 0.1.0

data/lib/facturapi/helpers/dsc_rcg_global.rb

@@ -1,16 +1,49 @@
 module Facturapi
   module Helpers
+    # Corresponde a la o las lineas de descuento / recargo global de una
+    # Boleta Electronica, etiqueta e informacion opcional, con un maximo
+    # de 20
     class DscRcgGlobal
-      attr_accessor :nro_lin_dr, :tpo_mov, :glosa_dr, :tpo_valor, :valor_dr,
-                    :ind_exe_dr
+      # Indica el numero secuencial de linea de descuento /
+      # recargo de la Boleta Electronica, el cual puede ser desde la linea 1
+      # hasta la linea 20
+      attr_accessor :nro_lin_dr
+
+      # Indica el tipo de movimiento de la linea de descuento /
+      # recargo, informando que tipo de aplicacion tendran los posteriores
+      # valores en la linea, los tipos son:
+      # - D: Corresponde a una DESCUENTO
+      # - R: Corresponde a una RECARGO
+      attr_accessor :tpo_mov
+
+      # Corresponde a una breve descripcion del descuento / recargo
+      attr_accessor :glosa_dr
+
+      # Indica el tipo de valor de la linea de descuento / recargo. El valor
+      # sera indicado en el campo ValorDR, los tipos son:
+      # - % : Corresponde a un porcentaje
+      # - $ : Corresponde a un valor en moneda nacional
+      attr_accessor :tpo_valor
+
+      # Es el valor de descuento / recargo. Su valor debe ser hasta 16 digitos y
+      # 2 decimales. Al ser un campo de monto, se debe indicar sin decimales y
+      # sin separadores de miles.
+      attr_accessor :valor_dr
+
+      # Indicador de exencion de un descuento / recargo, para la Boleta
+      # Electronica. Los indicadores son:
+      # - 0: Descuento / Recargo se aplica a items afectos a IVA
+      # - 1: Descuento / Recargo se aplica a items exentos
+      # - 2: Descuento / Recargo se aplica a items facturables
+      attr_accessor :ind_exe_dr
 
       def initialize(params = {})
         @nro_lin_dr = params[:nro_lin_dr]
-        @tpo_mov = params[:tpo_mov]
+        @tpo_mov = params[:tpo_mov].to_s.upcase
         @glosa_dr = params[:glosa_dr]
-        @tpo_valor = params[:tpo_valor]
-        @valor_dr = params[:valor_dr]
-        @ind_exe_dr = params[:ind_exe_dr]
+        @tpo_valor = /^[\$\%]$/ =~ params[:tpo_valor].to_s ? params[:tpo_valor] : '$'
+        @valor_dr = params[:valor_dr].to_i if params[:valor_dr]
+        @ind_exe_dr = /^[0-2]$/ =~ params[:ind_exe_dr].to_s ? params[:ind_exe_dr] : 0
       end
 
       def as_node
@@ -23,6 +56,14 @@ module Facturapi
           dsc_rcg_global << create_node('IndExeDR') { |n| n << ind_exe_dr }
         end
       end
+
+      def descuento?
+        tpo_mov == 'D'
+      end
+
+      def recargo?
+        tpo_mov == 'R'
+      end
     end
   end
 end

data/lib/facturapi/helpers/dte.rb

@@ -1,7 +1,7 @@
 module Facturapi
   module Helpers
     class Dte
-      attr_accessor :encabezado, :detalle, :dsc_rcg_global, :referencia
+      attr_accessor :encabezado, :detalle, :dsc_rcg_global, :referencia, :id
 
       def initialize(params = {})
         @encabezado = params[:encabezado]
@@ -13,7 +13,7 @@ module Facturapi
       def detalle=(detalle)
         @detalle = @detalle.nil? ? [] : @detalle
         @detalle =
-          if @detalle.is_a?(Array)
+          if detalle.is_a?(Array)
             @detalle.push(*detalle)
           else
             @detalle.push(detalle)
@@ -23,7 +23,7 @@ module Facturapi
       def dsc_rcg_global=(dsc_rcg_global)
         @dsc_rcg_global = @dsc_rcg_global.nil? ? [] : @dsc_rcg_global
         @dsc_rcg_global =
-          if @dsc_rcg_global.is_a?(Array)
+          if dsc_rcg_global.is_a?(Array)
             @dsc_rcg_global.push(*dsc_rcg_global)
           else
             @dsc_rcg_global.push(dsc_rcg_global)
@@ -33,25 +33,70 @@ module Facturapi
       def referencia=(referencia)
         @referencia = @referencia.nil? ? [] : @referencia
         @referencia =
-          if @referencia.is_a?(Array)
+          if referencia.is_a?(Array)
             @referencia.push(*referencia)
           else
             @referencia.push(referencia)
           end
       end
 
+      def totales
+        encabezado.totales
+      end
+
       def as_node
         doc = XML::Document.new
+        param = { 'ID' => id } unless id.blank?
         doc.root = create_node('DTE', version: '1.0') do |dte|
-          dte << create_node('Documento', 'ID' => 'F100T39') do |documento|
+          dte << create_node('Documento', param) do |documento|
             documento << encabezado.as_node
             detalle.each { |d| documento << d.as_node }
-            dsc_rcg_global.each { |d| documento << d.as_node }
-            referencia.each { |r| documento << r.as_node }
+            dsc_rcg_global.each { |d| documento << d.as_node } if dsc_rcg_global && dsc_rcg_global.any?
+            referencia.each { |r| documento << r.as_node } if referencia && referencia.any?
           end
         end
         doc
       end
+
+      def autocomplete!
+        mnt_neto = 0
+        mnt_exe = 0
+        monto_nf = 0
+        detalle.each_with_index do |det, idx|
+          det.nro_lin_det = idx + 1 if det.nro_lin_det.blank?
+          det.autocomplete!
+          mnt_neto += det.monto_item if det.afecto_iva?
+          mnt_exe += det.monto_item if det.exento_iva?
+          monto_nf += det.monto_item if det.no_fact? || det.no_fact_neg?
+        end
+        if dsc_rcg_global && dsc_rcg_global.any?
+          dsc_rcg_global.each_with_index do |drg, idx|
+            drg.nro_lin_dr = idx + 1 if drg.nro_lin_dr.blank?
+            if drg.descuento?
+              mnt_neto -= drg.valor_dr
+            else
+              mnt_neto += drg.valor_dr
+            end
+          end
+        end
+        if referencia && referencia.any?
+          referencia.each_with_index do |ref, idx|
+            ref.nro_lin_ref = idx + 1 if ref.nro_lin_ref.blank?
+          end
+        end
+        totales.autocomplete!(
+          is_monto_neto: encabezado.id_doc.monto_neto?,
+          is_boleta: encabezado.id_doc.boleta?,
+          mnt_neto: mnt_neto,
+          mnt_exe: mnt_exe,
+          monto_nf: monto_nf
+        )
+        self
+      end
+
+      def to_s
+        as_node.to_s
+      end
     end
   end
 end

data/lib/facturapi/helpers/emisor.rb

@@ -1,8 +1,35 @@
 module Facturapi
   module Helpers
+    # Corresponde a los datos del Emisor de una Boleta Electronica
     class Emisor
-      attr_accessor :rut_emisor, :rzn_soc_emisor, :giro_emisor, :dir_origen,
-                    :cmna_origen, :ciudad_origen
+      # Corresponde al RUT del Emisor, con valor desde 100.000
+      # hasta 99 millones, guion y digito verificador (sin separador de miles).
+      attr_accessor :rut_emisor
+
+      # Corresponde a la razon social o nombre del contribuyente Emisor.
+      attr_accessor :rzn_soc_emisor
+
+      # Corresponde al giro del negocio del Emisor antes identificado.
+      attr_accessor :giro_emisor
+
+      # Corresponde a la direccion legal del Emisor (registrada en el SII), no
+      # se especifica la comuna ni la ciudad.
+      attr_accessor :dir_origen
+
+      # Corresponde a la comuna legal del Emisor (registrada en el SII).
+      attr_accessor :cmna_origen
+
+      # Corresponde a la ciudad legal del Emisor (registrada en el SII)
+      attr_accessor :ciudad_origen
+
+      # Indica nombre de la sucursal que emite el Documento. Corresponde a un
+      # dato administrado por el emisor que puede ser un texto o un numero, con
+      # un maximo de 20 caracteres.
+      attr_accessor :sucursal
+
+      # Corresponde a la Glosa con identificador del vendedor, con un maximo de
+      # 60 caracteres.
+      attr_accessor :cdg_vendedor
 
       def initialize(params = {})
         @rut_emisor = params[:rut_emisor]
@@ -11,16 +38,20 @@ module Facturapi
         @dir_origen = params[:dir_origen]
         @cmna_origen = params[:cmna_origen]
         @ciudad_origen = params[:ciudad_origen]
+        @sucursal = params[:sucursal]
+        @cdg_vendedor = params[:cdg_vendedor]
       end
 
       def as_node
         create_node('Emisor') do |emisor|
           emisor << create_node('RUTEmisor') { |n| n << rut_emisor }
-          emisor << create_node('RznSocEmisor') { |n| n << rzn_soc_emisor }
-          emisor << create_node('GiroEmisor') { |n| n << giro_emisor }
-          emisor << create_node('DirOrigen') { |n| n << dir_origen }
-          emisor << create_node('CmnaOrigen') { |n| n << cmna_origen }
-          emisor << create_node('CiudadOrigen') { |n| n << ciudad_origen }
+          emisor << create_node('RznSocEmisor') { |n| n << rzn_soc_emisor } if rzn_soc_emisor
+          emisor << create_node('GiroEmisor') { |n| n << giro_emisor } if giro_emisor
+          emisor << create_node('DirOrigen') { |n| n << dir_origen } if dir_origen
+          emisor << create_node('CmnaOrigen') { |n| n << cmna_origen } if cmna_origen
+          emisor << create_node('CiudadOrigen') { |n| n << ciudad_origen } if ciudad_origen
+          emisor << create_node('Sucursal') { |n| n << sucursal } if sucursal
+          emisor << create_node('CdgVendedor') { |n| n << cdg_vendedor } if cdg_vendedor
         end
       end
     end

data/lib/facturapi/helpers/encabezado.rb

@@ -7,7 +7,7 @@ module Facturapi
         @id_doc = params[:id_doc]
         @emisor = params[:emisor]
         @receptor = params[:receptor]
-        @totales = params[:totales]
+        @totales = params[:totales] || Totales.new
       end
 
       def as_node

data/lib/facturapi/helpers/id_doc.rb

@@ -1,18 +1,124 @@
 module Facturapi
   module Helpers
+    # Corresponde a la Identificacion del Documento en el encabezado de una
+    # Boleta Electronica
     class IdDoc
-      attr_accessor :tipo_dte, :folio, :fch_emis, :ind_servicio, :ind_mnt_neto,
-                    :periodo_desde, :periodo_hasta, :fch_venc
+      # Corresponde al numero de Tipo de Documento codificado por el Servicio de
+      # Impuestos Internos (SII).
+      # - 30: FACTURA
+      # - 32: FACTURA EXENTA
+      # - 33: FACTURA ELECTRONICA
+      # - 34: FACTURA EXENTA ELECTRONICA
+      # - 35: BOLETA
+      # - 38: BOLETA EXENTA
+      # - 39: BOLETA ELECTRONICA
+      # - 40: LIQUIDACION FACTURA
+      # - 41: BOLETA EXENTA ELECTRONICA
+      # - 43: LIQUIDACION FACTURA ELECTRONICA
+      # - 45: FACTURA DE COMPRA
+      # - 46: FACTURA DE COMPRA ELECTRONICA
+      # - 50: GUIA DE DESPACHO
+      # - 52: GUIA DE DESPACHO ELECTRONICA
+      # - 55: NOTA DE DEBITO
+      # - 56: NOTA DE DEBITO ELECTRONICA
+      # - 60: NOTA DE CREDITO
+      # - 61: NOTA DE CREDITO ELECTRONICA
+      attr_accessor :tipo_dte
+
+      # Es el folio del documento de acuerdo con los correlativos
+      # autorizados por el SII y disponibles para el tipo de documento antes
+      # mencionado. En el caso que se requiera auto-asignacion de folio,
+      # entonces se debe indicar el valor 0 (cero) en este campo.
+      attr_accessor :folio
+
+      # Es la fecha de emision del documento en cuestion, el formato de la fecha
+      # es "AAAA-MM-DD' (anio, mes, dia).
+      attr_accessor :fch_emis
+
+      # Corresponde a la Fecha de vencimiento y es obligatoria en
+      # el caso de una facturacion de servicios periodicos domiciliarios, el
+      # formato de la fecha es "AAAA-MM-DD' (anio, mes, dia)
+      attr_accessor :fch_venc
+
+      # Corresponde al indicador que identifica el tipo de transaccion que se
+      # realiza con el documento de acuerdo a lo codificado por el SII.
+      # - 1: Servicios Periodicos.
+      # - 2: Servicios Periodicos Domiciliarios.
+      # - 3: Ventas y Servicios.
+      # - 4: Espectaculos emitida por cuenta de terceros.
+      attr_accessor :ind_servicio
+
+      # Este indicador se utiliza para expresar que el precio unitario y el
+      # valor de todas las lineas de detalles corresponden a Montos Netos, es
+      # decir, no incluyen el IVA. Solo se aplica para empresas que tienen
+      # autorizacion para emitir las boletas desglosando el IVA. No aplica en
+      # Boleta Exenta.
+      # - 0: Lineas de Detalle indicadas en Montos Brutos.
+      # - 2: Lineas de Detalle indicadas en Montos Netos.
+      attr_accessor :ind_mnt_neto
+
+      # Es el periodo desde de una facturacion de servicios
+      # periodicos y aplica solamente para estos casos, el formato de la fecha
+      # es "AAAA-MM-DD' (anio, mes, dia).
+      attr_accessor :periodo_desde
+
+      # Es el periodo hasta de una facturacion de servicios
+      # periodicos y aplica solamente para estos casos, el formato de la fecha
+      # es "AAAA-MM-DD' (anio, mes, dia)
+      attr_accessor :periodo_hasta
+
+      # Indica si las lineas de detalle, descuentos y recargos se expresan
+      # en montos brutos. (Solo para documentos sin impuestos adicionales).
+      # Solamente se acepta el valor 1 ( <MntBruto>1</MntBruto> ).
+      # Si no se indica, se asume los valores en montos Netos.
+      attr_accessor :mnt_bruto
+
+      # (Solo para Guias de despacho) Indica si el documento acompania bienes y
+      # el despacho es por cuenta del vendedor o del comprador.
+      # No se incluye si el documento no acompania bienes o se trata de una
+      # Factura o Nota correspondiente a la prestacion de servicios.
+      # Sus valores pueden ser:
+      #
+      # - 0: Sin Despacho.
+      # - 1: Despacho por cuenta del receptor del documento (cliente o vendedor
+      #      en caso de Facturas de compra).
+      # - 2: Despacho por cuenta del emisor a instalaciones del cliente.
+      # - 3: Despacho por cuenta del emisor a otras instalaciones
+      #      (Ejemplo: entrega en Obra).
+      attr_accessor :tipo_despacho
+
+      # (Solo para Guias de despacho) Indica si el traslado de mercaderia es por
+      # Venta (valor 1) o por otros motivos que no corresponden a venta
+      # (valores mayores a 1). Sus valores pueden ser:
+      #
+      # - 1: Operacion constituye venta.
+      # - 2: Ventas por efectuar.
+      # - 3: Consignaciones.
+      # - 4: Entrega gratuita.
+      # - 5: Traslados internos.
+      # - 6: Otros traslados no venta.
+      # - 7: Guia de devolucion.
+      attr_accessor :ind_traslado
 
       def initialize(params = {})
-        @tipo_dte = params[:tipo_dte]
-        @folio = params[:folio]
-        @fch_emis = params[:fch_emis]
-        @ind_servicio = params[:ind_servicio]
-        @ind_mnt_neto = params[:ind_mnt_neto]
-        @periodo_desde = params[:periodo_desde]
-        @periodo_hasta = params[:periodo_hasta]
-        @fch_venc = params[:fch_venc]
+        @tipo_dte = params[:tipo_dte].to_s if Facturapi::Utils::DteTypes::VALID_REGEXP =~ params[:tipo_dte].to_s
+        @folio = params[:folio] || 0
+        @fch_emis = format_date(params[:fch_emis])
+        @fch_venc = format_date(params[:fch_venc])
+
+        if boleta?
+          @ind_servicio = params[:ind_servicio].to_s if /^[1-4]$/ =~ params[:ind_servicio].to_s
+          @ind_mnt_neto = params[:ind_mnt_neto].to_s if /^[02]$/ =~ params[:ind_mnt_neto].to_s
+          @periodo_desde = format_date(params[:periodo_desde])
+          @periodo_hasta = format_date(params[:periodo_hasta])
+        end
+
+        if guia_de_despacho?
+          @tipo_despacho = params[:tipo_despacho].to_s if /^[0-3]$/ =~ params[:tipo_despacho].to_s
+          @ind_traslado = params[:ind_traslado].to_s if /^[1-7]$/ =~ params[:ind_traslado].to_s
+        end
+
+        @mnt_bruto = 1 if params[:mnt_bruto]
       end
 
       def as_node
@@ -20,13 +126,40 @@ module Facturapi
           id_doc << create_node('TipoDTE') { |n| n << tipo_dte }
           id_doc << create_node('Folio') { |n| n << folio }
           id_doc << create_node('FchEmis') { |n| n << fch_emis }
-          id_doc << create_node('IndServicio') { |n| n << ind_servicio }
-          id_doc << create_node('IndMntNeto') { |n| n << ind_mnt_neto }
-          id_doc << create_node('PeriodoDesde') { |n| n << periodo_desde }
-          id_doc << create_node('PeriodoHasta') { |n| n << periodo_hasta }
           id_doc << create_node('FchVenc') { |n| n << fch_venc }
+          if boleta?
+            id_doc << create_node('IndServicio') { |n| n << ind_servicio }
+            id_doc << create_node('IndMntNeto') { |n| n << ind_mnt_neto }
+            id_doc << create_node('PeriodoDesde') { |n| n << periodo_desde }
+            id_doc << create_node('PeriodoHasta') { |n| n << periodo_hasta }
+          end
+          if guia_de_despacho?
+            id_doc << create_node('TipoDespacho') { |n| n << tipo_despacho }
+            id_doc << create_node('IndTraslado') { |n| n << ind_traslado }
+          end
+          id_doc << create_node('MntBruto') { |n| n << mnt_bruto } if mnt_bruto
         end
       end
+
+      def format_date(date)
+        date.strftime('%Y-%m-%d') if date
+      end
+
+      def monto_bruto?
+        ind_mnt_neto == '0' || mnt_bruto == 1
+      end
+
+      def monto_neto?
+        ind_mnt_neto == '2' || mnt_bruto != 1
+      end
+
+      def boleta?
+        /^39|41$/ =~ tipo_dte
+      end
+
+      def guia_de_despacho?
+        /^50|52$/ =~ tipo_dte
+      end
     end
   end
 end

data/lib/facturapi/helpers/recargo_global.rb

@@ -0,0 +1,10 @@
+module Facturapi
+  module Helpers
+    class RecargoGlobal < DscRcgGlobal
+      def initialize(params = {})
+        params[:tpo_mov] = 'R'
+        super(params)
+      end
+    end
+  end
+end

data/lib/facturapi/helpers/receptor.rb

@@ -1,11 +1,45 @@
 module Facturapi
   module Helpers
+    # Corresponde a los datos del Receptor de una Boleta Electronica.
     class Receptor
-      attr_accessor :rut_recep, :cdg_int_recep, :rzn_soc_recep, :contacto,
-                    :dir_recep, :cmna_recep, :ciudad_recep
+      RUT_AUXILIAR = '66666666-6'.freeze
+
+      # Corresponde al RUT del Cliente con valor desde 100.000 hasta 99
+      # millones, guion y digito verificador (sin separador de miles).
+      # En el caso que para una Boleta Electronica se desconozcan los datos del
+      # cliente, el SII ha proporcionado un RUT de Cliente Auxiliar para emitir
+      # en estas circunstancias.
+      attr_accessor :rut_recep
+
+      # Corresponde a la razon social o nombre del Cliente.
+      attr_accessor :rzn_soc_recep
+
+      # Corresponde a la direccion de correo electronico del Cliente a la que
+      # sera enviado el documento electronico tras su generacion. En el caso que
+      # no se desee enviar por correo electronico el documento, no debe venir
+      # informacion en este campo.
+      attr_accessor :contacto
+
+      # Corresponde a la direccion legal del Cliente (registrada en el SII), no
+      # se especifica la comuna ni la ciudad.
+      attr_accessor :dir_recep
+
+      # Corresponde a la comuna legal del Cliente (registrada en el SII)
+      attr_accessor :cmna_recep
+
+      # Corresponde a la ciudad legal del Cliente (registrada en el SII)
+      attr_accessor :ciudad_recep
+
+      # Este campo es utilizado para identificar de manera adicional al cliente,
+      # basado en una codificacion interna.
+      attr_accessor :cdg_int_recep
+
+      # Corresponde al giro del negocio del Cliente antes identificado, con un
+      # maximo de 40 caracteres
+      attr_accessor :giro_recep
 
       def initialize(params = {})
-        @rut_recep = params[:rut_recep]
+        @rut_recep = params[:rut_recep] || RUT_AUXILIAR
         @cdg_int_recep = params[:cdg_int_recep]
         @rzn_soc_recep = params[:rzn_soc_recep]
         @contacto = params[:contacto]
@@ -17,12 +51,13 @@ module Facturapi
       def as_node
         create_node('Receptor') do |receptor|
           receptor << create_node('RUTRecep') { |n| n << rut_recep }
-          receptor << create_node('CdgIntRecep') { |n| n << cdg_int_recep }
           receptor << create_node('RznSocRecep') { |n| n << rzn_soc_recep }
           receptor << create_node('Contacto') { |n| n << contacto }
           receptor << create_node('DirRecep') { |n| n << dir_recep }
           receptor << create_node('CmnaRecep') { |n| n << cmna_recep }
           receptor << create_node('CiudadRecep') { |n| n << ciudad_recep }
+          receptor << create_node('CdgIntRecep') { |n| n << cdg_int_recep } if cdg_int_recep
+          receptor << create_node('GiroRecep') { |n| n << giro_recep } if giro_recep
         end
       end
     end