Shops United
Dutch shipping aggregator with PostNL, DHL, Brenger, Budbee, Homerr, UPS and FedEx Cross Border. One account, multiple carriers, bundled rates.
Endpoints (6)
Validate that the configured Shops United credentials work. Lightweight sanity check — run this right after setup_integration to confirm the User ID and API Key are accepted.
No input parameters required.
List the carrier + type combinations available for this account (e.g. PostNL Standaard Pakket, DHL ServicePoint). The Carrier and Type values returned here are exactly what create-shipment expects. Result rarely changes — safe to cache.
No input parameters required.
Find the 20 nearest pickup locations (PostNL Postkantoor, DHL ServicePoint, etc.) near a recipient address. The returned ProductCode is used in create-shipment.PickupLocationProductCode when creating a ServicePoint shipment.
| Field | Type | Required | Description |
|---|---|---|---|
postcode |
string | ✓ Yes | Recipient postcode (NL format: 1234 AB or 1234AB). |
huisnummer |
integer | ✓ Yes | Recipient house number. |
straat |
string | No | Optional street name (helps with edge-case postcodes). |
carrier |
string | No | Filter to one carrier (e.g. "PostNL", "DHL"). Omit for all. |
Create a shipment label. Returns ZendingId, Referentie, LabelUrl, and TrackTraceUrl. Sender fields are optional — when omitted, the sender configured in the Shops United account is used. Note: when any sender field is provided, the handler conditionally includes PostcodeAfzender in the HMAC signature (vendor requirement).
| Field | Type | Required | Description |
|---|---|---|---|
Carrier |
string | ✓ Yes | Carrier value from list-shipment-types (e.g. "PostNL"). |
Type |
string | ✓ Yes | Type value from list-shipment-types (e.g. "Standaard Pakket"). |
Referentie |
string | ✓ Yes | Order reference / external ID. Returned in shipment record. |
Naam |
string | ✓ Yes | Recipient name. |
Straat |
string | ✓ Yes | Recipient street. |
Nummer |
integer | ✓ Yes | Recipient house number. |
Postcode |
string | ✓ Yes | Recipient postcode. |
Plaats |
string | ✓ Yes | Recipient city. |
Land |
string | ✓ Yes | Recipient country, ISO 3166-1 alpha-2 (e.g. "NL", "BE", "DE"). |
Email |
string | ✓ Yes | Recipient email — used for track & trace notifications. |
Gewicht |
number | ✓ Yes | Package weight in kg (decimal, e.g. 1.5). |
Toevoeging |
string | No | House number addition (e.g. "A", "bis"). |
Telefoon |
string | No | Recipient phone — required by some international carriers. |
AantalPakketten |
integer | No | Number of parcels in this shipment. Default: 1. |
Opmerking |
string | No | Note printed on the label. |
NaamAfzender |
string | No | Sender name. Omit to use account default sender. |
StraatAfzender |
string | No | |
NummerAfzender |
integer | No | |
ToevoegingAfzender |
string | No | |
PostcodeAfzender |
string | No | Sender postcode. NOTE: when any sender field is set, this must be included in the HMAC signature (handler does this). |
PlaatsAfzender |
string | No | |
LandAfzender |
string | No | |
TelefoonAfzender |
string | No | |
PickupLocationName |
string | No | ServicePoint name from list-pickup-locations. |
PickupLocationStreet |
string | No | |
PickupLocationProductCode |
string | No | ProductCode from list-pickup-locations result. |
Zaterdaglevering |
integer | No | 1 = Saturday delivery, 0 = standard. Carrier-dependent. |
AvondLevering |
integer | No | 1 = evening delivery, 0 = standard. Carrier-dependent. |
NietBijBuren |
integer | No | 1 = do not deliver to neighbors. |
HandtekeningVoorOntvangst |
integer | No | 1 = signature required at delivery. |
VerhoogdAansprakelijk |
integer | No | 1 = enhanced liability insurance. |
Rembours |
integer | No | Cash-on-delivery amount in cents. |
Retrieve the label (PDF or HTML) for an existing shipment. Note: create-shipment already returns LabelUrl — use this endpoint only for re-print or programmatic download.
| Field | Type | Required | Description |
|---|---|---|---|
shipment_id |
integer | ✓ Yes | ZendingId returned by create-shipment. |
format |
string | No | Label format: "pdf" (base64) or "html". Default: pdf. |
List the 50 most recent shipments for this account. No pagination supported by upstream API.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| validate-credentials | shopsunited_validate_credentials |
| list-shipment-types | shopsunited_list_shipment_types |
| list-pickup-locations | shopsunited_list_pickup_locations |
| create-shipment | shopsunited_create_shipment |
| get-shipment-label | shopsunited_get_shipment_label |
| list-shipments | shopsunited_list_shipments |