polar_express 0.0.3.alpha → 0.0.4.alpha

data/lib/polar_express.rb

@@ -3,6 +3,7 @@ require "polar_express/polar_express"
 require "polar_express/tracker"
 require "polar_express/dhl"
 require "polar_express/gls"
+require "polar_express/hermes"
 require "polar_express/shipping_info"
 
 module PolarExpress
@@ -11,4 +12,6 @@ module PolarExpress
   require 'nokogiri'
   require 'date'
   require 'json'
-end
+  require 'net/http'
+  require "use_ssl_certs.rb"
+end

data/lib/polar_express/dhl.rb

@@ -1,3 +1,4 @@
+# encoding: utf-8
 module PolarExpress
   module DHL
     class Tracker
@@ -13,7 +14,7 @@ module PolarExpress
       end
       private
         def tracking_url
-          "http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=en&idc=#{@number}"
+          "http://nolp.dhl.de/nextt-online-public/set_identcodes.do?lang=de&idc=#{@number}"
         end
         def page
           @page ||= Nokogiri::HTML open tracking_url
@@ -23,42 +24,109 @@ module PolarExpress
         end
         def timeline
           page.css("tr#toggle-#{@number}_1 table tbody tr").map do |tr|
+            if tr.css('.retoure_left').length > 0 then
+              status_text = tr.css('td.retoure_right div').last.text.strip
+            else
+              status_text = tr.css('td.status').text.strip
+            end
             {
               date: DateTime.parse(get_date(tr.css('td.overflow').text)),
               city: (city = tr.css('td.location').text.strip) == '--' ? nil : city,
-              status: text_to_status(status_text = tr.css('td.status').text.strip),
+              status: text_to_status(status_text),
               text: status_text
             }
           end
         end
-        # TODO: look for better status names
         def text_to_status(text)
-          case text
-          when /The recipient has picked up the shipment from/
-            :delivered
-          when /The shipment has been successfully delivered/
-            :delivered
-          when /The shipment is on its way to the postal retail outlet/
-            :in_delivery_vehicle_to_retail_outler
-          when /The shipment has been delivered for pick-up at the/
-            :waiting_for_pick_up_in_retail_office
-          when /The shipment has been loaded onto the delivery vehicle/
-            :in_delivery_vehicle
-          when /The shipment has been processed in the destination parcel center/
-            :destination_parcel_center
-          when /The shipment has been processed in the parcel center of origin/
-            :origin_parcel_center
-          when /The instruction data for this shipment have been provided by the sender to DHL electronically/
-            :shipping_instructions_received
-          when /A .+ attempt at delivery is being made/
-            :new_delivery_attempt
-          else
-            :other
+          match = Statuses.find do |status, regexes|
+            regexes.find { |regex| text =~ regex }
           end
+          (match && match.first) || :other
         end
         def get_date(str)
           str.scan(/[\d]{1,2}\.[\d]{1,2}\.[\d]{4} [\d]{1,2}:[\d]{1,2}/).flatten.first
         end
     end
+    Statuses = {
+      :delivery_failed => [
+        /Aufgrund eines Adressfehlers konnte die Sendung nicht zugestellt werden/,
+        /Aus unvorhersehbaren Gründen konnte die Sendung nicht zugestellt werden/,
+        /Der Empfänger wurde nicht angetroffen. Die Sendung konnte nicht zugestellt werden und wird gelagert. Der Empfänger wurde benachrichtigt/,
+        /Die Sendung konnte heute nicht zugestellt werden/,
+        /Die Sendung konnte nicht zugestellt werden, der Empfänger wurde benachrichtigt/,
+        /Empfangsadresse bei Zustellversuch geschlossen/,
+        /Erfolgloser Zustellversuch, Empfänger nicht zu Hause/,
+        /Zustellung in Packstation nicht möglich/,
+      ],
+      :delivery_succeeded => [
+        /Der Empfänger hat die Sendung aus der PACKSTATION abgeholt/,
+        /Der Empfänger hat die Sendung in der Filiale abgeholt/,
+        /Die Sendung wurde abgeholt/,
+        /Die Sendung wurde dem Empfänger per vereinfachter Firmenzustellung ab Zustellbasis zugestellt/,
+        /Die Sendung wurde erfolgreich zugestellt/,
+        /Die Überweisung des Nachnahme-Betrags an den Zahlungsempfänger ist erfolgt/,
+      ],
+      :destination_parcel_center => [
+        /Die Sendung wurde im Ziel-Paketzentrum bearbeitet/,
+        /Die Sendung wurde innerhalb des Ziel-Paketzentrums weitergeleitet/,
+      ],
+      :in_delivery_vehicle => [
+        /Die Sendung befindet sich auf dem Weg zur PACKSTATION/,
+        /Die Sendung wird zur Abholung in die Filiale (.+) gebracht/,
+        /Die Sendung wurde in das Zustellfahrzeug geladen/,
+        /in Auslieferung durch Kurier/,
+      ],
+      :in_shipment => [
+        /Die Auslandssendung wurde im Export-Paketzentrum bearbeitet/,
+        /Die Sendung aus dem Ausland ist im Import-Paketzentrum eingetroffen/,
+        /Die Sendung hat das Import-Paketzentrum im Zielland verlassen/,
+        /Die Sendung ist im Zielland eingetroffen/,
+        /Die Sendung wird ins Zielland transportiert und dort an die Zustellorganisation (.+) übergeben/,
+        /Die Sendung wird ins Zielland transportiert und dort an die Zustellorganisation übergeben/,
+        /Die Sendung wird ins Zielland transportiert/,
+        /Die Sendung wird zur Verzollung im Zielland vorbereitet/,
+        /Die Sendung wurde dem Empfänger per vereinfachter Firmenzustellung ab Paketzentrum zugestellt/,
+        /Die Sendung wurde vom Absender in der Filiale eingeliefert/,
+        /Geplant für Zustellung/,
+        /Sendung hat den Abholstandort verlassen/,
+        /Sendung hat die Umschlagbasis verlassen/,
+        /Sendung ist im Zustellstandort eingegangen/,
+        /Sendung ist in den Abholstandort eingegangen/,
+        /Sendung ist in der Umschlagbasis eingegangen/,
+        /Sendung wurde weiter bearbeitet/,
+        /Verzollung abgeschlossen/,
+      ],
+      :new_delivery_attempt => [
+        /Es erfolgt ein 2. Zustellversuch/,
+      ],
+      :on_hold => [
+        /Die für die Auslieferung der Sendung erforderlichen Daten liegen nicht vor. Die Sendung wird zurückgestellt/,
+        /Die Sendung wird vorübergehend bis zur Zustellung in der Zustellbasis gelagert/,
+        /Die Sendung wurde beschädigt und wird zur Nachverpackung in das Paketzentrum zurückgesandt/,
+        /Die Sendung wurde fehlgeleitet und konnte nicht zugestellt werden. Die Sendung wird umadressiert und an den Empfänger weitergeleitet/,
+        /Die Sendung wurde zurückgestellt. Die Zustellung erfolgt voraussichtlich am nächsten Werktag/,
+        /Nicht durch DHL beeinflussbare Verzögerung in der Verzollung/,
+      ],
+      :on_hold_at_depot => [
+        /Sendung nach Zustellversuch zurück in DHL Station/,
+        /Sendung zur Aufbewahrung in der Station/,
+      ],
+      :origin_parcel_center => [
+        /Die Auslands-Sendung wurde im Start-Paketzentrum bearbeitet/,
+        /Die Sendung wurde im Paketzentrum bearbeitet/,
+        /Die Sendung wurde im Start-Paketzentrum bearbeitet/,
+      ],
+      :return_shipment => [
+        /Die Sendung wurde nicht abgeholt und wird zurückgesandt/,
+        /Rücksendung eingeleitet/,
+      ],
+      :shipping_instructions_received => [
+        /Die Auftragsdaten zu dieser Sendung wurden vom Absender elektronisch an DHL übermittelt/,
+      ],
+      :waiting_for_pickup_by_customer => [
+        /Die Sendung liegt in der Filiale zur Abholung bereit/,
+        /Die Sendung liegt in der PACKSTATION zur Abholung bereit/,
+      ],
+    }.freeze
   end
 end

