MX-Banxico 1.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1137c2b18fed5bb10d083f917faaaf2dd3e0f428
+  data.tar.gz: ff012be3f2c8a839aea8136170c8f234116671e8
+SHA512:
+  metadata.gz: 4c996b8f71622192ae061f31fe6dfceb3a9548f59cad6fbc2eae4721cb84748c015a7e46e36207dbcc686a5df0678ed5e183ffd4e37cee7a50441dfc3a398fdf
+  data.tar.gz: 9924eb9b7e1a6afbf3955b75f119e7e974063daa65785ff60cd56048f6f6a02d7992552edf3a3fb606ae87e8e0513c797a97f330c2dc36884deb7f1fa5fe8a2e

data/.gitignore

@@ -0,0 +1,18 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*.gem
+.ruby-version
+.ruby-gemset
+mkmf.log
+.DS_Store

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format progress
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+
+before_install:
+  - gem install bundler -v '>= 1.12'
+
+rvm:
+  - ruby-head
+
+addons:
+  code_climate:
+    repo_token:
+      secure: "V+kAHFHYVxk3INQ92tjdHWzpkgpec6Hi3cZmI3kfirh12c8BuQsJy187ySjDuzyq6uPF4+WXUBUBoErZBi3SRI0u+qGavpjVEf6onlrykwfBHutYWMjkFybNZ03wKKNK+kSOLWrxOsdrjhFsnZ1SffliaIzxbT+DL2mWpiWkUBQmsBVwjKNpXBP5UowFnbwnaQpAdb7F9diGA83IcBpFueWx+q9ER+ekvNiGs30FmghJVsSveo7VVcWk+Tu8tPsXFwR2b9J3QZ1Ik4alldzVHWNv+O+a75WsJkpXV6eA+CojJ/S8HlhppN3yTUSIxd/fs05QEB+uM+1IsJ2I6IKJ1XsD9KG10kdUCUUL+tr8svfw5pdeqgouEiz4VbrN5wpt869OJznHsZIwQbMmJ3xtEcvD+v1ii260T3wfOFonjCBZOWNvru1xyFwDgoB4UJ2ucbFvKezwtnV5tPcGJqdEVfgM6NopwTKwcs95DRCkRDqB4prH3qGdu0ouu9i+b3c8JnUrny5pr+w/HTizL5lY5uiDIxJdQ5RiAoqMVGIdca4dWkWm+LvUiSCOam2Qf7loGnUcEtk+61BISzYQe7lBqyEMiKrU2b/Lp4mahvI/Q+UpPnsbVfCn5ecMMN4prnmKYVZDdrmgR0t1vEBC4+fy4pJClIOT51gLknYaiwz39dE="

data/.yardopts

@@ -0,0 +1,9 @@
+--title 'MX-Banxico'
+--output-dir ./doc
+--markup-provider redcarpet
+--markup markdown
+--protected --private
+--readme README.md
+lib/**/*.rb - LICENSE.txt REFERENCIAS.md CHANGELOG.md
+
+

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog / Bitácora de cambios
+
+* **Versión 0.0.1.pre**
+  * Primera implementación de web service para obtención del tipo de cambio.
+  * Es posible recuperar seriee históricas, haciendo una petición POST al mismo lugar donde lo hace la página web de consultas históricas de BANXICO.

data/Gemfile

@@ -0,0 +1,36 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :ci_filter do
+  gem 'guard'
+  gem 'guard-bundler', require: false
+  gem 'guard-rspec', require: false
+  gem 'pry'
+  gem 'pry-remote'
+  gem 'pry-byebug', platform: [:mri_20, :mri_21, :mri_22]
+  gem 'pry-nav', platform: [:mri_19, :jruby]
+  gem 'terminal-notifier'
+  gem 'terminal-notifier-guard'
+end
+
+group :development, :test do
+  gem 'bundler'
+  gem 'rake'
+  gem 'rspec'
+end
+
+group :test do
+  gem 'codeclimate-test-reporter'
+  gem 'simplecov', require: false
+  gem 'coveralls', require: false
+  gem 'rspec-collection_matchers'
+  gem 'shoulda-matchers', require: false
+  gem 'webmock', require: false
+end
+
+group :doc do
+  gem 'yard'
+  gem 'redcarpet'
+  gem 'github-markup'
+end

