http://www.ibm.com/wsdl/soa/pxsms/v1_0/interface
The SmsNotification Port Type

SmsNotification is the application side notification interface to which short messages are delivered.

This interface is part of the collection of Parlay X outbound notifications supported by the PX Notification common component.

 Collapse Operations
SmsNotification_notifySmsDeliveryReceiptResponse  notifySmsDeliveryReceipt (notifySmsDeliveryReceipt parameters) [faults:  InvocationException  ]

The notifySmsDeliveryReceipt method must be implemented by a Web Service at the application side if it requires notification of SMSdelivery receipt. It will be invoked by the Parlay X server to notify the application when a SMS sent by an application has been delivered to the terminal of the recipient or if delivery is impossible. The notification will occur if and only if the status of the sent SMS is DeliveredToTerminal or DeliveryImpossible and the application has specified interest in notification when sending an SMS message by specifying the optional receiptRequest parameter. The correlator returned corresponds to the identifier specified by the application in the receiptRequest of the original sendSMS request.

When a SMS message is sent to multiple addresses, the notification from the server will send notification for each terminal as and when a SMS message is delivered to a terminal.

The following three different SMS delivery status will be returned in NotifySMSDeliveryReceiptResponse:

  • 'DeliveryImpossible': unsuccessful delivery; the message could not be delivered before it expired.
  • 'DeliveredToTerminal': in case of concatenated messages, only when all the SMS-parts have been successfully delivered to the terminal.
  • DeliveredNotificationNotSupported - If notification is supported by the network but it does not support delivery receipt for one or more addresses specified in the sendSMS message. The service will send this status for those addresses.

SmsNotification_notifySmsReceptionResponse  notifySmsReception (notifySmsReception parameters) [faults:  InvocationException  ]

The notification is used to send a short message to the application. The notification will occur only if the SMS fulfils the criteria specified when starting the SMS notification.

The notifySmsReception method must be implemented by a Web Service at the application side. It will be invoked by the Parlay X server to notify the application of the reception of an SMS. The notification will occur if and only if the SMS received fulfils the criteria specified in a provisioning step, identified by the correlator. The criteria must at least include an smsServiceActivationNumber, i.e. the SMS destination address that can be "monitored" by the application. The parameter senderAddress contains the address of the sender. The application can apply the appropriate service logic to process the SMS.


 Collapse XML
-<wsdl:portType  name="SmsNotification">
-<wsdl:documentation>
<xhtml:p>SmsNotification is the application side notification interface to which short messages are delivered.</xhtml:p>
-<xhtml:p>
-<xhtml:b>
<xhtml:i>This interface is part of the collection of Parlay X outbound notifications supported by the PX Notification common component.</xhtml:i>
</xhtml:b>
</xhtml:p>
</wsdl:documentation>
-<wsdl:operation  name="notifySmsReception">
-<wsdl:documentation>
<xhtml:p>The notification is used to send a short message to the application. The notification will occur only if the SMS fulfils the criteria specified when starting the SMS notification.</xhtml:p>
<xhtml:p>The notifySmsReception method must be implemented by a Web Service at the application side. It will be invoked by the Parlay X server to notify the application of the reception of an SMS. The notification will occur if and only if the SMS received fulfils the criteria specified in a provisioning step, identified by the correlator. The criteria must at least include an smsServiceActivationNumber, i.e. the SMS destination address that can be "monitored" by the application. The parameter senderAddress contains the address of the sender. The application can apply the appropriate service logic to process the SMS.</xhtml:p>
</wsdl:documentation>
<wsdl:fault  message="soa_pxnotify_faults:InvocationException"  name="InvocationException" />
</wsdl:operation>
-<wsdl:operation  name="notifySmsDeliveryReceipt">
-<wsdl:documentation>
<xhtml:p>The notifySmsDeliveryReceipt method must be implemented by a Web Service at the application side if it requires notification of SMSdelivery receipt. It will be invoked by the Parlay X server to notify the application when a SMS sent by an application has been delivered to the terminal of the recipient or if delivery is impossible. The notification will occur if and only if the status of the sent SMS is DeliveredToTerminal or DeliveryImpossible and the application has specified interest in notification when sending an SMS message by specifying the optional receiptRequest parameter. The correlator returned corresponds to the identifier specified by the application in the receiptRequest of the original sendSMS request.</xhtml:p>
<xhtml:p>When a SMS message is sent to multiple addresses, the notification from the server will send notification for each terminal as and when a SMS message is delivered to a terminal.</xhtml:p>
<xhtml:p>The following three different SMS delivery status will be returned in NotifySMSDeliveryReceiptResponse:</xhtml:p>
-<xhtml:ul>
<xhtml:li>'DeliveryImpossible': unsuccessful delivery; the message could not be delivered before it expired.</xhtml:li>
<xhtml:li>'DeliveredToTerminal': in case of concatenated messages, only when all the SMS-parts have been successfully delivered to the terminal.</xhtml:li>
<xhtml:li>DeliveredNotificationNotSupported - If notification is supported by the network but it does not support delivery receipt for one or more addresses specified in the sendSMS message. The service will send this status for those addresses.</xhtml:li>
</xhtml:ul>
</wsdl:documentation>
<wsdl:fault  message="soa_pxnotify_faults:InvocationException"  name="InvocationException" />
</wsdl:operation>
</wsdl:portType>
 Collapse Used-By
Service Port Binding
SmsNotificationService SmsNotification SmsNotificationBinding
Generated by WSDLdoc ©