Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

/var/sites/help-site.com/auto/tmp/CPAN/9677/Google-Checkout-1.1.1/lib/Google/Checkout/Notification/NewOrder.pm

/var/sites/help-site.com/auto/tmp/CPAN/9677/Google-Checkout-1.1.1/lib/Google/Checkout/Notification/NewOrder.pm


NAME

Google::Checkout::Notification::NewOrder


SYNOPSIS


  use Google::Checkout::General::GCO;

  use Google::Checkout::Notification::NewOrder;

  use Google::Checkout::General::Util qw/is_gco_error/;

  my $xml = "/xml/new_order_notification.xml";

  #--

  #-- $xml can either be a file or a complete XML doc string

  #--

  my $new_order = Google::Checkout::Notification::NewOrder->new(xml => $xml);

  die $new_order if is_gco_error $new_order;

  my $items = $new_order->get_items();

  for my $item (@$items)

  {

    print $item->get_merchant_item_id,"\n",

          $item->get_name,"\n",

          $item->get_description,"\n",

          $item->get_price,"\n",

          $item->get_quantity,"\n";

  }


DESCRIPTION

Sub-class of Google::Checkout::Notification::GCONotification. When a new order notification is received, this module can be used to extract various information about the new order.

new XML => ...
Constructor. Takes either a XML file or XML doc as data string. If the XML is invalid (syntax error for example), Google::Checkout::General::Error is returned.

type
Always return Google::Checkout::XML::Constants::NEW_ORDER_NOTIFICATION.

get_order_total
Returns the total of the order.

get_buyer_id
Returns the buyer ID.

get_fulfillment_state
Returns the fulfillment state. Since this is a new order, this will most likely be 'NEW'.

get_financial_state
Returns the financial state. Since this is a new order, this will most likely be 'REVIEWING'.

marketing_email_allowed
Returns the string 'true' if marketing email is allowed. Otherwise, returns the string 'false'.

get_buyer_info SHIPPING_OR_BILLING, WHICH_DATA
Returns various buyer info. SHIPPING_OR_BILLING can either be Google::Checkout::XML::Constants::GET_SHIPPING or Google::Checkout::XML::Constants::GET_BILLING to get buyer's shipping or billing data respectively. WHICH_DATA can be Google::Checkout::XML::Constants::BUYER_CONTACT_NAME, Google::Checkout::XML::Constants::BUYER_COMPANY_NAME, Google::Checkout::XML::Constants::BUYER_EMAIL, Google::Checkout::XML::Constants::BUYER_PHONE, Google::Checkout::XML::Constants::BUYER_FAX, Google::Checkout::XML::Constants::BUYER_ADDRESS1, Google::Checkout::XML::Constants::BUYER_ADDRESS2, Google::Checkout::XML::Constants::BUYER_CITY, Google::Checkout::XML::Constants::BUYER_REGION, Google::Checkout::XML::Constants::BUYER_POSTAL_CODE, Google::Checkout::XML::Constants::BUYER_COUNTRY_CODE.

merchant_calculation_successful
Returns the string 'true' is merchant calculation is successful. Returns the string 'false' otherwise.

get_total_tax
Returns the total tax applied to the new order.

get_adjustment_total
Returns the adjustment total.

get_gift_certificate_calculated_amount
Returns the gift certificate calculated amount.

get_gift_certificate_applied_amount
Returns the amount actually applied from using the gift certificate.

get_gift_certificate_code
Returns the gift certificate code.

get_gift_certificate_pin
Returns the gift certificate PIN.

get_gift_certificate_message
Returns the gift certificate message.

get_coupon_calculated_amount
Returns the coupon calculated amount.

get_coupon_applied_amount
Returns the amount actually applied from using the coupon.

get_coupon_code
Returns the coupon code.

get_coupon_message
Returns the coupon message.

get_shipping_method
Returns the shipping method. If no shipping method is found, returns Google::Checkout::General::Error instead.

get_shipping_name
Returns the shipping name.

get_shipping_cost
Returns the shipping cost.

get_cart_expiration
Returns the expiration date of the shopping cart.

get_merchant_private_data
Returns the merchant private data.

get_items
Returns all items in the order. The items are returned as an array reference with each element a Google::Checkout::General::MerchantItem object.


COPYRIGHT

Copyright 2006 Google. All rights reserved.


SEE ALSO

Google::Checkout::Notification::GCONotification

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy