facturapi 0.0.1 → 0.1.0

data/lib/facturapi/helpers/referencia.rb

@@ -1,12 +1,70 @@
 module Facturapi
   module Helpers
+    # Corresponde a las lineas de referencia de una Boleta Electronica,
+    # etiqueta e informacion opcional con un maximo de 40
     class Referencia
-      attr_accessor :nro_lin_ref, :cod_ref, :razon_ref
+      # Indica el numero secuencial de linea de referencia de la Boleta
+      # Electronica, el cual puede ser desde la linea 1 hasta la linea 40.
+      attr_accessor :nro_lin_ref
+
+      # Corresponde a un codigo que identifique el tipo de referencia que se
+      # presentara en el formato impreso de la Boleta Electronica, ya sea para
+      # control interno o para indicar algun dato al cliente que reciba el
+      # documento. El codigo es establecido por la empresa.
+      attr_accessor :cod_ref
+
+      # Corresponde al dato alfanumerico de un codigo de referencia.
+      attr_accessor :razon_ref
+
+      # Es el codigo de tipo de documento al que se hace referencia, con un
+      # maximo de 3 caracteres. Si corresponde a un documento tributario,
+      # corresponde a un valor numerico, el cual esta codificado por el
+      # Servicio de Impuestos Internos.
+      #
+      # - 29: FACTURA
+      # - 31: FACTURA EXENTA
+      # - 32: FACTURA ELECTRONICA
+      # - 33: FACTURA EXENTA ELECTRONICA
+      # - 34: BOLETA
+      # - 37: BOLETA EXENTA
+      # - 38: BOLETA ELECTRONICA
+      # - 39: LIQUIDACION FACTURA
+      # - 44: FACTURA DE COMPRA
+      # - 45: FACTURA DE COMPRA ELECTRONICA
+      # - 49: GUIA DE DESPACHO
+      # - 51: GUIA DE DESPACHO ELECTRONICA
+      # - 54: NOTA DE DEBITO
+      # - 55: NOTA DE DEBITO ELECTRONICA
+      # - 59: NOTA DE CREDITO
+      # - 60: NOTA DE CREDITO ELECTRONICA
+      # - 800: ORDEN DE COMPRA
+      # - 801: NOTA DE PEDIDO
+      # - 802: CONTRATO
+      # - 813: CERTIFICADO DE DEPOSITO BOLSA PROD. CHILE
+      # - 814: VALE DE PRENDA BOLSA PROD. CHILE
+      #
+      # Si es alfabetico, corresponde a documentos no tributarios, normalmente
+      # definidos por requerimiento de su cliente.
+      # - HES: HOJA DE ESTADO DE SERVICIO
+      # - HAS: HOJA DE ACEPTACION DE SERVICIO
+      # - HEM: RECEPCION DE MATERIAL
+      attr_accessor :tpo_doc_ref
+
+      # Es el folio del documento referenciado, indica el numero del documento
+      # que se alterara.
+      attr_accessor :folio_ref
+
+      # Es la fecha de emision del documento al que se hace referencia, el
+      # formato de la fecha es "AAAA-MM-DD" (anio, mes, dia)
+      attr_accessor :fecha_ref
 
       def initialize(params = {})
         @nro_lin_ref = params[:nro_lin_ref]
         @cod_ref = params[:cod_ref]
         @razon_ref = params[:razon_ref]
+        @tpo_doc_ref = params[:tpo_doc_ref]
+        @folio_ref = params[:folio_ref]
+        @fecha_ref = params[:fecha_ref]
       end
 
       def as_node
@@ -14,6 +72,9 @@ module Facturapi
           referencia << create_node('NroLinRef') { |n| n << nro_lin_ref }
           referencia << create_node('CodRef') { |n| n << cod_ref }
           referencia << create_node('RazonRef') { |n| n << razon_ref }
