ParcelShopFinderService

Version : 5.1 · Décembre 2025

Le ParcelShopFinderService recherche des points DPD Pickup par adresse ou par coordonnées géographiques.

remarque

Vous devez d'abord appeler LoginService pour obtenir un authToken, puis le transmettre dans l'en-tête d'authentification de chaque requête.

Méthodes

Méthode	Description
`findCities`	Trouver des villes disposant de points DPD Pickup par pays, code postal et ville
`findParcelShops`	Trouver des points DPD Pickup par pays, code postal, ville et critères de service facultatifs
`findParcelShopsByGeoData`	Trouver des points DPD Pickup par coordonnées géographiques et critères de service facultatifs

findCities

Action : http://dpd.com/common/service/ParcelShopFinderService/5.0/findCities

Entrée :

Nom	Élément
`authentication` (en-tête)	`types_authentication:authentication`
`parameters`	`types:findCities`

Sortie :

Nom	Élément
`parameters`	`types:findCitiesResponse`

Erreurs :

Nom	Élément
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

findParcelShops

Action : http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShops

Entrée :

Nom	Élément
`authentication` (en-tête)	`types_authentication:authentication`
`parameters`	`types:findParcelShops`

Sortie :

Nom	Élément
`parameters`	`types:findParcelShopsResponse`

Erreurs :

Nom	Élément
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

findParcelShopsByGeoData

Action : http://dpd.com/common/service/ParcelShopFinderService/5.0/findParcelShopsByGeoData

Entrée :

Nom	Élément
`authentication` (en-tête)	`types_authentication:authentication`
`parameters`	`types:findParcelShopsByGeoData`

Sortie :

Nom	Élément
`parameters`	`types:findParcelShopsByGeoDataResponse`

Erreurs :

Nom	Élément
`authenticationFault`	`types_authentication:authenticationFault`
`systemFault`	`types:systemFault`
`dataFault`	`types:dataFault`

Exemples

findCities — SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0"
                  xmlns:ns1="http://dpd.com/common/service/types/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findCities>
      <country>CH</country>
      <zipCode>8635</zipCode>
      <city>Dürnten</city>
      <limit>10</limit>
      <order>NAME</order>
    </ns1:findCities>
  </soapenv:Body>
</soapenv:Envelope>

remarque

Un point d'accès REST pour findCities n'est actuellement pas exposé. Utilisez le point d'accès du service SOAP indiqué dans Points d'accès pour cette méthode.

findParcelShops — SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0"
                  xmlns:ns1="http://dpd.com/common/service/types/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findParcelShops>
      <country>CH</country>
      <zipCode>8400</zipCode>
      <city>Winterthur</city>
      <limit>10</limit>
      <availabilityDate>2019-09-09</availabilityDate>
    </ns1:findParcelShops>
  </soapenv:Body>
</soapenv:Envelope>

findParcelShopsByGeoData — SOAP

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0"
                  xmlns:ns1="http://dpd.com/common/service/types/ParcelShopFinderService/5.0">
  <soapenv:Header>
    <ns:authentication>
      <delisId>{your delisId}</delisId>
      <authToken>{your authToken}</authToken>
      <messageLanguage>de_CH</messageLanguage>
    </ns:authentication>
  </soapenv:Header>
  <soapenv:Body>
    <ns1:findParcelShopsByGeoData>
      <longitude>7.593039</longitude>
      <latitude>47.588694</latitude>
      <limit>10</limit>
      <searchCountry>DE</searchCountry>
      <searchCountry>CH</searchCountry>
    </ns1:findParcelShopsByGeoData>
  </soapenv:Body>
</soapenv:Envelope>

Types complexes

Espace de noms : `types`

URL : http://dpd.com/common/service/types/ParcelShopFinderService/5.0

CityType

Le type ville avec pays, code postal et nom.

Champ	Type / Occurrence	Description
`country`	`xsd:string` / 0..1 · max 2	Code pays au format ISO 3166-1 alpha-2
`countryNum`	`xsd:int` / 0..1 · 0–999	Numéro de pays au format numérique ISO 3166 (p. ex. Suisse = 756)
`zipCode`	`xsd:string` / 0..1	Code postal de la ville
`name`	`xsd:string` / 0..1	Nom de la ville
`town`	`xsd:string` / 0..1	Localité au sein de la ville

DataFaultType

Levée lorsqu'une erreur de données survient.

