Shipping Addresses

Overview

The Shipping Addresses endpoint allows you to retrieve the delivery addresses associated with your orders. This is particularly useful when you need to build shipping labels or validate delivery destinations outside the standard order unit flow.

The endpoint supports two distinct lookup strategies, selected automatically based on the query parameters you provide:

  • By Order IDs — pass order_ids to retrieve the shipping address for each specified order.
  • By Order Unit IDs — pass order_unit_ids to retrieve the shipping address for each specified order unit.

Retrieving Shipping Addresses

When retrieving addresses, please consider the Cancellation prior to shipment as addresses for affected units will not be retrieved.

Lookup by Order IDs

To retrieve the shipping address for one or more specific orders, pass a comma-separated list of order_ids:

GET https://sellerapi.kaufland.com/v2/shipping-addresses?order_ids=MB7UWLD,MXANBSH

Each entry in the response will include the id_order it belongs to, as well as the id_order_unit of each given unit in the order, so you can correlate results with your orders: 

{
	"data": [
		{
			"id_order_unit": 314567828995811,
			"id_order": "MB7UWLD",
			"address_data": {
				"type": "SHIPPING_ADDRESS_HOME",
				"data": {
					"first_name": "Max",
					"last_name": "Mustermann",
					"street": "Bonnerstraße",
					"house_number": "73",
					"postcode": "53117",
					"city": "Bonn",
					"country": "DE"
					"phone": "+4922890010",
					"additional_field": "1. OG"
				}
			}
		},
		{
			"id_order_unit": 314567828995812,
			"id_order": "MXANBSH",
			"address_data": {
				"type": "SHIPPING_ADDRESS_DPD_PUDO",
				"data": {
					"first_name": "Jane",
					"last_name": "Doe",
					"postcode": "04103",
					"city": "Leipzig",
					"country": "DE",
					"additional_field": null,
					"dpd_pudo_id": "DE37860",
					"dpd_parcel_shop_id": "428256"
				}
			}
		}
	]
}

Lookup by Order Unit IDs

To retrieve the shipping address for one or more specific order units, pass a comma-separated list of order_unit_ids:

GET https://sellerapi.kaufland.com/v2/shipping-addresses?order_unit_ids=314567828995811,314567828995812

Each entry in the response will include the id_order_unit and id_order it belongs to: 

{
	"data": [
		{
			"id_order_unit": 314567828995811,
			"id_order": "MB7UWLD",
			"address_data": {
				"type": "SHIPPING_ADDRESS_DHL_PUDO",
				"data": {
					"first_name": "Anna",
					"last_name": "Schmidt",
					"street": "Aachener Str",
					"house_number": "2",
					"postcode": "50674",
					"city": "Koeln",
					"country": "DE",
					"additional_field": null,
					"pickup_location_id": "724",
					"dhl_post_number": "28071990"
				}
			}
		}
	]
}

Address Types

Every shipping address contains an addressData object with a type field that identifies the kind of delivery destination. Understanding this field is important for building correct shipping labels.

Type Description
SHIPPING_ADDRESS_HOME A standard home or business address. The data object contains the full postal address.
SHIPPING_ADDRESS_GENERIC_PUDO A generic pick-up / drop-off location not associated with a specific carrier. Includes pickup_location_id for identifying the pick-up point.
SHIPPING_ADDRESS_DPD_PUDO A DPD Parcel Shop address. In addition to the standard fields, the data object contains dpd_pudo_id and dpd_parcel_shop_id which are required when creating DPD labels.
SHIPPING_ADDRESS_DHL_PUDO A DHL Packstation address. The data object contains pickup_location_id (the Packstation number) and dhl_post_number (Postnummer) required by DHL for Packstation deliveries.
SHIPPING_ADDRESS_PACKETA_PUDO A Packeta pick-up point. Contains pickup_location_id and pickup_location_name. The house_number and company_name fields are intentionally blank for this type.

Response Fields

Top-level fields

  • id_order: String
    The order ID.
  • id_order_unit: Integer
    The order unit ID.
  • address_data: Object
    Container for the address type and its data. Always present.
  • address_data.type: String
    One of the address type values listed in the Address Types table above.
  • address_data.data: Object
    The address payload. Fields vary depending on the address type (see below).

Address data fields (all types)

  • first_name: String — Recipient's first name.
  • last_name: String — Recipient's last name.
  • company_name: String — Company name, if applicable.
  • street: String — Street name.
  • house_number: String — House number.
  • postcode: String — Postal code.
  • city: String — City name.
  • country: String — ISO 3166-1 alpha-2 country code (e.g. DE, PL).
  • phone: String — Recipient's phone number.
  • additional_field: String — Additional delivery instructions or address line.

PUDO-specific fields (SHIPPING_ADDRESS_GENERIC_PUDO, SHIPPING_ADDRESS_DHL_PUDO, SHIPPING_ADDRESS_PACKETA_PUDO)

  • pickup_location_id: String — Unique identifier of the pick-up point (branch ID).

DHL-specific fields (SHIPPING_ADDRESS_DHL_PUDO only)

  • dhl_post_number: String — DHL Postnummer — required for Packstation deliveries.

Packeta-specific fields (SHIPPING_ADDRESS_PACKETA_PUDO only)

  • pickup_location_name: String — Human-readable name of the Packeta pick-up point.

DPD-specific fields (SHIPPING_ADDRESS_DPD_PUDO only)

  • dpd_pudo_id: String — DPD PUDO point identifier, required for generating DPD labels.
  • dpd_parcel_shop_id: String — DPD Parcel Shop identifier.