data/lib/polar_express/gls.rb

@@ -1,3 +1,4 @@
+# encoding: utf-8
 module PolarExpress
   module GLS
     class Tracker
@@ -12,7 +13,7 @@ module PolarExpress
       end
       private
         def tracking_url
-          "https://gls-group.eu/app/service/open/rest/EU/en/rstt001?match=#{@number}&caller=witt002Scheme"
+          "https://gls-group.eu/app/service/open/rest/EU/de/rstt001?match=#{@number}&caller=witt002Scheme"
         end
         def page
           @page ||= JSON.parse(open(tracking_url).read)
@@ -29,33 +30,98 @@ module PolarExpress
         def timeline
           history.each_with_index.map do |event, index|
             # GLS specific logic
-            next if event[:text] == 'Inbound to GLS location to document physical hand over'
-            if event[:text] == 'Inbound to GLS location' and history[index-1][:text] == 'Outbound from GLS location'
-              event[:text] = 'The shipment has been processed in the destination parcel center'
-            end
+            #next if event[:text] == 'Inbound to GLS location to document physical hand over'
             event[:status] = text_to_status(event[:text])
             event
           end.compact
         end
-        # TODO: look for better status names
         def text_to_status(text)
-          case text
-          when /Delivered/
-            :delivered
-          when /Out for delivery on GLS vehicle/
-            :in_delivery_vehicle
-          when /The shipment has been processed in the destination parcel center/
-            :destination_parcel_center
-          when /Inbound to GLS location/
-            :origin_parcel_center
-          when /Outbound from GLS location/
-            :in_shipment
-          when /Information transmitted, no shipment available now/
-            :shipping_instructions_received
-          else
-            :other
+          match = Statuses.find do |status, regexes|
+            regexes.find { |regex| text =~ regex }
           end
+          (match && match.first) || :other
         end
     end
+    Statuses = {
+      :at_distribution_hub => [
+        /Ankunft im GLS Depot/,
+        /Ankunft im GLS Depot \(Ausland\)/,
+        /Ankunft im GLS Depot \(Großkunde\)/,
+        /Ankunft im GLS Depot \(HUB\)/,
+        /Ankunft im GLS Depot \(Regionalumschlag\)/,
+        /Ankunft im GLS Depot Business-Small Parcel Sortierung/,
+        /Ankunft im GLS Depot Grosskunden Checker/,
+        /Ankunft im GLS Depot Label nicht lesbar/,
+        /Ankunft im GLS Depot manuelle Sortierung/,
+        /Inbound to GLS location manually sorted/,
+        /Inbound to GLS location sorted as Business-Small Parcel/,
+      ],
+      :cancelled => [
+        /Daten aus dem GLS-System gelöscht/,
+        /Daten aus dem GLS-System gelöscht Betrifft Benachrichtigungskarte/,
+      ],
+      :delivery_failed => [
+        /Empfänger ist im Urlaub/,
+        /Nachnahme-Sendung nicht zugestellt/,
+        /Nicht zugestellt aufgrund falscher Adresse/,
+        /Nicht zugestellt da keine Annahme an diesem Tag/,
+        /Nicht zugestellt da Kunde nicht angetroffen/,
+        /Nicht zugestellt wegen Warenannahmeschluss/,
+      ],
+      :delivery_succeeded	 => [
+        /Zugestellt/,
+      ],
+      :destination_parcel_center => [
+        /Ankunft im GLS Depot \(Ziel\)/,
+      ],
+      :in_delivery_vehicle => [
+        /In Zustellung auf GLS-Fahrzeug/,
+      ],
+      :in_shipment	 => [
+        /Abfahrt vom GLS Depot/,
+        /Auslandspaket/,
+        /Paketabholung/,
+        /Pickup-Service Abholung erfolgt/,
+        /Pickup-Service Abholung erfolgt \(direkt\)/,
+        /Weitergeleitet Umverfuegt/,
+      ],
+      :notification_card => [
+        /Empfänger kontaktiert Betrifft Benachrichtigungskarte/,
+      ],
+      :on_hold => [
+        /Fehlleitung auf Zustellfahrzeug/,
+        /Fehlleitung im GLS-System/,
+        /Fehlsortierung/,
+        /Paket in Klärung/,
+      ],
+      :on_hold_at_depot => [
+        /Aufbewahrung im GLS Depot da keine Annahme an diesem Tag/,
+        /Aufbewahrung im GLS Depot da Kunde nicht angetroffen/,
+        /Eingelagert/,
+        /Eingelagert \(Platzmangel\)/,
+        /Lieferung unvollständig/,
+        /Nicht in Zustellung Neuer Zustelltermin vereinbart/,
+      ],
+      :return_shipment => [
+        /Annahme verweigert/,
+        /Annahme verweigert, weil Paket beschädigt/,
+        /Aufbewahrung im GLS Depot Lagerfrist im Paket Shop überschritten/,
+        /Nicht zugestellt Lagerfrist im Paket Shop überschritten/,
+        /Retoure: Paket ohne Inhalt/,
+        /Retoure: Paket schlecht verpackt/,
+        /Zum Versender retourniert/,
+      ],
+      :shipping_instructions_received => [
+        /Ankunft im GLS Depot der avisierten Sendungsdaten/,
+        /Daten übertragen, Paket noch nicht erhalten/
+      ],
+      :waiting_for_pickup_by_customer => [
+        /Nicht in Zustellung da Selbstabholung/,
+        /Zugestellt im GLS Paket Shop/,
+      ],
+      :new_delivery_attempt => [
+        /Keine Zustellung aus Zeitmangel/,
+      ],
+    }.freeze
   end
 end

