Sidebar
en:soap_allgemein
Table of Contents
Interface - SOAP in general
General
As a user of the PDI interface, you receive a personal URL to call the Web service WSDL with the functions customised for you, in the following form:
With this example, you can instance your SOAP client under PHP, for example:
ini_set("soap.wsdl_cache_enabled", "0");
$client = new SoapClient('https://services.pdi.elanders-germany.com/application_services/pdi-service/service.php?wsdl&uid=xyz123');
The SOAP client then has all the services available that are provided by the Web service.
To download the WSDL, you can place the “download” parameter behind it:
How it works
Each function expects your individual client code as the first parameter. the second parameter is always the appropriate MD5-encrypted password, followed by function-specific parameters. All parameters for a function are mandatory. The return value is always a multidimensional associate array in the following format:
| Element | Value | Description |
| success | true / false | specifies whether the request was successful |
| error_code | Int | Unique error code for [“success”] = false |
| error_msg | String | More detailed error message for [“success”] = false |
| data | Array | Function-specific return array. See function descriptions. |
The elements [“success”], [“error_code”] and [“error_msg”] are included in every response. They are therefore not described again for each function below. All function-specific returns are in the element [“data”].
Security
Please be sure you have transmitted a correct password. If your system provide incorrect data 5 times in a short period, your IP will be blocked for 30 minutes. This is important for systems that access the SOAP interface automatically.
The response for a block looks like this:
[error_code] => 13050 [error_msg] => Too much failed logins. Please try again later.
Service mode
The PDI SOAP service has a service mode message.
The service window is Mondays from 6:00 to 8:00 PM. If this falls on a holiday, the service window will be moved to the following working day. If necessary, updates, patches and so on are loaded during that time. If necessary, patches can also be loaded immediately outside that time. During this time, you will see the following message:
[error_code] => 13010 [error_msg] => Our service is in maintenance mode, please try again later.
You can transmit your orders as soon as the service is available again.
Exception handling
Please be sure to provide exception handling in your application.
You can find a complete list of error code here.
Tips
The SOAP interface is NOT intended for polling for status queries or notifications, since this would cause enormous overhead. PDI will automatically block usage of this kind.
The interface is outstandingly good for integration into your backend system, for example to implement a simple option for cancellations from your call centre.
If there is high traffic, the XML-based interfaces for “Tracking” and “Command request” must be used.
SSL Intermediate Cert
To check SSL connection please use the following intermediate Cert. We use a wildcard cert for all PDI-Servers.
-----BEGIN CERTIFICATE----- MIIEpjCCA46gAwIBAgIQKByJKWYUQ4BCY1U6MkCuszANBgkqhkiG9w0BAQsFADCB mDELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xOTA3BgNVBAsT MChjKSAyMDA4IEdlb1RydXN0IEluYy4gLSBGb3IgYXV0aG9yaXplZCB1c2Ugb25s eTE2MDQGA1UEAxMtR2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhv cml0eSAtIEczMB4XDTE1MDYzMDAwMDAwMFoXDTI1MDYyOTIzNTk1OVowRzELMAkG A1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xIDAeBgNVBAMTF1JhcGlk U1NMIFNIQTI1NiBDQSAtIEc0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC AQEAwJ46D5qyutPS3BXs0DBUWTBNQFGuQnFx0o1Tc4H+uODElsWOfsLxt2NKz6ce P6jnzlOg+i331ubOcBGm7uEDUtJo3j0IDYf9HNcLl2JtgjB2G0c6xPfO7R18jLcX jlOAHh0PXYz5kOQEHgJ+y7BJ79pSJfv7Z+3dhHRZhA7z3nBmjeRSOPdTWjcTZws+ u6hYty7t/7deEXO5d0VSZ0auxNwkgYl2CsqhbGZzBIKq9XBsXxuaAHlG1n96Jhcw zzlLLHTZiUR2ENDt94u7iQV1TQsNs9rpv/FqfSoR2x6fjOPEBmnhHYhFOdFuVdiq t5tv6vTerBcRkl1Am4N7muL3qQIDAQABo4IBOjCCATYwLgYIKwYBBQUHAQEEIjAg MB4GCCsGAQUFBzABhhJodHRwOi8vZy5zeW1jZC5jb20wEgYDVR0TAQH/BAgwBgEB /wIBADBJBgNVHSAEQjBAMD4GBmeBDAECATA0MDIGCCsGAQUFBwIBFiZodHRwczov L3d3dy5nZW90cnVzdC5jb20vcmVzb3VyY2VzL2NwczA2BgNVHR8ELzAtMCugKaAn hiVodHRwOi8vZy5zeW1jYi5jb20vR2VvVHJ1c3RQQ0EtRzMuY3JsMB0GA1UdJQQW MBQGCCsGAQUFBwMBBggrBgEFBQcDAjAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE FPO1VgzECbC0zx+q+d0jVvB36KH5MB8GA1UdIwQYMBaAFMR5yo6hTgMdHNxr2zFb lD4/MH8tMA0GCSqGSIb3DQEBCwUAA4IBAQDDftiDSwRMVSkqTxSdmm7ekHDBpCZM iI54SO+9nLCg9fBm/P5ZJuF578i3YGSoi0fqL+CDmdpBGdfFvgX68pAR8Ar/bNwF tNgGb6Rvjb4gK1Tb+aJFg5oepSGJNR18IFwX/QQuRdiyxvhCmfxUCE5LgF85N7qV TqY3Cp6TXodb6ZDWqLZlCI1hSeuDIKldGxZgYmsvVPtaAg16J+JL4QUUwuTp+XDA 2fc0ZQ6ikUusKPK3CA+Yytc+cLbIC/GLnFH4xhBs0lNPYowRAD6I37/m0sxwve0l nPvdJAq9WZFKQgM4EnEyiHagjny7Mu+IKhvUam9QuVJni6sw+h/94ySa -----END CERTIFICATE-----
en/soap_allgemein.txt · Last modified: 2019/04/08 16:35 (external edit)
Page Tools
