google4r-checkout 1.0.2 → 1.0.3

data/CHANGES

@@ -1,5 +1,21 @@
 =google4r-checkout Changelog
 
+== 1.0.3 (2008-08-08)
+
+* Added analytics_data support.  Thanks to Will Schwenk!
+* Added create_address_filters_allowed_area and create_address_filters_excluded_area method to the MerchantCalculatedShipping class.
+* Created two aliases create_shipping_restrictions_allowed_area and create_shipping_restrictions_excluded_area to facilitate deprecation of create_allowed_area and create_excluded_area.
+* country_code in PostalArea class is now optional in the initialize method so it can be called properly in the create_area method in shared.rb.
+* Added line-item shipping support.
+* Refactor notifications to extract a base notification class that has the front_end, serial_number, google_order_number and timestamp.
+* Added notification handshake support (i.e. serial-number) for notifciation-acknowledgement.
+* Added digital delivery support.  Thanks to Andy Kim and Matthew Moore!
+* Added Carrier Calculated Shipping support.
+* Added unit tests - carrier_calculated_shipping_test.rb, digital_content_test.rb, *_items_*commands.rb
+* Updated unit tests - item_test.rb, merchant_calculated_shipping_test.rb, notification_acknowledgement_test.rb
+* Updated integration test - checkout_command_test.rb
+* Added HTML Form API Signature support.  It is included in utils.rb.
+
 == 1.0.2 (2007-08-18)
 
 * Moved Address from notifications.rb to shared.rb

data/lib/google4r/checkout/commands.rb

@@ -40,17 +40,15 @@ module Google4R #:nodoc:
     class Command
       # The URL to use for requests to the sandboxed API. The merchant id is to be
       # put in via String#%.
-      #--
-      # TODO: Move this into a class variable (e.g. via cattr) so it is adaptable.
-      #++
-      SANDBOX_URL = "https://sandbox.google.com/checkout/cws/v2/Merchant/%s/request"
+      SANDBOX_URL_PREFIX = 'https://sandbox.google.com/checkout/'
       
       # The URL to use for real requests to the Google Checkout API. The merchant id
       # is to be put in via String#%.
-      #--
-      # TODO: Move this into a class variable (e.g. via cattr) so it is adaptable.
-      #++
-      PRODUCTION_URL = "https://checkout.google.com/cws/v2/Merchant/%s/request"
+      PRODUCTION_URL_PREFIX = 'https://checkout.google.com/'
+      
+      CHECKOUT_API_URL = 'api/checkout/v2/merchantCheckout/Merchant/%s'
+      
+      ORDER_PROCESSING_API_URL = 'api/checkout/v2/request/Merchant/%s'
       
       # The Frontent class that was used to create this CheckoutCommand and whose
       # configuration will be used.
@@ -64,6 +62,9 @@ module Google4R #:nodoc:
 
       # Initialize the frontend attribute with the value of the frontend parameter.
       def initialize(frontend)
+        if self.instance_of?(Command) || self.instance_of?(ItemsCommand)
+          raise 'Cannot instantiate abstract class ' + self.class.to_s
+        end
         @frontend = frontend
       end
 
@@ -81,10 +82,17 @@ module Google4R #:nodoc:
         # Create HTTP(S) POST command and set up Basic Authentication.
         url_str = 
           if frontend.configuration[:use_sandbox] then
-            SANDBOX_URL % frontend.configuration[:merchant_id]
+            SANDBOX_URL_PREFIX
+          else
+            PRODUCTION_URL_PREFIX
+          end
+        url_str += 
+          if self.class == CheckoutCommand then
+            CHECKOUT_API_URL
           else
-            PRODUCTION_URL % frontend.configuration[:merchant_id]
+            ORDER_PROCESSING_API_URL
           end
+        url_str = url_str % frontend.configuration[:merchant_id]
         url = URI.parse(url_str)
         
         request = Net::HTTP::Post.new(url.path)
@@ -138,12 +146,8 @@ module Google4R #:nodoc:
       
       # Class method to return the command's XML representation.
       def to_xml