+          referencia << create_node('TpoDocRef') { |n| n << tpo_doc_ref } if tpo_doc_ref
+          referencia << create_node('FolioRef') { |n| n << folio_ref } if folio_ref
+          referencia << create_node('FechaRef') { |n| n << fecha_ref } if fecha_ref
         end
       end
     end

data/lib/facturapi/helpers/totales.rb

@@ -1,18 +1,97 @@
 module Facturapi
   module Helpers
+    # Corresponde a los valores totales de una Boleta Electronica.
     class Totales
-      attr_accessor :mnt_neto, :mnt_exe, :iva, :mnt_total, :monto_nf,
-                    :total_periodo, :saldo_anterior, :vlr_pagar
+      IVA = 0.19
+
+      # Corresponde al valor Neto de la boleta electronica, solamente se indica
+      # en el caso que el sea una boleta afecta y que IndMntNeto tenga el
+      # valor 2. Al ser un campo de monto, se debe indicar sin decimales y sin
+      # separadores de miles. Se calcula de la siguiente forma:
+      #
+      #   MntNeto = Suma de MontoItem por linea de detalle - Descuentos + Recargos
+      #   # Solamente MontoItem de los items que tienen IndExe = 0
+      #   # Descuentos y Recargos basados en etiqueta <DscRcgGlobal>
+      attr_accessor :mnt_neto
+
+      # Corresponde al valor Exento de la boleta electronica. Al ser un campo de
+      # monto, se debe indicar sin decimales y sin separadores de miles.
+      # Se calcula de la siguiente forma:
+      #
+      #   MntExe = Suma de ValorExento por linea de detalle
+      #   # Solamente MontoItem de los items que tienen IndExe = 1
+      attr_accessor :mnt_exe
+
+      # Corresponde al valor IVA (Impuesto al Valor Agregado) de la boleta
+      # electronica, solamente se indica en el caso que el sea una boleta afecta
+      # y que IndMntNeto tenga el valor 2. Al ser un campo de monto, se debe
+      # indicar sin decimales y sin separadores de miles.
+      # Se calcula de la siguiente forma:
+      #
+      #   IVA = MntNeto * 19%
+      attr_accessor :iva
+
+      # Corresponde al valor total de la boleta electronica y se puede calcular
+      # de dos maneras diferentes. Al ser un campo de monto, se debe indicar sin
+      # decimales y sin separadores de miles.
+      # Se calcula de la siguiente forma:
+      #
+      #   # Para el caso que se indique una boleta afecta y que IndMntNeto tenga
+      #   # el valor 2, se calcula:
+      #   MntTotal = MntNeto + IVA + MntExe
+      #   # Para el caso que no se indique IndMntNeto, o tenga el valor 0, se
+      #   # calcula:
+      #   MntTotal = Suma de MontoItem por linea de detalle - Descuentos + Recargos
+      #   # Solamente MontoItem de los items que tienen IndExe = 0
+      #   # Descuentos y Recargos basados en etiqueta <DscRcgGlobal>
+      attr_accessor :mnt_total
+
+      # Corresponde a la suma de los montos de bienes o servicios no facturables
+      # de la boleta electronica. Los montos no facturables pueden ser
+      # negativos. Al ser un campo de monto, se debe indicar sin decimales y sin
+      # separadores de miles. Se calcula de la siguiente forma:
+      #
+      #   MontoNF = Suma de MontoItem por linea de detalle
+      #   # Solamente MontoItem de los items que tienen IndExe igual a 2 y 6.
+      attr_accessor :monto_nf
+
+      # Corresponde a la suma final del documento, tomando el total y el monto
+      # no facturable en la boleta electronica. Al ser un campo de monto, se
+      # debe indicar sin decimales y sin separadores de miles.
+      # Se calcula de la siguiente forma:
+      #
+      #   TotalPeriodo = MntTotal + MontoNF
+      attr_accessor :total_periodo
+
+      # Corresponde al saldo anterior de un periodo, esta es informacion
+      # ilustrativa en la boleta electronica, es decir, que se utiliza para el
+      # formato impreso del documento. Si no se desea usar, se debe asignar
+      # 0 (cero). Al ser un campo de monto, se debe indicar sin decimales y sin
+      # separadores de miles.
+      attr_accessor :saldo_anterior
+
+      # Es el valor cobrado de la transaccion realizada. Al ser un campo de
+      # monto, se debe indicar sin decimales y sin separadores de miles.
+      # Se calcula de la siguiente forma:
+      #
+      #   VlrPagar = MntTotal + SaldoAnterior
+      attr_accessor :vlr_pagar
+
+      # Corresponde a la tasa de impuesto al valor agregado (IVA), este valor
+      # debe ser expresado en porcentaje
+      attr_accessor :tasa_iva
 
       def initialize(params = {})
