facturapi 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c84c8ad9f595de425766ed65c06063b58744ae60
-  data.tar.gz: 25ffce29b83b617bfbfda57245ad1d73865fbd5a
+  metadata.gz: 9c4286989ee90c94066e323aecac710629cf2695
+  data.tar.gz: 604c064a8cdeb558f609dfa54dbdf70e7026f10c
 SHA512:
-  metadata.gz: aff36a3dce1bb173b18fe55917acb3123cf76cddfac684e1aa603f8156c5a53463c7aa130890af68f0941ca46749e20ba556d20565b7cac7d81eeb1a18a6b58a
-  data.tar.gz: 6b9ca89f47ffddbd389e46cbe7af3b50bf5686f627c909bafd7fae3ed0d3cd70e7fc1d0800aec8a3d62f7aae787a525c985fdb7509b7bd6668bdf77e9d41d210
+  metadata.gz: 30d4c5f7152e6c74d1b20484baab7f2b4d39a640f609a7ebd6533fa099552c2a1d1c877f428f9d9a1888a6302d97cdd9a4ec278814e4247f96fbdb4ebde54b85
+  data.tar.gz: 4ec0827f0b24fd5b15bdd0f7a9f3bfc6db211beda4149e4b358cfbd72c3578033166d116f527cb9cff4cebb6ef94b795a3b6b26446da292460a463e74db177e3

data/Guardfile

@@ -0,0 +1,14 @@
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/README.md