data/Guardfile

@@ -0,0 +1,26 @@
+guard :rspec, cmd: "bundle exec rspec", cmd_additional_args: '-f progress', failed_mode: :focus 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
+
+guard :bundler do
+  require 'guard/bundler'
+  require 'guard/bundler/verify'
+  helper = Guard::Bundler::Verify.new
+
+  files = ['Gemfile']
+  files += Dir['*.gemspec'] if files.any? { |f| helper.uses_gemspec?(f) }
+
+  # Assume files are symlinked from somewhere
+  files.each { |file| watch(helper.real_path(file)) }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2016 Pablo Ruiz
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/MX-Banxico.gemspec

@@ -0,0 +1,29 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'MX/Banxico/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "MX-Banxico"
+  spec.version       = MX::Banxico::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["Pablo Ruiz"]
+  spec.email         = ["pjruiz@maquech.com.mx"]
+  spec.summary       = %q{Banco de México web services utilities / Utilerías para usar los servicios web del Banco de México (Banxico)}
+  spec.description   = %q{Banco de México web services utilities / Utilerías para usar los servicios web del Banco de México (Banxico)}
+  spec.homepage      = "https://github.com/Maquech/MX-Banxico"
+  spec.license       = "MIT"
+  
+  spec.required_ruby_version  = '>= 2.0'
+  
+  spec.add_dependency 'nokogiri', '~> 1.6'
+  spec.add_dependency 'httparty', '~> 0.13'
+  spec.add_dependency 'savon', '~> 2.11'
+  
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  
+  spec.post_install_message   = "¡Viva México!"
+  
+end

data/README.md