Champ	Type / Occurrence	Description
`additionalData`	`xsd:string` / 0..1	Données complémentaires relatives à l'erreur
`additionalInfo`	`xsd:string` / 0..1	Informations complémentaires dans la langue de l'utilisateur
`errorClass`	`xsd:string` / 0..1	Classe ayant déclenché l'erreur
`errorCode`	`xsd:string` / 0..1	Code d'erreur
`fullMessage`	`xsd:string` / 0..1	Message complet avec informations complémentaires dans la langue de l'utilisateur
`language`	`xsd:string` / 0..1	Langue des messages
`message`	`xsd:string` / 0..1	Message d'erreur dans la langue de l'utilisateur
`shortMessage`	`xsd:string` / 0..1	Description courte de l'erreur dans la langue de l'utilisateur
`systemFullMessage`	`xsd:string` / 0..1	Message complet avec informations complémentaires dans la langue du système
`systemMessage`	`xsd:string` / 0..1	Message d'erreur dans la langue du système
`systemShortMessage`	`xsd:string` / 0..1	Description courte de l'erreur dans la langue du système

FindCitiesType

Paramètres de recherche pour findCities.

Champ	Type / Occurrence	Description
`country`	`types:CountryType` / 1..1	Pays de la recherche (ISO 3166-1 alpha-2 ou numérique)
`zipCode`	`xsd:string` / 1..1 · max 9	Code postal de l'origine de la recherche
`city`	`xsd:string` / 1..1 · max 100	Ville de l'origine de la recherche
`limit`	`xsd:int` / 1..1 · 1–10	Nombre maximal d'enregistrements dans la réponse
`order`	`xsd:string` / 1..1 · `ZIP_CODE` ou `NAME`	Champ de tri : code postal ou nom de ville

FindCitiesResponseType

Résultat de findCities.

Champ	Type / Occurrence	Description
`city`	`types:CityType` / 0..*	Liste des villes triées par nom de ville

FindParcelShopsType

Paramètres de recherche pour findParcelShops.

Champ	Type / Occurrence	Description
`country`	`types:CountryType` / 1..1	Pays de la recherche (ISO 3166-1 alpha-2 ou numérique)
`zipCode`	`xsd:string` / 1..1 · max 9	Code postal de l'origine de la recherche
`city`	`xsd:string` / 1..1 · max 100	Ville de l'origine de la recherche
`street`	`xsd:string` / 0..1 · max 100	Nom de rue de l'origine de la recherche
`houseNo`	`xsd:string` / 0..1 · max 10	Numéro de maison de l'origine de la recherche
`limit`	`xsd:int` / 1..1 · 1–10	Nombre maximal d'enregistrements dans la réponse
`availabilityDate`	`xsd:string` / 0..1 · length 10	Date de livraison la plus proche au point relais (`yyyy-MM-dd`). Minimum 24 h à l'avance. Par défaut : date d'appel + 1
`hideClosed`	`xsd:boolean` / 0..1	Sans fonctionnalité — uniquement pour rétrocompatibilité
`searchCountry`	`types:CountryType` / 0..*	Pays nationaux ou transfrontaliers pour la recherche
`services`	`types:ServicesRequestType` / 0..1	Critères de filtre de service

FindParcelShopsResponseType

Résultat de findParcelShops.

Champ	Type / Occurrence	Description
`parcelShop`	`types:ParcelShopType` / 0..*	Liste des points relais correspondant à la recherche

FindParcelShopsByGeoDataType

Paramètres de recherche pour findParcelShopsByGeoData.

Champ	Type / Occurrence	Description
`longitude`	`xsd:double` / 1..1	Longitude de l'origine de la recherche
`latitude`	`xsd:double` / 1..1	Latitude de l'origine de la recherche
`limit`	`xsd:int` / 1..1 · 1–10	Nombre maximal d'enregistrements dans la réponse
`availabilityDate`	`xsd:string` / 0..1 · length 10	Date de livraison la plus proche au point relais (`yyyy-MM-dd`). Minimum 24 h à l'avance. Par défaut : date d'appel + 1
`hideClosed`	`xsd:boolean` / 0..1	Sans fonctionnalité — uniquement pour rétrocompatibilité
`searchCountry`	`types:CountryType` / 0..*	Pays nationaux ou transfrontaliers pour la recherche
`services`	`types:ServicesRequestType` / 0..1	Critères de filtre de service

FindParcelShopsByGeoDataResponseType