-        @mnt_neto = params[:mnt_neto]
-        @mnt_exe = params[:mnt_exe]
-        @iva = params[:iva]
-        @mnt_total = params[:mnt_total]
-        @monto_nf = params[:monto_nf]
-        @total_periodo = params[:total_periodo]
-        @saldo_anterior = params[:saldo_anterior]
-        @vlr_pagar = params[:vlr_pagar]
+        @mnt_neto = params[:mnt_neto].to_i if params[:mnt_neto]
+        @mnt_exe = params[:mnt_exe].to_i if params[:mnt_exe]
+        @iva = params[:iva].to_i if params[:iva]
+        @mnt_total = params[:mnt_total].to_i if params[:mnt_total]
+        @monto_nf = params[:monto_nf].to_i if params[:monto_nf]
+        @total_periodo = params[:total_periodo].to_i if params[:total_periodo]
+        @saldo_anterior = params[:saldo_anterior].to_i
+        @vlr_pagar = params[:vlr_pagar].to_i if params[:vlr_pagar]
+        @tasa_iva = params[:tasa_iva]
+        autocomplete! if params[:auto]
       end
 
       def as_node
@@ -21,11 +100,37 @@ module Facturapi
           totales << create_node('MntExe') { |n| n << mnt_exe }
           totales << create_node('IVA') { |n| n << iva }
           totales << create_node('MntTotal') { |n| n << mnt_total }
-          totales << create_node('MontoNF') { |n| n << monto_nf }
-          totales << create_node('TotalPeriodo') { |n| n << total_periodo }
-          totales << create_node('SaldoAnterior') { |n| n << saldo_anterior }
-          totales << create_node('VlrPagar') { |n| n << vlr_pagar }
+          totales << create_node('MontoNF') { |n| n << monto_nf } if monto_nf
+          totales << create_node('TotalPeriodo') { |n| n << total_periodo } if total_periodo
+          totales << create_node('SaldoAnterior') { |n| n << saldo_anterior } if saldo_anterior
+          totales << create_node('VlrPagar') { |n| n << vlr_pagar } if vlr_pagar
+          totales << create_node('TasaIVA') { |n| n << tasa_iva } if tasa_iva
+        end
+      end
+
+      def autocomplete!(params = {})
+        is_monto_neto = params[:is_monto_neto]
+        mnt_neto = params[:mnt_neto]
+        mnt_exe = params[:mnt_exe]
+        monto_nf = params[:monto_nf]
+        is_boleta = params[:is_boleta]
+        self.tasa_iva = IVA * 100 if !is_boleta && tasa_iva.blank?
+        if is_monto_neto && mnt_neto
+          self.mnt_neto = mnt_neto if self.mnt_neto.blank?
+          self.iva = (mnt_neto * (tasa_iva || IVA * 100) / 100).to_i if iva.blank?
         end
+        self.mnt_exe = mnt_exe || 0 if self.mnt_exe.blank?
+        self.monto_nf = monto_nf || 0 if self.monto_nf.blank?
+
+        if mnt_total.blank? && mnt_neto
+          self.mnt_total = is_monto_neto ? auto_mnt_total : mnt_neto
+        end
+        self.total_periodo = mnt_total + self.monto_nf if total_periodo.blank?
+        self.vlr_pagar = mnt_total + saldo_anterior if vlr_pagar.blank?
+      end
+
+      def auto_mnt_total
+        mnt_neto + iva + mnt_exe
       end
     end
   end