@@ -0,0 +1,140 @@
+# MX::Banxico
+
+
+[![Gem Version](https://badge.fury.io/rb/MX-Banxico.png)](https://badge.fury.io/rb/MX-Banxico) [![Build Status](https://travis-ci.org/Maquech/MX-Banxico.svg?branch=master)](https://travis-ci.org/Maquech/MX-Banxico) [![Code Climate](https://codeclimate.com/github/Maquech/MX-Banxico/badges/gpa.svg)](https://codeclimate.com/github/Maquech/MX-Banxico) [![Test Coverage](https://codeclimate.com/github/Maquech/MX-Banxico/badges/coverage.svg)](https://codeclimate.com/github/Maquech/MX-Banxico/coverage)
+
+
+
+## Why and what for / Por qué y para qué
+
+This gem was conceived as an aid in the automation of information extraction from the web site and web services provided by
+the [Bank of Mexico](http://www.banxico.org.mx).
+
+
+This project is not endorsed in any way by the Mexican government. It's an effort to contribute to the preservation of mental
+health of the developers who have to deal with this things :)
+
+
+---
+
+Esta gema se concibió como una ayuda para la automatización de extracción de información de la página y servicios web que provee
+el [Banco de México](http://www.banxico.org.mx).
+
+
+Este proyecto no está patrocinado de ninguna forma por el gobierno mexicano. Es un esfuerzo para contribuir a la sanidad mental de los programadores que tenemos que lidiar con estas cosas :)
+
+
+## Installation / Instalación
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mx-banxico'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mx-banxico
+
+---
+
+Agrega esta línea al archivo Gemfile de tu aplicación:
+
+```ruby
+gem 'mx-banxico'
+```
+
+Luego ejecuta:
+
+    $ bundle
+
+O instálalo tu mismo usando:
+
+    $ gem install mx-banxico
+
+
+## Dependencies / Dependencias
+
+The only dependencies are:
+
+  * [Nokogiri](http://http://www.nokogiri.org/) for XML processing.
+  * [Savon](http://savonrb.com) for web services exploitation.
+  * [HTTParty](https://github.com/jnunemaker/httparty/tree/master/lib/httparty) for making a request to the Bank of Mexico's web site and download information.
+
+---
+
+Las únicas dependencias son:
+
+  * [Nokogiri](http://http://www.nokogiri.org/) que es una gema (y una joya) para procesar XML.
+  * [Savon](http://savonrb.com) para explotar los servicios web.
+  * [HTTParty](https://github.com/jnunemaker/httparty/tree/master/lib/httparty) para hacer una petición al sitio web y descargar
+    información de ahí.
+
+
+
+## Usage / Uso
+
+El Banco de México (también conocido como Banxico) maneja información de UDIS (Unidades de inversión), tipo de cambio, tasas de interés y reservas internacionales en uno de sus [servicios web] (http://www.banxico.org.mx/DgieWSWeb/DgieWS?WSDL). También, en su sitio web, tienen una [herramienta](http://www.banxico.org.mx/SieInternet/consultarDirectorioInternetAction.do?accion=consultarCuadro&idCuadro=CF102&sector=6&locale=es) para consultar la información histórica de diversos indicadores (o series como ellos les llaman).
+
+Ahora, la biblioteca (sí: _library -> biblioteca_, _bookstore -> librería_) está dividida en tres partes, cada una separada por un espacio de nombres (_namespace_) para poder distinguir los elementos con los que se está trabajando: {MX::Banxico}, {MX::Banxico::Historico} y {MX::Banxico::WebServices}.
+
+#### Ejemplos:
+
+* Para trabajar con el tipo de cambio histórico, se utiliza una instancia de {MX::Banxico::Historico::TipoDeCambio}.
+* Si deseas obtener el tipo de cambio al día de hoy, usa una instancia de {MX::Banxico::WebServices::TipoDeCambio}.
+
+
+En la clase {MX::Banxico::Series} encontrarás métodos para listar las series con las que trabaja la biblioteca. Básicamente es un contenedor de la información de las series (o indicadores) que tiene Banxico. La información ahí contenida se extrajo principalmente del servicio web, aunque la herramienta de consulta web del Banco también la maneja de la misma forma (se agradece consistencia).
+
+Tanto los servicios web como la página, devuelven XML. Para facilitar las cosas, todos los métodos de clases o instancias en {MX::Banxico::Historico::TipoDeCambio} o {MX::Banxico::WebServices::TipoDeCambio} devuelven arreglos de objetos (u objetos) del tipo {MX::Banxico::TipoDeCambio}. **¿Ves el patrón?** La idea es que si trabajarás con UDIS, uses {MX::Banxico::Historico::UDIS}, {MX::Banxico::WebServices::UDIS} y {MX::Banxico::UDIS}.
+
+Por el momento, sólo están las clases para trabajar con el tipo de cambio :'( pero siempre puedes contribuir a esta biblioteca y hacer a más gente feliz :)
+
+
+## Docs
+
+Check the [online documentation](http://http://www.rubydoc.info/gems/MX-Banxico/1.0) or generate it using YARD with:
+
+    $ bundle exec yard server --port 8828 --reload
+
+Also, check the [references](REFERENCIAS.md).
+
+---
+
+Consulta la [documentación en línea](http://http://www.rubydoc.info/gems/MX-Banxico/1.0) o genera la documentación con YARD: 
+
+    $ bundle exec yard server --port 8828 --reload
+
+También revisa las [referencias](REFERENCIAS.md).
+
+
+## Contributing / Contribuir
+
+1. Fork it ( https://github.com/Maquech/MX-Banxico/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Create your specs (100% coverage please!) and add code or make changes (TDD, right?)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request
+
+You can also submit technical observations on the algorithms here implemented alongside with references to official documentation that supports it.
+
+---
+
+Puedes contribuir mandándonos tus observaciones sobre la implementación de los algoritmos aquí implementados o referencias a documentos oficiales que las respalde.
+
+Ahora, diviérte con esta traducción (si sabes el término correcto en español, háznoslo saber por favor):
+
+1. Crea tu copia del repositorio ( https://github.com/Maquech/MX-Banxico/fork )
+2. Crea tu rama con la funcionalidad propuesta (`git checkout -b mi-nueva-funcionalidad-shubiduby`)
+3. Crea tus pruebas (specs que tengan una covertura del 100% porfa) y realiza cambios o agrega código (estás haciendo TDD, ¿cierto?)
+4. Compromete tus cambios (`git commit -am 'Nueva funcionalidad shubiduby'`)
+5. Empuja la rama a tu repositorio (`git push origin mi-nueva-funcionalidad-shubiduby`)
+6. Crea una nueva petición de jalada|tirada|extracción|acarreo
+
+
+

data/REFERENCIAS.md

@@ -0,0 +1,6 @@
+## Referencias oficiales
+
+### Oficiales
+
+* [Banco de México, Estadísticas](http://www.banxico.org.mx/estadisticas/index.html)
+* [Banco de México, web services](http://www.banxico.org.mx/DgieWSWeb/DgieWS?WSDL)

data/Rakefile

@@ -0,0 +1,26 @@
+begin
+  require "MX/Banxico/version"
+  require 'bundler/gem_tasks'
+  require 'rspec/core/rake_task'
+  require 'yard'
+  YARD::Rake::YardocTask.new
+  
+  RSpec::Core::RakeTask.new(:spec, :tag) do |t, task_args|
+    t.rspec_opts = ["--tag #{task_args[:tag]}", "--format", "--color"]
+  end
+  
+  task default: :spec
+  task test: :spec
+  
+
+  task :build do  
+    system "gem build MX-Banxico.gemspec"
+  end
+
+  task :release => :build do  
+    system "gem push mx-banxico-#{MX::Banxico::VERSION}"
+  end  
+  
+rescue LoadError
+end
+

data/lib/MX/Banxico.rb

@@ -0,0 +1,12 @@
+require 'httparty'
+require 'savon'
+require 'nokogiri'
+
+require "MX/Banxico/version"
+require "MX/Banxico/historico"
+require "MX/Banxico/web_services"
+require "MX/Banxico/series"
+require "MX/Banxico/tipo_de_cambio"
+require "MX/Banxico/historico/tipo_de_cambio"
+require "MX/Banxico/web_services/web_service"
+require "MX/Banxico/web_services/tipo_de_cambio"

data/lib/MX/Banxico/historico.rb

@@ -0,0 +1,4 @@
+# Módulo para recuperar series históricas.
+#
+module MX::Banxico::Historico
+end

data/lib/MX/Banxico/historico/tipo_de_cambio.rb

@@ -0,0 +1,296 @@
+# Clase para recuperar series históricas del tipo de cambio.
+#
+# La información se obtiene de la página de
+# {http://www.banxico.org.mx/SieInternet/consultarDirectorioInternetAction.do?accion=consultarSeries Banxico},
+# haciendo una petición POST que simula una consulta
+# realizada por un usuario desde un navegador web.
+#
+class MX::Banxico::Historico::TipoDeCambio
+  include HTTParty
+  
+  
+  # URL de la página del Banco de México (Banxico).
+  #
+  URL = "www.banxico.org.mx"
+  
+  
+  # Ruta para realizar la petición POST para obtener la información.
+  #
+  POST_PATH = "/SieInternet/consultarDirectorioInternetAction.do?accion=consultarSeries"
+  
+  
+  # Año inicial de la consulta (por omisión).
+  #
+  AÑO_INICIO_CONSULTA = 2015
+  
+  
+  # Año final de la consulta (por omisión).
+  #
+  AÑO_FINAL_CONSULTA = 2015
+  
+  
+  # Tipos de cambio soportados.
+  #
+  TIPOS_DE_CAMBIO = MX::Banxico::Series.tipos_de_cambio.keys.dup.freeze
+  
+  
+  # !@method base_uri
+  # URI base para la clase que incluye a {https://github.com/jnunemaker/httparty HTTParty}.
+  #
+  base_uri URL
+  
+  
+  # !@method open_timeout
+  # tiempo de espera para abrir la conexión para clase que incluye a {https://github.com/jnunemaker/httparty HTTParty}.
+  #
+  open_timeout 10
+  
+  
+  # !@method format
+  # formato esperado de la respuesta {https://github.com/jnunemaker/httparty HTTParty}.
+  #
+  format :xml
+  
+  
+  # !@attribute [r] errores.
+  #   @return [String] la descripción de los errores sucedidos al recuperar el histórico.
+  attr_reader :errores
+  
+  
+  # Inicializador de la instancia.
+  #
+  def initialize
+    @errores = nil
+  end
+  
+  # Indica si hay algún errror.
+  #
+  # @return [Boolean] `true` si hay errores, `false` de lo contrario.
+  #
+  def errores?
+    !@errores.nil?
+  end
+  
+  
+  # Recupera el histórico de una serie de tipo de cambio de acuerdo al identificador o nombre de la serie dada.
+  #
+  # @param serie [Symbol] el nombre de la serie de la que se desea recuperar el histórico.
+  # @param año_inicio_consulta [Integer] año de inicio de la consulta.
+  # @param año_termino_consulta [Integer] año de término de la consulta.
+  #
+  # @return [Array<MX::Banxico::TipoDeCambio>] si se recuperó la información, un arreglo con los tipos de cambio de la serie.
+  # @return [nil] si hubo un error al recuperar la información.
+  #
+  def de_serie(serie, año_inicio_consulta = nil, año_termino_consulta = nil)
+    begin
+      id_serie = MX::Banxico::Series.identificador(:tipos_de_cambio, serie)
+      opts = { id_serie: id_serie, serie: serie }
+      return peticion_post(body_hash(id_serie, año_inicio_consulta, año_termino_consulta), opts)
+    rescue ArgumentError => e
+      registrar_error(e.message)
+    end
+    nil
+  end
+  
+  
+  # Recupera todos los históricos de las series de tipo de cambio en {MX::Banxico::Series.tipos_de_cambio}.
+  #
+  # @param año_inicio_consulta [Integer] año de inicio de la consulta.
+  # @param año_termino_consulta [Integer] año de término de la consulta.
+  #
+  # @return [Array<MX::Banxico::TipoDeCambio>] si se recuperó la información, un arreglo con los tipos de cambio de la serie.
+  # @return [nil] si hubo un error al recuperar la información.
+  #
+  def completo(año_inicio_consulta = nil, año_termino_consulta = nil)
+    opts = { ids_series: MX::Banxico::Series.identificadores(:tipos_de_cambio) }
+    body_str = hash_a_query_string(body_hash(opts[:ids_series], año_inicio_consulta, año_termino_consulta))
+    return peticion_post(body_str, opts)
+  end
+  
+  
+  
+  private
+    
+    # Realiza la petición POST de acuerdo al cuerpo dado.
+    #
+    # @param body [Hash, String] el cuerpo de la petición. Usamos una cadena
+    #  cuando algún parámetro tiene como valor un arreglo, de lo contrario se usa un `Hash`.
+    # @param opts [Hash] información adicional para procesar la respuesta.
+    #
+    # @return [Array<MX::Banxico::TipoDeCambio>] si se recuperó la información, un arreglo con los tipos de cambio de la serie.
+    # @return [nil] si hubo un error al recuperar la información.
+    #
+    def peticion_post(body, opts = {})
+      respuesta = self.class.post(POST_PATH, headers: header_hash, body: body)
+      return procesar_respuesta(respuesta.body, opts) if respuesta.code == 200
+      registrar_error("código de error #{respuesta.code}.")
+      nil
+    end
+    
+    
+    # Procesa la respuesta de la petición, que es un `Hash` generado por {https://github.com/jnunemaker/httparty HTTParty}.
+    # 
+    # @param respuesta [String] la respuesta de la petición realizada.
+    # @param opts [Hash] información adicional para procesar la respuesta.
+    #
+    # @return [Array<MX::Banxico::TipoDeCambio>] si no hubo errores, un arreglo con los tipos de cambio encontrados en la respuesta.
+    # @return [nil] si hubo un error al recuperar la información.
+    #
+    def procesar_respuesta(respuesta, opts = {})
+      xml_doc = Nokogiri::XML(respuesta, nil, 'UTF-8')
+      if xml_doc.root.respond_to?(:xpath)
+        if opts[:id_serie] && opts[:serie]
+          return procesar_serie(xml_doc, opts[:id_serie], opts[:serie])
+        else
+          return procesar_series(xml_doc, opts[:ids_series])
+        end
+      else
+        registrar_error("La respuesta de la petición no tiene el formato correcto.")
+      end
+      nil
+    end
+    
+    
+    # Procesa el XML, buscando la serie del identificador dado.
+    # 
+    # @param xml_doc [Nokogiri::XML::Document] el XML con la respuesta de la petición realizada.
+    # @param id_serie [String] el identificador de la serie.
+    # @param serie [Symbol] el nombre de la serie.
+    #
+    # @return [Array<MX::Banxico::TipoDeCambio>] si no hubo errores, un arreglo con los tipos de cambio encontrados en la respuesta.
+    # @return [nil] si hubo un error al recuperar la información.
+    #
+    def procesar_serie(xml_doc, id_serie, serie)
+      historico = procesar_nodos_obs(xml_doc.root.xpath(%Q{bm:DataSet/bm:Series[@IDSERIE="#{id_serie}"]/bm:Obs}), serie)
+      return historico unless historico.empty?
+      registrar_error("No se encontró información de la serie #{serie} dentro de la respuesta de la petición.")
+      nil
+    end
+    
+    
+    # Procesa el XML de las series encontradas.
+    # 
+    # @param xml_doc [Nokogiri::XML::Document] el XML con la respuesta de la petición realizada.
+    #
+    # @return [Array<MX::Banxico::TipoDeCambio>] si no hubo errores, un arreglo con los tipos de cambio encontrados en la respuesta.
+    # @return [nil] si hubo un error al recuperar la información.
+    #
+    def procesar_series(xml_doc, ids_series)
+      historico = []
+      xml_doc.root.xpath("bm:DataSet/bm:Series").each do |serie|
+        if serie["IDSERIE"] && ids_series.include?(serie["IDSERIE"])
+          begin
+            nombre_serie = MX::Banxico::Series.nombre(serie["IDSERIE"], :tipos_de_cambio)
+            historico += procesar_nodos_obs(serie.xpath("bm:Obs"), nombre_serie)
+          rescue ArgumentError # no se encontró el nombre de la serie
+          rescue Nokogiri::XML::XPath::SyntaxError # no jaló el xpath
+          end
+        end
+      end
+      return historico.sort unless historico.empty?
+      registrar_error("No se encontraron series en la respuesta.")  
+      nil
+    end
+    
+    
+    # Procesa los nodos XML de la respuesta de la petición que contiene la información del tipo de cambio.
+    #
+    # @param nodos_obs [Nokogiri::XML::Nodes] nodos de la serie con el valor y fecha del tipo de cambio (bm:Obs).
+    # @param nombre_serie [Symbol] el nombre tipo de cambio solicitado. Ver {TIPOS_DE_CAMBIO}.
+    #
+    # @return [Array<MX::Banxico::TipoDeCambio>] los valores del tipo de cambio.
+    #
+    def procesar_nodos_obs(nodos_obs, nombre_serie)
+      historico = []
+      nodos_obs.each do |nodo_obs|
+        begin
+          tdc = MX::Banxico::TipoDeCambio.new(nombre_serie, nodo_obs[:TIME_PERIOD], nodo_obs[:OBS_VALUE])
+          historico << tdc
+        rescue ArgumentError
+        end
+      end
+      historico
+    end
+    
+    
+    # Registra el mensaje de error en {#errores}.
+    #
+    # @param error [String] el error que se agregará a {#errores}
+    # @param desc [String] descripción del error.
+    #
+    # @return [String] la nueva cadena de error.
+    #
+    def registrar_error(error, desc = nil)
+      err = "Error#{(desc.nil? or desc.empty?) ? "" : " (#{desc})"}: #{error}"
+      @errores = errores? ? "#{@errores} #{err}" : err
+    end
+    
+    
+    # Encabezado para la petición POST para recuperar el histórico de las series.
+    #
+    # @return [Hash] con los valores para el encabezado de la petición POST.
+    #
+    def header_hash
+      { "Content-Type" => "application/x-www-form-urlencoded" }
+    end
+    
+    
+    # Crea el cuerpo para la petición POST para recuperar el histórico de las series.
+    #
+    # @param serie [String, Array<String>] el identificador o arreglo de identificadores de la serie o series
+    #   de la que se desea recuperar el histórico.
+    # @param año_inicio_consulta [Integer] año de inicio de la consulta.
+    # @param año_termino_consulta [Integer] año de término de la consulta.
+    #
+    # @return [Hash] con los valores para el cuerpo de la petición POST.
+    #
+    def body_hash(serie, año_inicio_consulta = nil, año_termino_consulta = nil)
+      { # Información recuparada de la petición POST al descargar desde la página web
+        idCuadro: "CF102",
+        sector: "6",
+        version: "2",
+        locale: "es",
+        "formatoSDMX.x" => "41",
+        "formatoSDMX.y" => "8",
+        formatoHorizontal: false,
+        metadatosWeb: true,
+        tipoInformacion: nil,
+        # años de consulta
+        anoInicial: año_inicio_consulta || AÑO_INICIO_CONSULTA,
+        anoFinal: año_termino_consulta || AÑO_FINAL_CONSULTA,
+        # las series a descargar en la consulta
+        series: serie
+      }
+    end
+    
+    
+    # Convierte un `Hash` a una cadena de petición HTTP.
+    #
+    # @example Conversión del `Hash`
+    #   hsh = { un_param: "foo", otro_param: "bar", param_arreglo: ["a", "b"] }
+    #   hash_a_query_string(hsh) #=> "un_param=foo&otro_param=bar&param_arreglo=a&param_arreglo=b"
+    #
+    #
+    # @param hsh [Hash] el `Hash` a convertir a cadena.
+    #
+    # @return [String] la cadena de petición.
+    def hash_a_query_string(hsh)
+      pares = []
+      hsh.each_pair do |k,v|
+        v.is_a?(Array) ? v.each{ |val| pares << par_query_string(k, val) } : pares << par_query_string(k, v)
+      end
+      pares.join("&")
+    end
+    
+    
+    # Crea un par de llave y valor escapado para URIs.
+    #
+    # @param llave [String, Symbol] la llave del par.
+    # @param valor [String, Symbol] el valor del par.
+    #
+    # @return [String] el par escapado para URI.
+    #
+    def par_query_string(llave, valor)
+      "#{URI.escape llave.to_s}=#{URI.escape valor.to_s}"
+    end
+end