pratka 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '04085d85f88834e2907d322efdcf9ab8ccf3588514a5d362c19223f4cd22a790'
-  data.tar.gz: ff5582b3d13b92cad8e7fc36de4abd1f44462c67a58ea62031b66628aafedc04
+  metadata.gz: 5b7fcba8830d7b2a64d6eface4623a15a44f88891a3642ef144fcef3df7af4e9
+  data.tar.gz: 141e3f04d803fd70e8e1173334b10ce88e1908d8f9c1d711bbd27e02de265547
 SHA512:
-  metadata.gz: 47c29ce1d7858648f126d8f498c65232f7481e389049b469015dde5aa411a5cd83163dec1117426b97793cbb8fd5d7a146555e5617425c730e6ba52c30c05036
-  data.tar.gz: ee5af3f162ba6c5f5a6a893e096e4bfb41bef64a72f30f43ae305ffd152daa2f21a883317dff79b7b03186f117e2c49e728fae76a730fc5bcb745a83d20343ee
+  metadata.gz: 90e43c700109947503183ab11b2d8601be0ddeb69c1d9736ae71124e56a2546f8a08ebe43a18647add64412ab39e45b2a6379091af8e2383763ef604457bbe37
+  data.tar.gz: be018a707f9cc0fe0d7dd665b7dfbe672557ffc9f83cac1a1b46aa53cf741f8428f8024bc8cf2706c4514a476b7b1d99ec9c707dd2d09bce00f6a5eaf08ab809

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.1.1] - 2026-10-08
+
+### Added
+
+- `fetch_shipment_info` returns full details of existing shipments
+
+[0.1.1]: https://github.com/tripplesteel/pratka/releases/tag/v0.1.1
+
 ## [0.1.0] - 2026-10-07
 
 Initial release, with Speedy as the first supported courier.
@@ -18,5 +26,4 @@ Initial release, with Speedy as the first supported courier.
 - Validation of required params, which treats blank values as missing
 - Supports Ruby 3.3+ and JRuby
 
-[Unreleased]: https://github.com/tripplesteel/pratka/compare/v0.1.0...HEAD
 [0.1.0]: https://github.com/tripplesteel/pratka/releases/tag/v0.1.0

data/README.md

@@ -345,6 +345,30 @@ Example response:
 }
 ```
 
+#### Fetch shipment info
+
+```ruby
+client.fetch_shipment_info(shipment_ids: ["299999990", "299999991"])
+```
+
+Allowed options:
+- `shipment_ids` (Mandatory) - Array of shipment ids
+
+Returns the parsed JSON response with one [Shipment](https://api.speedy.bg/api/docs/#href-ds-shipment) per id. Each shipment has its sender, recipient, service, content, payment, price and delivery details, plus `ref1`, `ref2`, `returnShipmentId` and `redirectShipmentId` when set
+
+Example response:
+
+```ruby
+{"shipments" =>
+  [{"id" => "299999990",
+    "ref1" => "ORDER-1001",
+    "service" => {"serviceId" => 505, "pickupDate" => "2026-10-08"},
+    "content" => {"parcelsCount" => 1, "totalWeight" => 1.5, "contents" => "Books"},
+    "price" => {"amount" => 6.2, "vat" => 1.24, "total" => 7.44, "currency" => "BGN"},
+    "delivery" => {"deliveryDeadline" => "2026-10-09T19:00:00+0300"}}]
+}
+```
+
 #### Calculate
 
 ```ruby
@@ -403,7 +427,7 @@ Returns the parsed JSON response with one tracked parcel per matched parcel. A `
 
 A parcel Speedy can't find comes back with its own `error` object instead of operations. `track` doesn't raise for it, so check each parcel
 
-Speedy asks clients to send at most 10 parcels per request and plans to enforce that limit. `track` enforces it already, so if you send more than 10 parcels it raises `ArgumentError` with the message `Speedy tracks at most 10 parcels per call`. Split larger lists into batches, for example with `each_slice(10)`
+Speedy enforces 10 parcels limit per request. If you send more than 10 parcels it raises `ArgumentError` with the message `Speedy tracks at most 10 parcels per call`. Split larger lists into batches, for example with `each_slice(10)`
 
 Example response:
 

data/lib/pratka/speedy/client.rb

@@ -61,11 +61,13 @@ module Pratka
         payment: :payment
       }.freeze
 
+      SHIPMENT_INFO_ENDPOINT = "shipment/info"
+      SHIPMENT_INFO_PARAMS = { shipment_ids: :shipmentIds }.freeze
+
       TRACK_ENDPOINT = "track"
       TRACK_PARAMS = { parcels: :parcels, last_operation_only: :lastOperationOnly }.freeze
 
-      # Speedy recommends 10 parcels per request and plans to enforce it
-
+      # Speedy allows up to 10 parcels per request
       TRACK_MAX_PARCELS = 10
 
       def initialize(username:, password:, language: nil, country_id: Speedy.configuration.country_id)
@@ -159,6 +161,15 @@ module Pratka
         call(CREATE_SHIPMENT_ENDPOINT, map_params(options, SHIPMENT_PARAMS, required: %i[recipient service content payment]))
       end
 
+      # Fetch full details of existing shipments
+      # [Shipment Information Request (ShipmentInformationRequest)](https://api.speedy.bg/api/docs/#href-shipment-info-req)
+      # Allowed params:
+      # shipment_ids (Mandatory) - String[] - Shipment ids
+      # Returns one Shipment per id with its sender, recipient, service, content, payment, price and delivery
+      def fetch_shipment_info(**options)
+        call(SHIPMENT_INFO_ENDPOINT, map_params(options, SHIPMENT_INFO_PARAMS, required: [:shipment_ids]))
+      end
+
       # Calculate shipment price and delivery deadline for one or more services
       # [Calculation Request (CalculationRequest)](https://api.speedy.bg/api/docs/#href-calculation-req)
       # Allowed params:

data/lib/pratka/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pratka
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pratka
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Stilqn Bairski