data/lib/polar_express/hermes.rb

@@ -0,0 +1,99 @@
+# encoding: utf-8
+module PolarExpress
+  module Hermes  
+    class Tracker
+      attr_accessor :number
+      def initialize(number)
+        @number = number
+      end
+      def track!
+        info = ShippingInfo.new(@number)
+        info.statuses = timeline
+        info
+      end
+      private
+        def tracking_form_uri
+          html = Nokogiri::HTML open 'https://www.myhermes.de/wps/portal/paket/Home/privatkunden/sendungsverfolgung/'
+          URI('https://www.myhermes.de' + html.css('form#shipmentTracingDTO').first['action'])
+        end
+        def post_tracking_page
+          res = Net::HTTP.post_form(tracking_form_uri, 'shipmentID' => @number)
+          res.body
+        end
+        def page
+          @page ||= Nokogiri::HTML post_tracking_page
+        end
+        # TODO: implement cities
+        def timeline
+          page.css("table.table_shipmentDetails tbody tr").map do |tr|
+            tds = tr.css('td')
+            status_text = tds.last.text.strip
+            {
+              date: DateTime.parse(tds[0].text + " " + tds[1].text),
+              city: nil,
+              status: text_to_status(status_text),
+              text: status_text
+            }
+          end.reverse
+        end
+        def text_to_status(text)
+          match = Statuses.find do |status, regexes|
+            regexes.find { |regex| text =~ regex }
+          end
+          (match && match.first) || :other
+        end
+    end
+    
+    Statuses = {
+      :at_distribution_hub => [
+        /Die Sendung wurde im Hermes (.+) sortiert/,
+      ],
+      :delivery_failed => [
+        /Bitte seien Sie uns bei der Adressklärung behilflich/,
+        /Der zu kassierende Betrag EUR (.+) lag beim Zustellversuch nicht vor/,
+        /Die angegebene Anschrift konnte nicht gefunden werden/,
+        /Die Annahme der Sendung wurde verweigert/,
+      ],
+      :delivery_succeeded => [
+        /Die Sendung wurde zugestellt/,
+      ],
+      :destination_parcel_center => [
+          /Die Sendung (wurde von|ist in) der Hermes Niederlassung (.+) (übernommen|eingetroffen)/,
+      ],
+      :in_delivery_vehicle => [
+        /Die Sendung befindet sich in der Zustellung/,
+        /Die Sendung ist auf Tour gegangen/,
+      ],
+      :in_shipment => [
+        /Die Sendung befindet sich auf dem Weg in die zuständige Hermes Niederlassung/,
+        /Die Sendung hat das Lager des Versenders verlassen/,
+        /Die Sendung wurde abgeholt/,
+      ],
+      :new_delivery_attempt => [
+        /Der Empfänger wurde nicht angetroffen/,
+        /Wir werden einen weiteren Zustellversuch durchführen/,
+        /Der Empfänger wurde zum (1|2). Mal nicht angetroffen. Wir werden einen weiteren Zustellversuch durchführen/,
+      ],
+      :on_hold_at_depot => [
+        /Die Sendung wird in der Hermes Niederlassung (.+) aufbewahrt/,
+      ],
+      :return_pickup_from_customer => [
+        /Der Abholauftrag ist in der Hermes Niederlassung eingegangen/,
+        /Der Abholauftrag wurde an die Hermes Logistik Gruppe übermittelt/,
+        /Die Abholung wird durchgeführt/,
+      ],
+      :return_shipment => [
+        /Die Sendung wird an den Versender zurückgeführt/,
+        /Die Sendung wurde im Hermes PaketShop abgeholt und für den weiteren Transport sortiert/,
+      ],
+      :shipping_instructions_received => [
+        /Die Sendungsdaten wurden an die Hermes Logistik Gruppe übermittelt/,
+      ],
+      :waiting_for_pickup_by_customer => [
+        /Der Empfänger wurde zum 3. Mal nicht angetroffen/,
+        /Die Sendung ist im Hermes PaketShop eingegangen/,
+        /Die Sendung liegt im Hermes PaketShop zur Abholung bereit/,
+      ]
+    }.freeze
+  end
+end