-        if self.class == Command then
-          raise NotImplementedError, "Command#to_xml has to be used in a subclass."
-        else
-          generator_class = Google4R::Command.get_const("#{self.class}XmlGenerator")
-          return generator_class.new(self).generate
-        end
+        generator_class = Google4R::Command.get_const("#{self.class}XmlGenerator")
+        return generator_class.new(self).generate
       end
       
       protected
@@ -219,6 +223,13 @@ module Google4R #:nodoc:
       
       # A Google Checkout merchant ID that identifies the eCommerce provider.
       attr_accessor :platform_id
+
+      # Setting this allows Google Analytics to track purchases that use Checkout
+      # The value should be as set by the analytics javascript in the hidden form
+      # element names "analyticsdata" on the page with the checkout button.
+      # If left unset then the element will not be generated.
+      # see: http://code.google.com/apis/checkout/developer/checkout_analytics_integration.html
+      attr_accessor :analytics_data
       
       # Generates the XML for this CheckoutCommand.
       def to_xml
@@ -249,7 +260,9 @@ module Google4R #:nodoc:
       #
       # Raises a ArgumentError if the parameter clazz is invalid.
       def create_shipping_method(clazz, &block)
-        if not [ PickupShipping, FlatRateShipping, MerchantCalculatedShipping ].include?(clazz) then
+        if not [ PickupShipping, FlatRateShipping, 
+                 MerchantCalculatedShipping, CarrierCalculatedShipping
+               ].include?(clazz) then
           raise ArgumentError, "Unknown shipping method: #{clazz.inspect}."
         end
         
@@ -278,6 +291,10 @@ module Google4R #:nodoc:
         @serial_number = serial_number
         @redirect_url = redirect_url
       end
+      
+      def to_s
+        return @redirect_url
+      end
     end
 
     #
@@ -288,11 +305,6 @@ module Google4R #:nodoc:
       # The amount to charge, optional, Money
       attr_accessor :amount
 
-      # frontend, required
-      def initialize(frontend)
-        super(frontend)
-      end
-
       # Generates the XML for this ChargeOrderCommand
       def to_xml
         ChargeOrderCommandXmlGenerator.new(self).generate
@@ -310,10 +322,6 @@ module Google4R #:nodoc:
       # A comment related to the refunded order, String of maximum 140 characters, optional
       attr_accessor :comment
 
-      def initialize(frontend)
-        super(frontend)
-      end
-
       def to_xml
         RefundOrderCommandXmlGenerator.new(self).generate
       end
@@ -327,10 +335,6 @@ module Google4R #:nodoc:
       # A comment related to the cancelled order, String of maximum 140 characters, optional
       attr_accessor :comment
 
-      def initialize(frontend)
-        super(frontend)
-      end
-
       def to_xml
         CancelOrderCommandXmlGenerator.new(self).generate
       end
@@ -340,10 +344,6 @@ module Google4R #:nodoc:
     # a customer's credit card for the uncharged balance of an order to verify that
     # funds for the order are available
     class AuthorizeOrderCommand < Command
-      def initialize(frontend)
-        super(frontend)
-      end
-
       def to_xml
         AuthorizeOrderCommandXmlGenerator.new(self).generate
       end
@@ -352,10 +352,6 @@ module Google4R #:nodoc:
     # The ProcessOrderCommand instructs Google Checkout to to update
     # an order's fulfillment state from NEW to PROCESSING
     class ProcessOrderCommand < Command
-      def initialize(frontend)
-        super(frontend)
-      end
-
       def to_xml
         ProcessOrderCommandXmlGenerator.new(self).generate
       end
@@ -366,10 +362,6 @@ module Google4R #:nodoc:
     class AddMerchantOrderNumberCommand < Command
       # The merchant-assigned order number associated with an order
       attr_accessor :merchant_order_number
-      
-      def initialize(frontend)
-        super(frontend)
-      end
 
       def to_xml
         AddMerchantOrderNumberCommandXmlGenerator.new(self).generate
@@ -387,10 +379,6 @@ module Google4R #:nodoc:
       
       # The shipper's tracking number that is associated with an order
       attr_accessor :tracking_number
