Gem at RubyGems.org | Documentation

With this gem you can monitor Polish Post parcels and registered mail as well as packages shipped by Pocztex. It allows you to see basic data about the consignment as well as all the post offices it has gone through (including their locations and opening hours). The data is downloaded from a public SOAP API of the Polish Post and wrapped into Ruby classes for your convenience.


Add this line to your application's Gemfile:

gem 'poczta_polska'

And then execute:

$ bundle

Or install it yourself as:

$ gem install poczta_polska


require 'poczta_polska'

package_id = 'testp0'
# this package ID generates test data

tr = PocztaPolska::tracker

  pkg = tr.check(package_id)

  puts "A package was sent from #{pkg.office_from} to #{pkg.office_to}."

  pkg.events.each do |event|
    datetime = event.time.strftime("%F, %R")
    puts "Finally:" if event.final?
    puts "Time: #{datetime}"
    puts "Event: #{event.name}"
    puts "Post office: #{event.office}"

rescue PocztaPolska::UnknownPackageError
  puts "The package couldn't be found"
rescue PocztaPolska::WrongPackageError
  puts "The package ID is wrong"


  1. Fork it (https://github.com/hejmsdz/poczta_polska.rb/fork)
  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 a new Pull Request