Use the carrier-agnostic IShipmentService or the carrier-specific client:
var shippingService = serviceProvider.GetRequiredService<IShipmentService>();
var request = new DhlShipmentRequest
{
BillingNumber = "33333333330101",
Product = DhlProduct.V01PAK,
Shipper = new Address
{
Name = "Max Mustermann",
Street = "Musterstraße",
HouseNumber = "1",
PostalCode = "53113",
City = "Bonn",
CountryCode = "DEU"
},
Consignee = new Address
{
Name = "Erika Musterfrau",
Street = "Berliner Straße",
HouseNumber = "42",
PostalCode = "10117",
City = "Berlin",
CountryCode = "DEU"
},
Packages = [new Package { Weight = 2.5 }]
};
var response = await shippingService.CreateShipmentAsync(request);
Console.WriteLine($"Shipment: {response.ShipmentNumber}");
4. Track a shipment
var trackingService = serviceProvider.GetRequiredService<ITrackingService>();
var result = await trackingService.TrackAsync("00340434161094042557");
Console.WriteLine($"Status: {result.Status}");
foreach (var evt in result.Events)
{
Console.WriteLine($" {evt.Timestamp}: {evt.Description} ({evt.Location})");
}
DHL Services
Shipping
IDhlShippingClient extends the carrier-agnostic IShipmentService with DHL-specific operations:
var dhlClient = serviceProvider.GetRequiredService<IDhlShippingClient>();
// Validate before creating
var validation = await dhlClient.ValidateShipmentAsync(request);
if (validation.Valid)
{
var response = await dhlClient.CreateShipmentAsync(request);
}
// Create daily closing manifest
var manifest = await dhlClient.CreateManifestAsync();
Tracking
Two tracking clients are available:
Client
API
Format
Sandbox
IDhlTrackingClient
Parcel DE Tracking v0
XML
Yes
IDhlUnifiedTrackingClient
Unified Tracking
JSON
No
// Parcel DE Tracking with signature retrieval
var trackingClient = serviceProvider.GetRequiredService<IDhlTrackingClient>();
var result = await trackingClient.TrackAsync("00340434161094042557");
var signature = await trackingClient.GetSignatureAsync("00340434161094042557");
// Unified Tracking (JSON)
var unifiedClient = serviceProvider.GetRequiredService<IDhlUnifiedTrackingClient>();
var result = await unifiedClient.TrackAsync("00340434161094042557");
Pickup
var pickupClient = serviceProvider.GetRequiredService<IDhlPickupClient>();
var order = await pickupClient.CreatePickupOrderAsync(new PickupOrderRequest { /* ... */ });
var details = await pickupClient.GetPickupOrderAsync(order.OrderNumber);
await pickupClient.CancelPickupOrderAsync(order.OrderNumber);
Returns
var returnsClient = serviceProvider.GetRequiredService<IDhlReturnsClient>();
var returnOrder = await returnsClient.CreateReturnOrderAsync(new ReturnOrderRequest { /* ... */ });
var locations = await returnsClient.GetReturnLocationsAsync("DEU");
Internetmarke
var internetmarkeClient = serviceProvider.GetRequiredService<IDhlInternetmarkeClient>();
var userInfo = await internetmarkeClient.GetUserInfoAsync();
var catalog = await internetmarkeClient.GetCatalogAsync();
var balance = await internetmarkeClient.GetWalletBalanceAsync();
var cart = await internetmarkeClient.InitializeCartAsync(new CartRequest { /* ... */ });
var checkout = await internetmarkeClient.CheckoutCartAsync(cart.CartId);
Location Finder
var locationFinder = serviceProvider.GetRequiredService<IDhlLocationFinderClient>();
var byAddress = await locationFinder.FindByAddressAsync("DEU", "Bonn", "53113");
var byGeo = await locationFinder.FindByGeoAsync(50.7374, 7.0982, 5000);
var location = await locationFinder.GetLocationByIdAsync("8003-4012221");
GO! Express Services
Shipping
var goClient = serviceProvider.GetRequiredService<IGoExpressShippingClient>();
var response = await goClient.CreateShipmentAsync(request);
var label = await goClient.GenerateLabelAsync(response.ShipmentNumber, GoExpressLabelFormat.Pdf);
await goClient.CancelShipmentAsync(response.ShipmentNumber);
Tracking
var trackingService = serviceProvider.GetRequiredService<ITrackingService>();
var result = await trackingService.TrackAsync("GO123456789");
