gdexpress 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 84c9da46ca168d64a7ddaf1bdb4b15e0647934e5
-  data.tar.gz: cafd79fcd51ba1a2cb59b9217688ceb24d17121a
+  metadata.gz: 65f885812fabe2e3eb0d0a1f42e4cedcf401421c
+  data.tar.gz: def59df1ce17eb85cf8e072025841d1ff87f5374
 SHA512:
-  metadata.gz: 1bcc26c5b6f1d46087481480a3be03fb77ebd08a281505179891f011ad2a1dd70f86e800c30c0f7b93777f76d904906f0353e4e7cb119d120cebd49f9702fd36
-  data.tar.gz: 62a9cf1348e20e6d2c2e4cc2be5ef551408f019c575139fe149d87614c930ee4f36bccd159d5900d7a55ba424a2ca44ddc968ccae9dd464f2b860a2a23a6fd6b
+  metadata.gz: 8fd73362b879119d1c60a1b8620c27e79d0fd385461b498f5bc7d1e5385be00a5607dbaf204b695ef95b92ecb6749bbaa824d5f2f36f51d24567c1914697c26b
+  data.tar.gz: 248d8bbc9e9595ebcae0034949bc1ef0a99379cb24d1b8168cde2d3bd6da9889153bdd4c2bb0f770e621a697ee68b9b5715aa2a275822427a1c95cddca63636c

data/README.md

@@ -1,29 +1,89 @@
-# Gdexpress
+# Gdexpress API Client
 