Résultat de findParcelShopsByGeoData.

Champ	Type / Occurrence	Description
`parcelShop`	`types:ParcelShopType` / 0..*	Liste des points relais correspondant à la recherche

ParcelShopType

Données renvoyées pour chaque point relais correspondant.

Champ	Type / Occurrence	Description
`parcelShopId`	`xsd:long` / 0..1 · max 999999999	ID du point relais
`pudoId`	`xsd:string` / 0..1 · max 7	PUDO ID du point relais
`company`	`xsd:string` / 0..1 · max 100	Raison sociale du point relais
`street`	`xsd:string` / 0..1 · max 100	Rue (parfois combinée au numéro de maison)
`houseNo`	`xsd:string` / 0..1 · max 8	Numéro de maison
`country`	`xsd:string` / 0..1 · max 2	Code pays au format ISO 3166-1 alpha-2
`countryNum`	`xsd:int` / 0..1 · 0–999	Numéro de pays au format numérique ISO 3166-1
`state`	`xsd:string` / 0..1 · max 22	Nom de l'État
`zipCode`	`xsd:string` / 0..1 · max 10	Code postal
`city`	`xsd:string` / 0..1 · max 100	Ville
`town`	`xsd:string` / 0..1 · max 35	Localité (partie de la ville)
`phone`	`xsd:string` / 0..1 · max 50	Numéro de téléphone
`fax`	`xsd:string` / 0..1 · max 50	Numéro de fax
`email`	`xsd:string` / 0..1 · max 100	Adresse e-mail
`homepage`	`xsd:string` / 0..1 · max 100	Site web
`latitude`	`xsd:double` / 0..1	Latitude du point relais
`longitude`	`xsd:double` / 0..1	Longitude du point relais
`coordinateX`	`xsd:double` / 0..1	Coordonnée géographique X
`coordinateY`	`xsd:double` / 0..1	Coordonnée géographique Y
`coordinateZ`	`xsd:double` / 0..1	Coordonnée géographique Z
`distance`	`xsd:double` / 0..1	Distance par rapport à l'origine de la recherche
`expressPickupTime`	`xsd:string` / 0..1 · max 5	Heure de collecte des envois express
`extraInfo`	`xsd:string` / 0..1 · max 300	Informations complémentaires (p. ex. emplacement dans un centre commercial)
`openingHours`	`types:OpeningHoursType` / 0..*	Liste des horaires d'ouverture
`holiday`	`types:HolidayType` / 0..*	Liste des périodes de fermeture du point relais
`services`	`types:ServicesType` / 0..1	Services pris en charge

OpeningHoursType

Champ	Type / Occurrence	Description
`weekday`	`xsd:string` / 0..1	Nom localisé du jour de la semaine
`openMorning`	`xsd:string` / 0..1	Heure d'ouverture le matin
`closeMorning`	`xsd:string` / 0..1	Heure de fermeture le matin
`openAfternoon`	`xsd:string` / 0..1	Heure d'ouverture l'après-midi
`closeAfternoon`	`xsd:string` / 0..1	Heure de fermeture l'après-midi

HolidayType

Champ	Type / Occurrence	Description
`holidayStart`	`xsd:string` / 0..1	Début de la période de fermeture (`yyyy-MM-dd HH:mm:ss`)
`holidayEnd`	`xsd:string` / 0..1	Fin de la période de fermeture (`yyyy-MM-dd HH:mm:ss`)

ServicesRequestType

Champ	Type / Occurrence	Description
`service`	`types:ServiceRequestType` / 0..*	Liste des filtres de service

ServiceRequestType

Champ	Type / Occurrence	Description
`code`	`types:CodeType` / 1..1	Code de service (length 3)
`available`	`xsd:boolean` / 1..1	Doit être `true`
`serviceDetail`	—	Sans fonctionnalité — uniquement pour rétrocompatibilité

ServicesType

Champ	Type / Occurrence	Description
`service`	`types:ServiceType` / 0..*	Liste des services pris en charge

ServiceType

Champ	Type / Occurrence	Description
`code`	`types:CodeType` / 1..1	Code de service
`available`	`xsd:boolean` / 1..1	Indique si le service est disponible pour la recherche de points relais
`description`	`types:DescriptionType` / 0..1	Description du service (max 500 caractères)
`serviceDetail`	`types:ServiceDetailType` / 0..*	Liste des informations détaillées du service

SystemFaultType

Levée lorsqu'une erreur système interne survient.

Champ	Type / Occurrence	Description
`additionalData`	`xsd:string` / 0..1	Données complémentaires relatives à l'erreur
`additionalInfo`	`xsd:string` / 0..1	Informations complémentaires dans la langue de l'utilisateur
`errorClass`	`xsd:string` / 0..1	Classe ayant déclenché l'erreur
`errorCode`	`xsd:string` / 0..1	Code d'erreur
`fullMessage`	`xsd:string` / 0..1	Message complet avec informations complémentaires dans la langue de l'utilisateur
`language`	`xsd:string` / 0..1	Langue des messages
`message`	`xsd:string` / 0..1	Message d'erreur dans la langue de l'utilisateur
`shortMessage`	`xsd:string` / 0..1	Description courte de l'erreur dans la langue de l'utilisateur
`systemFullMessage`	`xsd:string` / 0..1	Message complet avec informations complémentaires dans la langue du système
`systemMessage`	`xsd:string` / 0..1	Message d'erreur dans la langue du système
`systemShortMessage`	`xsd:string` / 0..1	Description courte de l'erreur dans la langue du système

Espace de noms : `types_authentication`

URL : http://dpd.com/common/service/types/Authentication/2.0

authentication

Champ	Type / Occurrence	Description
`delisId`	`xsd:string` / 1..1 · 8–10 caractères	Identifiant utilisateur DELIS
`authToken`	`xsd:string` / 1..1 · 0–64 caractères	Jeton issu de `LoginService.getAuth`
`messageLanguage`	`xsd:string` / 1..1 · length 5	`de_CH`, `fr_CH`, `it_CH` ou `en_CH`

Types simples

Espace de noms : `types`

URL : http://dpd.com/common/service/types/ParcelShopFinderService/5.0

Type	Type de base	Contrainte	Description
`CodeType`	`xsd:string`	length 3	Code de service ou de détail de service
`CountryType`	`xsd:string`	1–3 caractères	ISO 3166-1 alpha-2 (p. ex. `CH`) ou numérique (p. ex. `756`)
`DescriptionType`	`xsd:string`	max 500	Description d'un service ou d'un détail de service

Points d'accès

Environnement	Protocole	URL
Stage	SOAP (toutes les méthodes)	`https://shivah-st.dpd.ch/external/soap/services/ParcelShopFinderService`
Live	SOAP (toutes les méthodes)	`https://shivah.dpd.ch/external/soap/services/ParcelShopFinderService`
Stage	REST · findParcelShops	`https://shivah-st.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShops`
Live	REST · findParcelShops	`https://shivah.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShops`
Stage	REST · findParcelShopsByGeoData	`https://shivah-st.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShopsByGeoData`
Live	REST · findParcelShopsByGeoData	`https://shivah.dpd.ch/external/rest/services/ParcelShopFinderService/findParcelShopsByGeoData`

Méthodes​

findCities​

findParcelShops​

findParcelShopsByGeoData​

Exemples​

findCities — SOAP​

findParcelShops — SOAP​

findParcelShopsByGeoData — SOAP​

Types complexes​

Espace de noms : types​

CityType​

DataFaultType​

FindCitiesType​

FindCitiesResponseType​

FindParcelShopsType​

FindParcelShopsResponseType​

FindParcelShopsByGeoDataType​

FindParcelShopsByGeoDataResponseType​

ParcelShopType​

OpeningHoursType​

HolidayType​

ServicesRequestType​

ServiceRequestType​

ServicesType​

ServiceType​

SystemFaultType​

Espace de noms : types_authentication​

authentication​

Types simples​

Espace de noms : types​

Points d'accès​

Méthodes

findCities

findParcelShops

findParcelShopsByGeoData

Exemples

findCities — SOAP

findParcelShops — SOAP

findParcelShopsByGeoData — SOAP

Types complexes

Espace de noms : `types`

CityType

DataFaultType

FindCitiesType

FindCitiesResponseType

FindParcelShopsType

FindParcelShopsResponseType

FindParcelShopsByGeoDataType

FindParcelShopsByGeoDataResponseType

ParcelShopType

OpeningHoursType

HolidayType

ServicesRequestType

ServiceRequestType

ServicesType

ServiceType

SystemFaultType

Espace de noms : `types_authentication`

authentication

Types simples

Espace de noms : `types`

Points d'accès