ShippingConnector is an abstraction library that makes connecting to various shipping carriers' APIs easier. As with everything Ruby, the goal is to make writing code that handles shipping logic fast and comfortable


Add the following line to your Gemfile

gem 'shipping_connector'


Create a carrier object:

carrier = customer_id: 'customerId', password: 'password'

Find nearest service points to a given address

service_points = carrier.service_points :list, zip_code: '7100', address: 'Niels Finsensvej 11'
# "1234"
# "Mediabox"
# "Bilka Vejle 20"
# "08:00 - 22:00"

Find service point from id:

service_point = carrier.service_points 1234
# "1234"


Supported carriers

Supported features

The gem is currently very limited in features as focus lied in preparing the endpoints that was required for my work, namely the search for service points for the listed carriers. The plan is to steadily add more endpoints and expand the functionality to cover the most used features for several carriers while keeping the simplicity intact.


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Feel free to add a new carrier based on the current work at any time.

Please make sure to update tests as appropriate.