Schenker Privpak AB Interface documentation for web service packageservices.asmx 2012-09-01 Version: 1.0.0 Doc. no.: I04304b
Sida 2 av 7 Revision history Datum Version Sign. Kommentar 2012-09-01 1.0.0 TE First public version that only includes SearchCollectionPoint.
Sida 3 av 7 Index Revision history... 2 1. General information... 4 1.1. Getting started... 4 1.2. Authentication... 4 2. Method: SearchCollectionPoint... 5 2.1. Information... 5 2.2. Request... 5 2.3. Response... 5 2.4. Error handling... 6 2.5. Miscellaneous... 6 3. Method: GetCollectionPointInfo... 6 3.1. Information... 6 3.2. Request... 6 3.3. Response... 6 3.4. Error handling... 6 4. Appendix... 7 4.1. Consignment Product ID... 7 4.2. Return Product ID... 7
Sida 4 av 7 1. General information 1.1. Getting started The web service is located at the URL below: http://privpakservices.schenker.nu/package/package_1.3/packageservices.asmx 1.2. Authentication To use the methods SearchCollectionPoint and GetCollectionPointInfo a registration is required. Registration form is located at the URL below: http://privpakservices.schenker.nu/package/package_1.3/register.aspx The reason that the registration requires an email address is so that we can communicate updates made to our web services. To gain access to the other methods in this web service, you must first have an account set up. Your contact at the Schenker Privpak AB sales department can help you to set one up.
Sida 5 av 7 2. Method: SearchCollectionPoint 2.1. Information Returns a list of nearby (based on post code or city) collection points. To choose one automatically, enter the consumer s post code and then use the first item of the list. This results in a collection point with a minimal distance to the consumer. 2.2. Request Name Type Required Description CustomerID Int Yes Product Ombud Ekonomi Sweden: Customer ID 1 = (if you don t have a CustomerId) Product Ombud Standard Sweden: 10070= always 10070 Key String Yes (1) Registration key ServiceID String No Default value = (blank) ParamID Int Yes Product Ombud Ekonomi Sweden: 0= with subcontractor(default) 1= without subcontractor Product Ombud Standard Sweden: 1=Ombud Standard with subcontractors Address String No Street address Postcode String Yes (2) Post code City String Yes (2) City Maxhits Int Yes Default value = 0 (gives max 15-20 hits) Use to limit the number of hits displayed. 1: To obtain a key, see chapter 1.2. 2: Either postcode or city is required. 2.3. Response Name Description CpointID Id of collection point DisplayName Name of collection point Distance Distance to collection point AddressLine1 Address of collection point AddressLine2 Address of collection point PostCode Post code of collection point City City of collection point CountryCode Country code OpenHours Open hours OpenHours1 Open hours detail row 1 OpenHours2 Open hours detail row 2 OpenHours3 Open hours detail row 3 Directions Additional directions to the collection point CardAvailable Bank/credit card available CardName Bank/credit card information CardInfo Bank/credit card additional information Latitude Coordinate in Decimal Degrees (WGS84) Longitude Coordinate in Decimal Degrees (WGS84)
Sida 6 av 7 ConsignmentProductID ReturnProductID Required parameter for consignments via EDI files. Also to be used with future method Consignment (currently not implemented) See chapter 4.1 Required input parameter for methods ConsignmentReturn and Return. See 4.2 2.4. Error handling We return an item with CpointID = -1 if an exception occurs, for example when no match is found. Error message is in that case sent in the field DisplayName. 2.5. Miscellaneous Searching by street address is not yet implemented. We may add this in a future release. 3. Method: GetCollectionPointInfo 3.1. Information This method returns information for a certain collection point. 3.2. Request Name Type Required Description CustomerID Int Yes Your customer ID in our system. If you do not have a customer ID, set to 1 for Sweden or 2 for Norway Key String Yes (1) Registration key ServiceID String No Default value = (blank) CpointID String Yes Collection point ID 1: To obtain a key, see chapter 1.2. 3.3. Response See chapter 2.3. 3.4. Error handling See chapter 2.4.
Sida 7 av 7 4. Appendix 4.1. Consignment Product ID ProductID Description Note 1000 Consignment Schenker Privpak Used in EDI files only 1010 Consignment Posten Norden (Sweden) Not yet implemented 1030 Consignment Itella/Posten Finland (Finland) Not yet implemented 4.2. Return Product ID ProductID Description Note 2000 Return Schenker Privpak 2010 Return Posten Norden (Sweden) 2030 Return Itella/ Posten Finland (Finland)