-      
-      def initialize(frontend)
-        super(frontend)
-      end
 
       def to_xml
         DeliverOrderCommandXmlGenerator.new(self).generate
@@ -405,10 +393,6 @@ module Google4R #:nodoc:
       
       # The shipper's tracking number that is associated with an order
       attr_accessor :tracking_number
-      
-      def initialize(frontend)
-        super(frontend)
-      end
 
       def to_xml
         AddTrackingDataCommandXmlGenerator.new(self).generate
@@ -420,12 +404,8 @@ module Google4R #:nodoc:
       # The message to the customer
       attr_accessor :message
       
-      # if google checkout should email buyer to ssay order is dispatched
+      # if google checkout should email buyer to say order is dispatched
       attr_accessor :send_email
-      
-      def initialize(frontend)
-        super(frontend)
-      end
 
       def to_xml
         SendBuyerMessageCommandXmlGenerator.new(self).generate
@@ -434,10 +414,6 @@ module Google4R #:nodoc:
     
     # The ArchiveOrderCommand instructs Google Checkout to remove an order from your Merchant Center Inbox.
     class ArchiveOrderCommand < Command
-      def initialize(frontend)
-        super(frontend)
-      end
-
       def to_xml
         ArchiveOrderCommandXmlGenerator.new(self).generate
       end
@@ -445,12 +421,76 @@ module Google4R #:nodoc:
       
     # The UnarchiveOrderCommand instructs Google Checkout to return a previously archived order to your Merchant Center Inbox.
     class UnarchiveOrderCommand < Command
+      def to_xml
+        UnarchiveOrderCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    #
+    # XML API Commands for Line-item Shipping
+    #
+
+    # Abstract class for Line-item shipping commands
+    class ItemsCommand < Command
+      # An array of ItemInfo objects that you are marking as backordered,
+      # cancelled, returned or resetting shipping information
+      attr_accessor :item_info_arr
+      
+      # if google checkout should email buyer to say order is dispatched
+      attr_accessor :send_email
+      
       def initialize(frontend)
-        super(frontend)
+        super
+        @item_info_arr = []
+        @send_email = false
       end
+    end
 
+    # The <ship-items> command specifies shipping information for one or 
+    # more items in an order.
+    class ShipItemsCommand < ItemsCommand
       def to_xml
-        UnarchiveOrderCommandXmlGenerator.new(self).generate
+        ShipItemsCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The <backorder-items> command lets you specify that one or more
+    # specific items in an order are out of stock.
+    class BackorderItemsCommand < ItemsCommand
+      def to_xml
+        BackorderItemsCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The <cancel-items> command lets you specify that one or more
+    # specific items in an order have been cancelled, meaning they 
+    # will not be delivered to the customer.
+    class CancelItemsCommand < ItemsCommand
+      
+      # The reason that you are canceling one or more line items
+      attr_accessor :reason
+      
+      # An optional comment related to one or more canceled line items
+      attr_accessor :comment
+      
+      def to_xml
+        CancelItemsCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The <return-items> command lets you specify that your customer
+    # returned one or more specific items in an order.
+    class ReturnItemsCommand < ItemsCommand
+      def to_xml
+        ReturnItemsCommandXmlGenerator.new(self).generate
+      end
+    end
+    
+    # The <reset-items-shipping-information> command allows you to reset
+    # the shipping status for specific items in an order to "Not yet shipped".
+    class ResetItemsShippingInformationCommand < ItemsCommand
+      def to_xml
+        ResetItemsShippingInformationCommandXmlGenerator.new(self).generate
       end
     end
   end

data/lib/google4r/checkout/frontend.rb

@@ -169,6 +169,36 @@ module Google4R #:nodoc:
       def create_unarchive_order_command
         return UnarchiveOrderCommand.new(self)
       end