data/lib/facturapi/services.rb

@@ -0,0 +1,2 @@
+require 'facturapi/services/obtener_link'
+require 'facturapi/services/procesar'

data/lib/facturapi/services/obtener_link.rb

@@ -0,0 +1,50 @@
+require 'facturapi/services/responses/obtener_link'
+
+module Facturapi
+  module Services
+    # Obtiene el Link de descarga del Documento Tributario una vez que este ha
+    # sido generado y enviado al SII.
+    # Se puede utilizar directamente el indicador "IncluyeLink" al procesar, en
+    # caso que se desee obtener los link de Impresion al emitir.
+    class ObtenerLink
+      # Corresponde al tipo de movimiento asociado al documento enviado:
+      # C = Compra
+      # V = Venta
+      # B = Boleta
+      attr_accessor :tpomov
+
+      # Corresponde al numero de Folio del Documento.
+      attr_accessor :folio
+
+      # Corresponde al Tipo de Documento (Tipo DTE)
+      attr_accessor :tipo
+
+      # Indica si se obtendra la copia cedible del PDF.
+      # True = Se obtiene copia Cedible.
+      # False = Se obtiene la copia Original.
+      attr_accessor :cedible
+
+      def initialize(params)
+        @tpomov = Base64.strict_encode64(params[:tpomov] || 'B')
+        @folio = Base64.strict_encode64(params[:folio].to_s)
+        @tipo = Base64.strict_encode64 (params[:tipo] || '39').to_s
+        @cedible = Base64.strict_encode64(params[:cedible] ? 'True' : 'False')
+      end
+
+      def send
+        response = Facturapi::Client.call(:obtener_link, params)
+        Facturapi::Services::Responses::ObtenerLink.new(
+          response.body[:obtener_link_response][:obtener_link_result]
+        )
+      end
+
+      def params
+        { tpomov: tpomov, folio: folio, tipo: tipo, cedible: cedible }
+      end
+
+      def to_s
+        Facturapi::Client.xml(:obtener_link, params)
+      end
+    end
+  end
+end

data/lib/facturapi/services/procesar.rb

@@ -0,0 +1,30 @@
+require 'facturapi/services/responses/procesar'
+
+module Facturapi
+  module Services
+    # Permite procesar el archivo de Integracion y generar el DTE (Documento
+    # Tributario Electronico).
+    class Procesar
+      attr_accessor :dte
+
+      def initialize(dte)
+        @dte = dte
+      end
+
+      def send
+        response = Facturapi::Client.call(:procesar, params)
+        Facturapi::Services::Responses::Procesar.new(
+          response.body[:procesar_response][:procesar_result]
+        )
+      end
+
+      def params
+        { file: Base64.strict_encode64(dte.as_node.to_s), formato: 2 }
+      end
+
+      def to_s
+        Facturapi::Client.xml(:procesar, params)
+      end
+    end
+  end
+end

data/lib/facturapi/services/responses.rb

@@ -0,0 +1 @@
+require 'facturapi/services/responses/procesar'

data/lib/facturapi/services/responses/obtener_link.rb

@@ -0,0 +1,17 @@
+module Facturapi
+  module Services
+    module Responses
+      class ObtenerLink
+        attr_reader :response
+
+        def initialize(response)
+          @response = Nokogiri::XML(response)
+        end
+
+        def url
+          Base64.strict_decode64 response.css('WSPLANO>Mensaje').text
+        end
+      end
+    end
+  end
+end

data/lib/facturapi/services/responses/procesar.rb