data/lib/polar_express/polar_express.rb

@@ -4,4 +4,17 @@ module PolarExpress
   def self.new(*args)
     Tracker.new(*args)
   end
+  
+  # returns a courier's symbol given it's name.
+  # ideally it should be much smarter, supporting company's name, etc.
+  def self.identify_courier(name)
+    case name.upcase
+    when /DHL/
+      :DHL
+    when /GLS/
+      :GLS
+    when /HERMES/
+      :Hermes
+    end
+  end
 end

data/lib/polar_express/tracker.rb

@@ -2,24 +2,12 @@ module PolarExpress
   class Tracker
     attr_reader :courier, :shipping_number
     def initialize(courier, shipping_number)
-      @courier         = identify_courier(courier)
+      @courier         = PolarExpress::identify_courier(courier)
       @shipping_number = shipping_number
       @courier_tracker = Object.const_get("PolarExpress::#{@courier}::Tracker").new(@shipping_number)
     end
     def track!
       @track ||= @courier_tracker.track!
     end
-    
-    private
-      # returns a courier's symbol given it's name.
-      # ideally it should be much smarter, supporting company's name, etc.
-      def identify_courier(name)
-        case name.upcase
-        when 'DHL'
-          :DHL
-        when 'GLS'
-          :GLS
-        end
-      end
   end
 end

data/lib/polar_express/version.rb

@@ -1,3 +1,3 @@
 module PolarExpress
-  VERSION = "0.0.3.alpha"
+  VERSION = "0.0.4.alpha"
 end

data/lib/use_ssl_certs.rb

@@ -0,0 +1,13 @@
+require 'net/https'
+
+# gotten from: https://github.com/stevegraham/certified/blob/master/certified.rb
+
+Net::HTTP.class_eval do
+  alias _use_ssl= use_ssl=
+
+  def use_ssl= boolean
+    self.ca_file     = "#{File.dirname(__FILE__)}/certs/cacert.pem"
+    self.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    self._use_ssl    = boolean
+  end
+end