+      
+      # Factory method to create a new ShipItemsCommand object. Use this method to create
+      # your ShipItemsCommand instances.
+      def create_ship_items_command
+        return ShipItemsCommand.new(self)
+      end
+      
+      # Factory method to create a new BackorderItemsCommand object. Use this method to create
+      # your BackorderItemsCommand instances.
+      def create_backorder_items_command
+        return BackorderItemsCommand.new(self)
+      end
+      
+      # Factory method to create a new ReturnItemsCommand object. Use this method to create
+      # your ReturnItemsCommand instances.
+      def create_return_items_command
+        return ReturnItemsCommand.new(self)
+      end
+      
+      # Factory method to create a new CancelItemsCommand object. Use this method to create
+      # your CancelItemsCommand instances.
+      def create_cancel_items_command
+        return CancelItemsCommand.new(self)
+      end
+      
+      # Factory method to create a new ResetItemsShippingInformationCommand object. Use this method to create
+      # your ResetItemsShippingInformationCommand instances.
+      def create_reset_items_shipping_information_command
+        return ResetItemsShippingInformationCommand.new(self)
+      end
     end
   end
 end

data/lib/google4r/checkout/merchant_calculation.rb

@@ -123,12 +123,16 @@ module Google4R #:nodoc:
       # An array of merchant codes
       attr_reader :merchant_code_strings
       
+      # The tax tables for the items in the order notification.
+      attr_reader :tax_tables
+      
       # Sets the frontend attribute to the value of the frontend parameter.
       def initialize(frontend)
         @frontend = frontend
         @anonymous_addresses = Array.new
         @shipping_methods = Array.new
         @merchant_code_strings = Array.new
+        @tax_tables = frontend.tax_table_factory.effective_tax_tables_at(Time.now)
       end
       
       # Factory method to create a new MerchantCalculationCallback object from 

data/lib/google4r/checkout/notifications.rb

@@ -35,17 +35,32 @@ module Google4R #:nodoc:
     class UnknownNotificationType < Exception
     end
     
-    # Use this objects of this class to tell Google that everything went fine.
+    # Represents a notification acknowledgment to tell Google that the 
+    # notification has been recieved and processed. Google guarantees not to
+    # resend any notification it has recieved an acknowledgment for.    
+    #  
+    # === For example, in a Rails app
     #
-    # === Example
+    #   # Let Google Checkout know we handled this notification with handshake
+    #   notification_acknowledgement = Google4R::Checkout::NotificationAcknowledgement.new(notification).to_xml
+    #   render :text => notification_acknowledgement, :status => 200
     #
-    #   render :text => NotificationAcknowledgement.to_xml
-    #--
-    # TODO: Should this become a Singleton?
-    #++
-    class NotificationAcknowledgement
+    #   or
+    #
+    #   # Without handshake
+    #   notification_acknowledgement = Google4R::Checkout::NotificationAcknowledgement.new.to_xml
+    #   render :text => notification_acknowledgement, :status => 200
+    #
+    class NotificationAcknowledgement      
+      
+      attr_reader :serial_number
+      
+      def initialize(notification=nil)
+        @serial_number = notification.serial_number unless notification.nil?
+      end
+      
       def to_xml
-        %q{<?xml version="1.0" encoding="UTF-8"?><notification-acknowledgment xmlns="http://checkout.google.com/schema/2"/>}
+        NotificationAcknowledgementXmlGenerator.new(self).generate
       end
     end
     
@@ -123,10 +138,9 @@ module Google4R #:nodoc:
       end
     end
     
-    # Google Checkout sends <new-order-notification> messages to the web service when a new
-    # order has been successfully filed with Google Checkout. These messages will be parsed
-    # into NewOrderNotification instances.
-    class NewOrderNotification
+    # Abstract class for all the notifications.  It should not be instantiated
+    # directly.
+    class Notification
       # The frontend this notification belongs to.
       attr_accessor :frontend
       
@@ -136,6 +150,21 @@ module Google4R #:nodoc:
       # The Google order number the new order notification belongs to (String).
       attr_accessor :google_order_number
       
+      # The timestamp of the notification. Also see #timestamp=
+      attr_accessor :timestamp
+      
+      # Initializes the RiskInformationNotification instance with the given Frontend instance.
+      def initialize(frontend)
+        @frontend = frontend
+      end
+      
+    end
+    
+    # Google Checkout sends <new-order-notification> messages to the web service when a new
+    # order has been successfully filed with Google Checkout. These messages will be parsed
+    # into NewOrderNotification instances.
+    class NewOrderNotification < Notification
+      
       # The buyer's billing address (Address).
       attr_accessor :buyer_billing_address
 