@@ -0,0 +1,33 @@
+module Facturapi
+  module Services
+    module Responses
+      class Procesar
+        attr_reader :response
+
+        def initialize(response)
+          @response = Nokogiri::XML(response)
+        end
+
+        def valid?
+          response.css('WSPLANO>Resultado').text == 'True'
+        end
+
+        def error
+          response.css('Documento>Error').text
+        end
+
+        def folio
+          response.css('Documento>Folio').text.to_i
+        end
+
+        def tipo_dte
+          response.css('Documento>TipoDte').text.to_i
+        end
+
+        def fecha
+          Time.strptime(response.css('Documento>Fecha').text, '%FT%T')
+        end
+      end
+    end
+  end
+end

data/lib/facturapi/utils.rb

@@ -0,0 +1 @@
+require 'facturapi/utils/dte_types'

data/lib/facturapi/utils/dte_types.rb

@@ -0,0 +1,38 @@
+require 'i18n'
+
+module Facturapi
+  module Utils
+    module DteTypes
+      DOCUMENTS = {
+        30 => :factura,
+        32 => :factura_ex,
+        33 => :factura_elec,
+        34 => :factura_ex_elec,
+        35 => :boleta,
+        38 => :boleta_ex,
+        39 => :boleta_elec,
+        40 => :liq_factura,
+        41 => :boleta_ex_elec,
+        43 => :liq_factura_elec,
+        45 => :factura_compra,
+        46 => :factura_compra_elec,
+        50 => :guia_despacho,
+        52 => :guia_despacho_elec,
+        55 => :nota_deb,
+        56 => :nota_deb_elec,
+        60 => :nota_cred,
+        61 => :nota_cred_elec
+      }.freeze
+
+      VALID_REGEXP = Regexp.new("^#{DOCUMENTS.keys.join('|')}$")
+
+      def self.sym(dte_type)
+        DOCUMENTS[dte_type]
+      end
+
+      def self.humanized(dte_type)
+        I18n.t "facturapi.dte_type.#{sym(dte_type)}"
+      end
+    end
+  end
+end

data/lib/facturapi/version.rb

@@ -1,3 +1,3 @@
 module Facturapi
-  VERSION = "0.0.1"
+  VERSION = '0.1.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facturapi
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Alter Lagos
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-02-03 00:00:00.000000000 Z
+date: 2017-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: savon
@@ -59,19 +59,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.4.0
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
-  type: :development
+        version: '0.6'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -100,6 +100,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
 description: 
 email:
 - alter.strife@gmail.com
@@ -114,33 +142,40 @@ files:
 - ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
+- Guardfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- config/locales/es.yml
 - facturapi.gemspec
-- foo.xml
-- lala.html
 - lib/facturapi.rb
 - lib/facturapi/client.rb
 - lib/facturapi/config.rb
 - lib/facturapi/helpers.rb
+- lib/facturapi/helpers/descuento_global.rb
 - lib/facturapi/helpers/detalle.rb
 - lib/facturapi/helpers/dsc_rcg_global.rb
 - lib/facturapi/helpers/dte.rb
 - lib/facturapi/helpers/emisor.rb
 - lib/facturapi/helpers/encabezado.rb
 - lib/facturapi/helpers/id_doc.rb
+- lib/facturapi/helpers/recargo_global.rb
 - lib/facturapi/helpers/receptor.rb
 - lib/facturapi/helpers/referencia.rb
 - lib/facturapi/helpers/totales.rb
-- lib/facturapi/service.rb
-- lib/facturapi/service/procesar.rb
+- lib/facturapi/services.rb
+- lib/facturapi/services/obtener_link.rb
+- lib/facturapi/services/procesar.rb
+- lib/facturapi/services/responses.rb
+- lib/facturapi/services/responses/obtener_link.rb
+- lib/facturapi/services/responses/procesar.rb
+- lib/facturapi/utils.rb
+- lib/facturapi/utils/dte_types.rb
 - lib/facturapi/version.rb
 - lib/facturapi/xml.rb
-- todo.rb
-homepage: 
+homepage: https://github.com/meloncargo/facturapi
 licenses:
 - MIT
 metadata: {}