DHL eCommerce API Wrapper for Ruby

Installation

Installation is as simple at adding the following to your Gemfile.

gem "dhl-ecommerce"

Configuration

The only configuration necessary is your client_id and either a username and password or an access_token.

# DHL e-Commerce configuration.
DHL::Ecommerce.configure do |config|
  config.username = "meowbox"
  config.password = "password"
  config.client_id = 6369

  # Label format can be either :png or :zpl.
  config.label_format = :png
end

Usage

Accounts

# Find all accounts.
accounts = DHL::Ecommerce::Account.all

# Find a particular account.
account = DHL::Ecommerce::Account.find 6369

Locations

# Find all locations.
locations = DHL::Ecommerce::Location.all

# Find a particular location.
location = DHL::Ecommerce::Location.find 6369

It's also possible to obtain a list of locations from an account by calling the locations method.

Labels

# Create the consignee's address.
consignee_address = DHL::Ecommerce::StandardAddress.new firm: "meowbox Inc.",
                                                        address_1: "816 PEACE PORTAL DR",
                                                        address_2: "STE 103",
                                                        city: "BLAINE",
                                                        postal_code: "98230",
                                                        state: "WA",
                                                        country: "US"

# Create a single label.
label = DHL::Ecommerce::Label.create consignee_address: consignee_address,
                                     facility: :auburn,
                                     location_id: 6369,
                                     product_id: 83,
                                     weight: 1

The file method of any valid label object will return a StringIO object containing either the PNG or ZPL representation of the label depending on your configuration.

It's also possible to create multiple labels at once by passing an array of attributes to the create method.

# Create multiple labels.
labels = DHL::Ecommerce::Label.create [ label_attributes_1, label_attributes_2 ]

Manifests

Unlike other models, the create method will always return an array of Manifest objects – that's because the DHL e-Commerce API will return a manifest for each location and/or facility.

# Create manifests
manifests = DHL::Ecommerce::Manifest.create labels

Tracking

# Find events for a particular label.
events = DHL::Ecommerce::Label.find("420000000000000001").events

Other models

A few supporting models are also available.

• Event
• Imbp
• Product
• StandardAddress