@@ -166,8 +195,8 @@ module Google4R #:nodoc:
       # The order's shopping cart (ShoppingCart)
       attr_accessor :shopping_cart
       
-      # The order's timestamp (Time), also see #timestamp=
-      attr_accessor :timestamp
+      # The tax tables for the items in the order notification.
+      attr_reader :tax_tables
       
       # Set the order's timestamp (Time). When the timestamp is set then the tax tables valid 
       # at the given point of time are set into the attribute tax tables from the frontend's
@@ -177,14 +206,6 @@ module Google4R #:nodoc:
         @tax_tables = frontend.tax_table_factory.effective_tax_tables_at(time)
       end
       
-      # The tax tables for the items in the order notification.
-      attr_reader :tax_tables
-      
-      # Sets the frontend attribute to the value of the frontend parameter.
-      def initialize(frontend)
-        @frontend = frontend
-      end
-      
       # Factory method to create a new CheckoutNotification object from the REXML:Element object
       #
       # Raises NoMethodError and RuntimeError exceptions if the given element misses required
@@ -216,15 +237,7 @@ module Google4R #:nodoc:
 
     # GoogleCheckout sends <order-change-notification> messages to the web service when the
     # order's state changes. They will get parsed into OrderStateChangeNotification objects.
-    class OrderStateChangeNotification
-      # The frontend this notification belongs to.
-      attr_accessor :frontend
-
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
+    class OrderStateChangeNotification < Notification
 
       # The previous financial state of the order (String, one of FinancialOrderState::*).
       attr_accessor :previous_financial_order_state
@@ -240,9 +253,9 @@ module Google4R #:nodoc:
 
       # The reason for the change (String, can be nil).
       attr_accessor :reason
-
-      # The timestamp of the notification. Also see #timestamp=
-      attr_accessor :timestamp
+        
+      # The tax tables for the items in the order notification.
+      attr_reader :tax_tables
 
       # Set the order's timestamp (Time). When the timestamp is set then the tax tables valid 
       # at the given point of time are set into the attribute tax tables from the frontend's
@@ -252,14 +265,6 @@ module Google4R #:nodoc:
         @tax_tables = frontend.tax_table_factory.effective_tax_tables_at(time)
       end
       
-      # The tax tables for the items in the order notification.
-      attr_reader :tax_tables
-      
-      # Sets the frontend attribute to the value of the frontend parameter.
-      def initialize(frontend)
-        @frontend = frontend
-      end
-      
       # Factory method that creates a new OrderStateChangeNotification from an REXML::Element instance.
       # Use this to create instances of OrderStateChangeNotification.
       #
@@ -283,16 +288,7 @@ module Google4R #:nodoc:
 
     # Google Checkout sends <charge-amount-notification> messages to the web service when the
     # to confirm that the charge was successfully executed.
-    class ChargeAmountNotification
-           
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
-
-      # The timestamp of the notification
-      attr_accessor :timestamp
+    class ChargeAmountNotification < Notification
       
       # The amount most recently charged for an order (Money)
       attr_accessor :latest_charge_amount
@@ -300,14 +296,6 @@ module Google4R #:nodoc:
       # The total amount charged for an order (Money)
       attr_accessor :total_charge_amount
 
-      # The Frontend instance for this Notification
-      attr_accessor :frontend
-      
-      # Initializes the ChargeAmountNotification instance with the given Frontend instance.
-      def initialize(frontend)
-        @frontend = frontend
-      end
-
       # Factory method that creates a new ChargeAmountNotification from an REXML::Element instance.
       # Use this to create instances of ChargeAmountNotification.
       #
@@ -336,15 +324,7 @@ module Google4R #:nodoc:
     # Google Checkout sends a <refund-amount-notification> after successfully executing 
     # a <refund-order> order processing command.  See the Google Checkout documentation for more details:
     # http://code.google.com/apis/checkout/developer/index.html#refund_amount_notification