@@ -1,41 +1,138 @@
 # Facturapi
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/facturapi`. To experiment with that code, run `bin/console` for an interactive prompt.
+[![Code Climate](https://codeclimate.com/github/meloncargo/facturapi/badges/gpa.svg)](https://codeclimate.com/github/meloncargo/facturapi)
 
-TODO: Delete this and the text above, and describe your gem
+Esta gema facilita la integración con el servicio SOAP de facturacion.cl para
+aplicaciones Ruby on Rails.
 
-## Installation
+## Instalación
 
-Add this line to your application's Gemfile:
+Agrega a tu Gemfile:
 
 ```ruby
 gem 'facturapi'
 ```
 
-And then execute:
+Y luego ejecuta
 
     $ bundle
 
-Or install it yourself as:
+## Configuración
 
-    $ gem install facturapi
+Agrega a tu archivo `config/initializers/facturapi.rb`:
 
-## Usage
+```ruby
+Facturapi.configure do |config|
+  config.fact_rut '1-9'
+  config.fact_user 'usuario'
+  config.fact_password '12345'
+  config.fact_port 9350
+end
+```
+
+o también puedes definir variables de entorno en tu sistema:
+
+```
+FACTURACION_USER=1-9
+FACTURACION_RUT=usuario
+FACTURACION_PASSWORD=12345
+FACTURACION_PORT=9350
+```
 
-TODO: Write usage instructions here
+## Uso
 
-## Development
+Ejemplo mínimo de envío de boleta:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
+include Facturapi::Helpers
+
+detalle = [
+  Detalle.new(
+    vlr_codigo: '17409',
+    nmb_item: 'Reloj',
+    qty_item: '1',
+    prc_item: 20_500
+  )
+]
+
+dte = Dte.new(
+  encabezado: Encabezado.new(
+    id_doc: IdDoc.new(
+      fch_emis: Date.new(2016, 11, 14),
+      ind_servicio: 3
+    ),
+    emisor: Emisor.new(
+      rut_emisor: '1-9',
+      rzn_soc_emisor: 'SUPER EMPRESA',
+      giro_emisor: 'VENDEMOS COSAS',
+      dir_origen: 'Luis Thayer Ojeda Nº1525',
+      cmna_origen: 'Providencia',
+      ciudad_origen: 'Santiago'
+    ),
+    receptor: Receptor.new(
+      cdg_int_recep: '1000215-220',
+      rzn_soc_recep: 'Juan Perez',
+      contacto: 'juan@perez.com',
+      dir_recep: 'CALLE A 50',
+      cmna_recep: 'SANTIAGO',
+      ciudad_recep: 'SANTIAGO'
+    )
+  ),
+  detalle: detalle
+)
+# Realiza cálculos automáticos de totales, ademas de rellenar datos de
+dte.autocomplete!
+
+procesar = Facturapi::Service::Procesar.new(dte)
+response = procesar.send
+
+
+response.valid? # true
+response.error # ''
+response.folio # 4666638667
+response.tipo_dte # 39
+response.fecha # 2017-02-20 19:01:36 -0300
+puts response
+# <?xml version="1.0"?>
+# <WSPLANO>
+#   <Resultado>True</Resultado>
+#   <Mensaje>Proceso exitoso.</Mensaje>
+#   <Detalle>
+#     <Documento>
+#       <Folio>4666638667</Folio>
+#       <TipoDte>39</TipoDte>
+#       <Operacion>VENTA</Operacion>
+#       <Fecha>2017-02-20T19:01:36</Fecha>
+#       <Resultado>True</Resultado>
+#     </Documento>
+#   </Detalle>
+# </WSPLANO>
+
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Obtención de link para descargar documento tributario
 
-## Contributing
+```ruby
+obtener_link = Facturapi::Services::ObtenerLink.new(folio: '123')
+response = obtener_link.send
+
+response.url # http://www.facturacion.cl/plano/descargar.php?...
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/facturapi. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Mas información sobre los atributos aceptados por los helpers, revisa [la
+documentación](https://github.com/meloncargo/facturapi/tree/master/lib/facturapi/helpers)
+contenida en los mismos.
 
+## Why tanto spanglish?
 
-## License
+Ya que esta gema sería usada principalmente por desarrolladores chilenos y para
+facilidad de uso, toda la documentación irá en español. Además los nombres de
+clases y variables seguirán la misma nomenclatura usada en el servicio web, la
+cual es en español. Todo lo que escape a el ámbito descrito, será en inglés.
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+## Aviso Legal
 
+Esta gema no está desarrollada, soportada ni avalada de ninguna manera por
+Desis Ltda. y es el resultado de ingeniería inversa al servicio de integración
+de facturacion.cl con fines de interoperabilidad, como lo permite la [ley chilena
+20.435, artículo 71 Ñ, sección b.](http://www.leychile.cl/Navegar?idNorma=1012827)

data/config/locales/es.yml

@@ -0,0 +1,21 @@
+es:
+  facturapi:
+    dte_type:
+      factura: 'Factura'
+      factura_ex: 'Factura exenta'
+      factura_elec: 'Factura electrónica'
+      factura_ex_elec: 'Factura exenta electrónica'
+      boleta: 'Boleta'
+      boleta_ex: 'Boleta exenta'
+      boleta_elec: 'Boleta electrónica'
+      liq_factura: 'Liquidación factura'
+      boleta_ex_elec: 'Boleta exenta electrónica'
+      liq_factura_elec: 'Liquidación factura electrónica'
+      factura_compra: 'Factura de compra'
+      factura_compra_elec: 'Factura de compra electrónica'
+      guia_despacho: 'Guia de despacho'
+      guia_despacho_elec: 'Guia de despacho electrónica'
+      nota_deb: 'Nota de débito'
+      nota_deb_elec: 'Nota de débito electrónica'
+      nota_cred: 'Nota de crédito'
+      nota_cred_elec: 'Nota de crédito electrónica'

data/facturapi.gemspec

@@ -10,8 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["alter.strife@gmail.com"]
 
   spec.summary       = %q{Ruby integration with facturacion.cl service}
-  # spec.description   = %q{TODO: Write a longer description or delete this line.}
-  # spec.homepage      = ""
+  spec.homepage      = "https://github.com/meloncargo/facturapi"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
@@ -23,8 +22,10 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "savon", "~> 2.0"
   spec.add_runtime_dependency "libxml-ruby", "~> 2.0"
   spec.add_runtime_dependency "nokogiri", "~> 1.4", ">= 1.4.0"
+  spec.add_runtime_dependency "i18n", "~> 0.6"
 
-  spec.add_development_dependency "bundler", "~> 1.13"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "pry-byebug", "~> 3.4.0"
+  spec.add_development_dependency "guard-rspec", "~> 4.7.0"
 end

data/lib/facturapi.rb

@@ -1,6 +1,8 @@
+require 'facturapi/version'
 require 'facturapi/xml'
 require 'facturapi/config'
 require 'facturapi/client'
+
 require 'facturapi/helpers'
-require 'facturapi/service'
-require 'facturapi/version'
+require 'facturapi/services'
+require 'facturapi/utils'

data/lib/facturapi/client.rb

@@ -2,26 +2,38 @@ require 'savon'
 
 module Facturapi
   class Client
-    attr_accessor :client
-    attr_reader :login
+    class << self
+      def call(method, params = {})
+        params[:login] ||= login
+        client.call(method, message: params)
+      end
 
-    def initialize
-      @login = {
-        'Usuario' => Facturapi.config.fact_user,
-        'Rut' => Facturapi.config.fact_rut,
-        'Clave' => Facturapi.config.fact_password,
-        'Puerto' => Facturapi.config.fact_port
-      }
-      @client = Savon.client(
-        wsdl: 'http://ws1.facturacion.cl/WSDS/wsplano.asmx?wsdl'
-      )
-    end
+      def xml(method, params = {})
+        ops = client.operation(method)
+        params[:login] ||= login
+        Nokogiri::XML(ops.build(message: params).to_s).to_s
+      end
+
+      def client
+        @client ||= Savon.client(
+          wsdl: 'http://ws1.facturacion.cl/WSDS/wsplano.asmx?wsdl'
+        )
+      end
+
+      def operations
+        client.operations
+      end
+
+      private
 
-    def call(method, params = {})
-      params[:login] ||= login
-      puts params
-      response = @client.call(method, message: params)
-      response.body[:procesar_response][:procesar_result]
+      def login
+        @login ||= {
+          'Usuario' => Facturapi.config.fact_user,
+          'Rut' => Facturapi.config.fact_rut,
+          'Clave' => Facturapi.config.fact_password,
+          'Puerto' => Facturapi.config.fact_port
+        }
+      end
     end
   end
 end

data/lib/facturapi/helpers.rb

@@ -1,5 +1,7 @@
 require 'facturapi/helpers/detalle'
 require 'facturapi/helpers/dsc_rcg_global'
+require 'facturapi/helpers/descuento_global'
+require 'facturapi/helpers/recargo_global'
 require 'facturapi/helpers/dte'
 require 'facturapi/helpers/emisor'
 require 'facturapi/helpers/encabezado'

data/lib/facturapi/helpers/descuento_global.rb

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

data/lib/facturapi/helpers/detalle.rb

@@ -1,22 +1,117 @@
 module Facturapi
   module Helpers
+    # Corresponde a las lineas de detalle de una Boleta Electronica, con un
+    # minimo de 1 linea de detalle y un maximo de 1.000 lineas
     class Detalle
-      attr_accessor :nro_lin_det, :tpo_codigo, :vlr_codigo, :ind_exe,
-                    :rut_mandante, :nmb_item, :dsc_item, :qty_item, :unmd_item,
-                    :prc_item, :monto_item
+      # Indica el numero secuencial de linea de detalle de la Boleta
+      # Electronica, el cual puede ser desde la linea 1 hasta la linea 1.000.
+      attr_accessor :nro_lin_det
+
+      # Es el tipo de codigo que la empresa utiliza en el producto que se esta
+      # indicando en la linea de detalle; si no se tiene un tipo de codigo
+      # definido, se puede utilizar por defecto el tipo INT1.
+      attr_accessor :tpo_codigo
+
+      # Es el codigo del producto, con un maximo de 35 caracteres.
+      attr_accessor :vlr_codigo
+
+      # Indica si el producto o servicio del item es afecto, exento o es no
+      # facturable, los indicadores son:
+      #
+      # - 0: afecto a IVA
+      # - 1: exento de IVA
+      # - 2: no facturable
+      # - 6: no facturable (negativo)
+      #
+      # En caso que sea una factura, solo es necesario si se desea indicar que
+      # la linea es exenta de IVA. Los valores son:
+      #
+      # - 1: No afecto o exento de IVA
+      # - 2: Producto o servicio no es facturable
+      # - 3: Garantia de deposito por envases (Cervezas, Jugos, Aguas Minerales,
+      #      Bebidas Analcoholicas u otros autorizados por Resolucion especial)
+      # - 4: item No Venta. (Para facturas y guias de despacho (esta ultima con
+      #      Indicador Tipo de Traslado de Bienes igual a 1) y este item no
+      #      sera facturado.
+      # - 5: item a rebajar. Para guias de despacho NO VENTA que rebajan guia
+      #      anterior. En el area de referencias se debe indicar la guia
+      #      anterior.
+      # - 6: Producto o servicio no facturable negativo
+      attr_accessor :ind_exe
+
+      # Es la descripcion del producto o servicio, es decir, corresponde al
+      # nombre del producto o descripcion del servicio.
+      attr_accessor :nmb_item
+
+      # Es la cantidad del item, su valor debe ser hasta 12 digitos y 6
+      # decimales.
+      attr_accessor :qty_item
+
+      # Es el precio unitario del item, su valor debe ser hasta 16 digitos y
+      # 2 decimales.
+      attr_accessor :prc_item
+
+      # Indica el valor del item, es decir, el valor final de la linea de
+      # detalle. Este valor es bruto (con IVA), excepto cuando el campo
+      # 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:
+      #   MontoItem = PrcItem * QtyItem
+      attr_accessor :monto_item
+
+      # Corresponde al RUT del Mandante si la venta o servicio es por cuenta
+      # de otro, el cual es responsable del IVA devengado en el periodo.
+      # Debe contener valor desde 100.000 hasta 99 millones, guion y digito
+      # verificador (sin separador de miles).
+      attr_accessor :rut_mandante
+
+      # Es la descripcion adicional del producto o servicio antes indicado,
+      # con un maximo de 1.000 caracteres, en este campo se puede indicar mas
+      # informacion del producto o incluso una observacion en la linea de
+      # detalle.
+      attr_accessor :dsc_item
+
+      # Es la unidad de medida que se utiliza en el producto que se esta
+      # indicando en la linea de detalle; si no se tiene una unidad de medida
+      # definida, se puede utilizar por defecto la unidad de medida UN
+      attr_accessor :unmd_item
+
+      # Es el porcentaje de descuento del item (cuando corresponda), si el item
+      # no posee descuento se debe asignar 0 (cero) o no incluir el campo en el
+      # documento.
+      attr_accessor :descuento_pct
+
+      # Es el valor de descuento del item (cuando corresponda), si el item no
+      # posee descuento se debe asignar 0 (cero) o no incluir el campo en el
+      # documento.
+      attr_accessor :descuento_monto
+
+      # Es el porcentaje de recargo del item (cuando corresponda), si el item
+      # no posee recargo se debe asignar 0 (cero) o no incluir el campo en el
+      # documento.
+      attr_accessor :recargo_pct
+
+      # Es el valor de recargo del item (cuando corresponda), si el item no
+      # posee recargo se debe asignar 0 (cero) o no incluir el campo en el
+      # documento.
+      attr_accessor :recargo_monto
 
       def initialize(params = {})
         @nro_lin_det = params[:nro_lin_det]
-        @tpo_codigo = params[:tpo_codigo]
+        @tpo_codigo = params[:tpo_codigo] || 'INT1'
         @vlr_codigo = params[:vlr_codigo]
-        @ind_exe = params[:ind_exe]
-        @rut_mandante = params[:rut_mandante]
+        @ind_exe = /^[0126]$/ =~ params[:ind_exe].to_s ? params[:ind_exe].to_s : '0'
         @nmb_item = params[:nmb_item]
-        @dsc_item = params[:dsc_item]
-        @qty_item = params[:qty_item]
-        @unmd_item = params[:unmd_item]
-        @prc_item = params[:prc_item]
+        @qty_item = params[:qty_item].to_f.round(6)
+        @prc_item = params[:prc_item].to_f.round(2)
         @monto_item = params[:monto_item]
+        @rut_mandante = params[:rut_mandante]
+        @dsc_item = params[:dsc_item]
+        @unmd_item = params[:unmd_item] || 'UN'
+        @descuento_pct = params[:descuento_pct]
+        @descuento_monto = params[:descuento_monto]
+        @recargo_pct = params[:recargo_pct]
+        @recargo_monto = params[:recargo_monto]
       end
 
       def as_node
@@ -25,15 +120,39 @@ module Facturapi
           detalle << create_node('TpoCodigo') { |n| n << tpo_codigo }
           detalle << create_node('VlrCodigo') { |n| n << vlr_codigo }
           detalle << create_node('IndExe') { |n| n << ind_exe }
-          detalle << create_node('RUTMandante') { |n| n << rut_mandante }
           detalle << create_node('NmbItem') { |n| n << nmb_item }
-          detalle << create_node('DscItem') { |n| n << dsc_item }
           detalle << create_node('QtyItem') { |n| n << qty_item }
-          detalle << create_node('UnmdItem') { |n| n << unmd_item }
           detalle << create_node('PrcItem') { |n| n << prc_item }
           detalle << create_node('MontoItem') { |n| n << monto_item }
+          detalle << create_node('RUTMandante') { |n| n << rut_mandante } if rut_mandante
+          detalle << create_node('DscItem') { |n| n << dsc_item } if dsc_item
+          detalle << create_node('UnmdItem') { |n| n << unmd_item } if unmd_item
+          detalle << create_node('DescuentoPct') { |n| n << descuento_pct } if descuento_pct
+          detalle << create_node('DescuentoMonto') { |n| n << descuento_monto } if descuento_monto
+          detalle << create_node('RecargoPct') { |n| n << recargo_pct } if recargo_pct
+          detalle << create_node('RecargoMonto') { |n| n << recargo_monto } if recargo_monto
         end
       end
+
+      def autocomplete!
+        self.monto_item = (prc_item * qty_item).to_i if monto_item.blank?
+      end
+
+      def afecto_iva?
+        ind_exe == '0'
+      end
+
+      def exento_iva?
+        ind_exe == '1'
+      end
+
+      def no_fact?
+        ind_exe == '2'
+      end
+
+      def no_fact_neg?
+        ind_exe == '6'
+      end
     end
   end
 end