-TODO: Write a gem description
+Un _wrapper_ básico para la API de [Gdexpress](http://gdexpress.cl/)
 
-## Installation
+**Gdexpress** es un servicio de emisión de Documentos Tributarios Electrónicos, ```DTE```, para Chile: [Facturación Electrónica en Chile](https://palena.sii.cl/dte/menu.html)
 
-Add this line to your application's Gemfile:
+
+## Requisitos
+
+* Ruby 1.9.3 o mayor,
+* Tener una cuenta con [Gdexpress](http://gdexpress.cl/)
+
+## Instalación
+
+Agrega esto a tu archivo Gemfile:
 
     gem 'gdexpress'
 
-And then execute:
+y luego ejecuta:
 
     $ bundle
 
-Or install it yourself as:
+O instalalo tu mismo:
 
     $ gem install gdexpress
 
-## Usage
+## Uso
+
+```ruby
+ # api_token: el código de autorización entregado por el dte_box
+ # dte_box: es la IP del servidor instalado por gdexpress
+ # environment: es el ambiente: testing o producction
+ gd_client = Gdexpress::Client.new( 
+				api_token: "123456",
+				dte_box: "192.168.0.1",
+				environment: :testing
+			)
+ # dte es un objecto que responde a los siguentes métodos:
+ # rut_emisor: RUT de empresa que emite el DTE,
+ # tipo_dte: mirar http://www.sii.cl/factura_electronica/formato_dte.pdf
+ # folio: número del DTE
+ dte = OpenStruct.new rut_emisor: 11111111-1, tipo_dte: 33, folio: 28
+ 
+ # Revisa si el documento fue procesado por el SII
+ # Devuelve true o false
+ gd_client.processed? dte
+
+ # Revisa si el documento fue aceptado por el SII
+ # Devuelve true o false
+ gd_client.accepted? dte
+ 
+ # Devuelve XML con el tracking del documento
+ gd_client.tracking dte
+ 
+ # Devuelve XML del DTE
+ gd_client.recover_xml dte
+ 
+ # Devuelve string base64 que representa el PDF del DTE
+ pdf64= gd_client.recover_pdf_base64 dte
+ 
+ # Decodificas de base64
+ pdf = Base64.decode64(pdf64)
+ 
+ # Creas el archivo PDF
+ File.open("/tmp/pdf.pdf", 'wb') do |f|
+   f.write pdf
+ end
 
-TODO: Write usage instructions here
+```
 
-## Contributing
+## Contribuye
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+3. Test your changes
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create new Pull Request
+
+## Copyright
+Copyright 2014 IT Linux LTDA.
+GdExpress es una marca registrada de GDE S.A.
+
+Licensed under the MIT License, you may not use this file except in compliance with the License. You may obtain a copy of the License at
+
+http://opensource.org/licenses/MIT
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+

data/lib/gdexpress.rb

@@ -1,4 +1,5 @@
 require "open-uri"
+require 'nokogiri'
 
 require "gdexpress/version"
 require "gdexpress/client"

data/lib/gdexpress/client.rb

@@ -1,5 +1,3 @@
-require 'nokogiri'
-
 module Gdexpress
   class Client
     
@@ -35,7 +33,7 @@ module Gdexpress
       begin
         response = fiscal_status dte  
       rescue DTENotFound => e
-        # Si no lo encontramos puede que aun haya llegado a
+        # Si no lo encontramos puede que aun no haya llegado a
         # GDexpress Cloud, por eso decimos que no se ha procesado
         return false
       end
@@ -89,12 +87,24 @@ module Gdexpress
     def get(method, dte)
       uri = make_uri dte, method
       response = parse_xml Nokogiri::XML(open(uri, "AuthKey" => api_token))
+      process_response response, uri
+    end
+    
+    def process_response(response, uri = nil)
+      return raise_api_call(response, uri) if response[:result].nil?
       raise AccessDenied, "Invalid AuthKey" if response[:description] == "AccesoDenegado"
       raise DTENotFound, "DTE Not Found" if response[:result] == "14"
-      raise GdeFailledCall, "API Call failed" if response[:result] != "0"
+      raise GDEError, "GDEError: #{response[:description]}" if response[:result] != "0"
       response
     end
     
+    def raise_api_call(response, uri = nil)
+      response = Nokogiri::XML(open(uri, "AuthKey" => api_token))
+      error = response.at_css("#content").children[3].text
+      error << "\nURI: #{uri}"
+      raise GDEFailledCall, "API Call failed: #{error}"
+    end
+    
     def make_uri(dte, method)
       base_uri = "http://#{dte_box}#{API_ENDPOINTS[method.to_sym]}#{GD_ENVIRONMENTS[environment.to_sym]}/"
 

data/lib/gdexpress/dte.rb

@@ -23,10 +23,8 @@ module Gdexpress
     end
     
     def normalize_rut
-      tmp_rut = rut_emisor.gsub(/\.|-/,"")
-      cv = tmp_rut.chop
-      tmp_rut.chop!
-      self.rut_emisor = "#{tmp_rut}-#{cv}"
+      tmp_rut = rut_emisor.gsub(/\./,"")
+      tmp_rut.gsub(/k$/, "K")
     end
     
   end

data/lib/gdexpress/exceptions.rb

@@ -4,5 +4,5 @@ end
 class AccessDenied < StandardError
 end
 
-class GdeFailledCall < StandardError
+class GDEFailledCall < StandardError
 end

data/lib/gdexpress/version.rb

@@ -1,3 +1,3 @@
 module Gdexpress
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/test/fake_gd_express.rb

@@ -1,4 +1,5 @@
 require 'sinatra/base'
+require 'pp'
 
 class FakeGdExpress < Sinatra::Base
   
@@ -9,11 +10,17 @@ class FakeGdExpress < Sinatra::Base
                  "RecoverPdf" => "recover_pdf",
                  "RecoverXml" => "recover_xml"
                }
+               
+  AMBIENTES = [:P, :T]
   
-  get '/api/Core.svc/Core/:method/:ambiente/:rut_emisor/:tipo_dete/:folio' do
+  get '/api/Core.svc/Core/:method/:ambiente/:rut_emisor/:tipo_dte/:folio' do
     return access_denied unless authenticate(env)
     xml_response 200, params[:method], params[:folio]
   end
+  
+  not_found do
+    return api_call_failed 
+  end
 
   private
 
@@ -28,6 +35,12 @@ class FakeGdExpress < Sinatra::Base
     File.open(File.dirname(__FILE__) + '/fixtures/' + "access_denied.xml", 'rb').read
   end
   
+  def api_call_failed
+    content_type :xml
+    status 200
+    File.open(File.dirname(__FILE__) + '/fixtures/' + "failled_api_call.xml", 'rb').read
+  end
+  
   def xml_response(response_code, method, folio)
     content_type :xml
     status response_code

data/test/fixtures/failled_api_call.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <title>Service</title>
+    <style>BODY { color: #000000; background-color: white; font-family: Verdana; margin-left: 0px; margin-top: 0px; } #content { margin-left: 30px; font-size: .70em; padding-bottom: 2em; } A:link { color: #336699; font-weight: bold; text-decoration: underline; } A:visited { color: #6699cc; font-weight: bold; text-decoration: underline; } A:active { color: #336699; font-weight: bold; text-decoration: underline; } .heading1 { background-color: #003366; border-bottom: #336699 6px solid; color: #ffffff; font-family: Tahoma; font-size: 26px; font-weight: normal;margin: 0em 0em 10px -20px; padding-bottom: 8px; padding-left: 30px;padding-top: 16px;} pre { font-size:small; background-color: #e5e5cc; padding: 5px; font-family: Courier New; margin-top: 0px; border: 1px #f0f0e0 solid; white-space: pre-wrap; white-space: -pre-wrap; word-wrap: break-word; } table { border-collapse: collapse; border-spacing: 0px; font-family: Verdana;} table th { border-right: 2px white solid; border-bottom: 2px white solid; font-weight: bold; background-color: #cecf9c;} table td { border-right: 2px white solid; border-bottom: 2px white solid; background-color: #e5e5cc;}</style>
+  </head>
+  <body>
+    <div id="content">
+      <p class="heading1">Service</p>
+      <p xmlns="">Endpoint not found. Please see the <a rel="help-page" href="http://192.168.0.17/api/Core.svc/core/help">service help page</a> for constructing valid requests to the service.</p>
+    </div>
+  </body>
+</html>

data/test/gdexpress_test.rb

@@ -25,8 +25,8 @@ class GdexpressTest < MiniTest::Test
     @dte.folio = 1022
     assert_raises(DTENotFound) { @gd_client.fiscal_status(@dte) }
     assert_raises(DTENotFound) { @gd_client.tracking(@dte) }
-    assert_raises(DTENotFound) { @gd_client.recover_pdf_base64(@dte) }
-    assert_raises(DTENotFound) { @gd_client.recover_xml(@dte) }
+    #assert_raises(DTENotFound) { @gd_client.recover_pdf_base64(@dte) }
+    #assert_raises(DTENotFound) { @gd_client.recover_xml(@dte) }
   end
   
   def test_processed_should_return_true_or_false_based_on_fiscal_status
@@ -43,4 +43,14 @@ class GdexpressTest < MiniTest::Test
     assert(!@gd_client.accepted?(@dte), "Deberia ser rechazado")
   end
   
+  def test_raise_api_call_failled
+    gd_client = Gdexpress::Client.new(
+          api_token: "123456",
+          dte_box: @api_host,
+          environment: :not_valid
+        )
+    
+    assert_raises(GDEFailledCall) { gd_client.fiscal_status(@dte) }
+  end
+  
 end

metadata

@@ -1,97 +1,97 @@
 --- !ruby/object:Gem::Specification
 name: gdexpress
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Patricio Bruna
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-19 00:00:00.000000000 Z
+date: 2014-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '10.4'
 - !ruby/object:Gem::Dependency
   name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.4'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.20'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.20'
 - !ruby/object:Gem::Dependency
   name: minitest-reporters
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.0.0.beta3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 1.0.0.beta3
 description: 'GDexpress API Wrapper: www.gdexpress.cl'
@@ -101,7 +101,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
+- .gitignore
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -121,6 +121,7 @@ files:
 - test/fixtures/28_recover_xml.xml
 - test/fixtures/28_tracking.xml
 - test/fixtures/access_denied.xml
+- test/fixtures/failled_api_call.xml
 - test/fixtures/not_found.xml
 - test/gdexpress_test.rb
 - test/test_helper.rb
@@ -134,17 +135,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ~>
     - !ruby/object:Gem::Version
       version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.0.2
 signing_key: 
 specification_version: 4
 summary: '["Permite comunicarse con la API WS de GDexpress para emitir DTEs en Chile"]'
@@ -158,6 +159,7 @@ test_files:
 - test/fixtures/28_recover_xml.xml
 - test/fixtures/28_tracking.xml
 - test/fixtures/access_denied.xml
+- test/fixtures/failled_api_call.xml
 - test/fixtures/not_found.xml
 - test/gdexpress_test.rb
 - test/test_helper.rb