-    class RefundAmountNotification
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
-
-      # The timestamp of the notification
-      attr_accessor :timestamp
+    class RefundAmountNotification < Notification
       
       # The amount most recently refunded for an order (Money)
       attr_accessor :latest_refund_amount
@@ -352,14 +332,6 @@ module Google4R #:nodoc:
       # The total amount refunded for an order (Money)
       attr_accessor :total_refund_amount
 
-      # The Frontend instance for this Notification
-      attr_accessor :frontend
-      
-      # Initializes the RefundAmountNotification instance with the given Frontend instance.
-      def initialize(frontend)
-        @frontend = frontend
-      end
-
       # Factory method that creates a new RefundAmountNotification from an REXML::Element instance.
       # Use this to create instances of RefundAmountNotification.
       #
@@ -389,15 +361,7 @@ module Google4R #:nodoc:
     # chargeback against the order and Google approves the chargeback.
     # See the Google Checkout documentation for more details:
     # http://code.google.com/apis/checkout/developer/index.html#chargeback_amount_notification
-    class ChargebackAmountNotification
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
-
-      # The timestamp of the notification
-      attr_accessor :timestamp
+    class ChargebackAmountNotification < Notification
       
       # The amount most recently charged back for an order (Money)
       attr_accessor :latest_chargeback_amount
@@ -405,14 +369,6 @@ module Google4R #:nodoc:
       # The total amount charged back for an order (Money)
       attr_accessor :total_chargeback_amount
 
-      # The Frontend instance for this Notification
-      attr_accessor :frontend
-      
-      # Initializes the ChargebackAmountNotification instance with the given Frontend instance.
-      def initialize(frontend)
-        @frontend = frontend
-      end
-
       # Factory method that creates a new ChargebackAmountNotification from an REXML::Element instance.
       # Use this to create instances of ChargebackAmountNotification.
       #
@@ -442,15 +398,7 @@ module Google4R #:nodoc:
     # request for an explicit credit card reauthorization.
     # See the Google Checkout documentation for more details:
     # http://code.google.com/apis/checkout/developer/index.html#authorization_amount_notification
-    class AuthorizationAmountNotification
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
-
-      # The timestamp of the notification
-      attr_accessor :timestamp
+    class AuthorizationAmountNotification < Notification
       
       # The amount that is reauthorized to be charged to the customer's credit card (Money)
       attr_accessor :authorization_amount
@@ -463,14 +411,6 @@ module Google4R #:nodoc:
       
       # Credit verification value for the order (String)
       attr_accessor :cvn_response
-      
-      # The Frontend instance for this Notification
-      attr_accessor :frontend
-      
-      # Initializes the AuthorizationAmountNotification instance with the given Frontend instance.
-      def initialize(frontend)
-        @frontend = frontend
-      end
 
       # Factory method that creates a new AuthorizationAmountNotification from an REXML::Element instance.
       # Use this to create instances of AuthorizationAmountNotification.
@@ -501,12 +441,7 @@ module Google4R #:nodoc:
     # Google Checkout sends out <risk-information-notification> messages for fraud detection
     # related information. See the Google Checkout documentation for more details:
     # http://code.google.com/apis/checkout/developer/index.html#risk_information_notification
-    class RiskInformationNotification
-      # The serial number of the notification (String).
-      attr_accessor :serial_number
-
-      # The order number in Google's database (String).
-      attr_accessor :google_order_number
+    class RiskInformationNotification < Notification
 
       # Is the order eligible for Google Checkout's payment guarantee policy (boolean).
       attr_accessor :eligible_for_protection
@@ -527,18 +462,7 @@ module Google4R #:nodoc:
       attr_accessor :ip_address
 
       # The age of the buyer's google checkout account in days
-      attr_accessor :buyer_account_age
-
-      # The timestamp of the notification
-      attr_accessor :timestamp
-      
-      # The Frontend instance for this Notification
-      attr_accessor :frontend
-      
-      # Initializes the RiskInformationNotification instance with the given Frontend instance.
-      def initialize(frontend)
-        @frontend = frontend
-      end
+      attr_accessor :buyer_account_age      
 
       # Factory method that creates a new RiskInformationNotification from an REXML::Element instance.
       # Use this to create instances of RiskInformationNotification