bws 0.2.1.pre

data/lib/bws/checkout.rb

@@ -0,0 +1,30 @@
+class BWS::Checkout < BWS::Response
+  def result
+    base.nil?
+  end
+
+  def price_order
+    base['checkout_price_order']
+  end
+
+  def validate_credit_card
+    base['checkout_validate_credit_card']
+  end
+
+  def create_order
+    base['checkout_create_order']
+  end
+
+  def single_post_create_order
+    base['checkout_single_post_create_order']
+  end
+
+  def create_store_order
+    base['checkout_create_store_order']
+  end
+
+  private
+  def base
+    response.parsed_response['envelope']['body']
+  end
+end

data/lib/bws/client.rb

@@ -0,0 +1,807 @@
+require 'rubygems'
+require 'httparty'
+require 'builder'
+
+module BWS
+  class Client
+    include HTTParty
+
+    format :xml
+    headers 'Content-Type' => 'application/xml'
+
+    attr_reader :api_key, :base_uri, :timeout
+
+    class MissingApiKey < StandardError;
+    end
+    class BadParams < StandardError;
+    end
+
+    def initialize(api_key = nil, base_uri = 'https://bws.bookrenter.com/v1', options = {})
+      raise MissingApiKey if api_key.nil?
+      @api_key = api_key
+      @base_uri = base_uri
+      @timeout = options[:timeout] || 5
+    end
+
+    def unacknowledged_orders(page = 1)
+      BWS::UnacknowledgedOrders.new(get("/distributor_orders/unacknowledged.xml?page=#{page}"))
+    end
+
+    def fillable_orders(page = 1)
+      BWS::FillableOrders.new(get("/distributor_orders/fillable.xml?page=#{page}"))
+    end
+
+    def order(public_id = nil)
+      raise BadParams unless public_id
+      BWS::Order.new(get("/distributor_orders/#{public_id}.xml"))
+    end
+
+    def acknowledge_order(order_hash = nil)
+      raise BadParams unless order_hash
+      public_id = order_hash['public_id']
+
+      line_items = order_hash['distributor_line_items']['distributor_line_item']
+      line_items = [line_items] unless line_items.is_a?(Array)
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.distributor_orders_acknowledge do
+            xml.distributor_order do
+              xml.public_id order_hash['public_id']
+              xml.distributor_identifier order_hash['distributor_identifier'] if order_hash['distributor_identifier']
+              xml.distributor_line_items do
+                line_items.each do |li_hash|
+                  xml.distributor_line_item do
+                    xml.public_id li_hash['public_id']
+                    xml.estimated_ship_date li_hash['estimated_ship_date'] if li_hash['estimated_ship_date']
+                    xml.distributor_identifier li_hash['distributor_identifier'] if li_hash['distributor_identifier']
+                    xml.status li_hash['status']
+                    xml.reject_reason li_hash['reject_reason'] if li_hash['reject_reason']
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+      BWS::AcknowledgeOrder.new(post("/distributor_orders/#{public_id}/acknowledge.xml", xml_target))
+    end
+
+    def create_shipment(shipment_hash = nil)
+      raise BadParams unless shipment_hash
+      public_id = shipment_hash['public_id']
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.distributor_outbound_shipments_create do
+            xml.distributor_outbound_shipment do
+              xml.estimated_delivery_date shipment_hash['estimated_delivery_date'] if shipment_hash['estimated_delivery_date']
+              xml.shipping_method shipment_hash['shipping_method']
+              xml.shipped_at shipment_hash['shipped_at'] if shipment_hash['shipped_at']
+              xml.cost_cents shipment_hash['cost_cents'] if shipment_hash['cost_cents']
+              xml.carrier shipment_hash['carrier']
+              xml.tracking_number shipment_hash['tracking_number'] if shipment_hash['tracking_number']
+              xml.distributor_line_items do
+                shipment_hash['distributor_line_items'].each do |dli|
+                  xml.distributor_line_item do
+                    xml.public_id dli['public_id']
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+      BWS::CreateShipment.new(post("/distributor_orders/#{public_id}/distributor_outbound_shipments.xml", xml_target))
+    end
+
+    def reject_line_item(reject_hash = nil)
+      raise BadParams unless reject_hash
+      public_id = reject_hash['public_id']
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.distributor_line_items_reject do
+            xml.distributor_line_item do
+              xml.public_id reject_hash['public_id']
+              xml.status 'rejected'
+              xml.reject_reason reject_hash['reject_reason']
+            end
+          end
+        end
+      end
+      BWS::RejectLineItem.new(post("/distributor_line_items/#{public_id}/reject.xml", xml_target))
+    end
+
+    #
+    # Retrieves multiple book with pricing and available rental terms. Books requested that are out-of-stock will be returned with a quantity zero, and no prices. The two main scenarios for the use of this API are:
+    #
+    # 1) retrieving inventory information on a specific set of books
+    # 2) retrieving inventory changes for all books (Delta result set)
+    # Parameters:
+    #   isbns - (optional) A list of comma separated ISBN13's for the book requesting inventory. If this parameter is not include, all books will be returned
+    #   segment - (optional) Your inventory specific segmentation. If your inventory is segmented, this may affect the price and rental periods available.
+    #   page - (optional) The page number to request. Page numbers start at 1.
+    #   per_page - (optional) The number of results per page. The maximum number of books per page is 100. This is also the default.
+    #   delta_range_start_date - (optional) This date range limits the result set to inventory_books that were last modified within the given time period. The delta_range_start_date is included in the date range. Delta result records will represent out of stock inventory with quantities of zero. All date formats must be based on the RFC3339 profile of ISO8601.
+    #   delta_range_end_date - (optional) End date for the delta result set being requested. If this element is omitted, the current date/time will be used. The delta_range_end_date is excluded in the date range.
+    #   in_store - (optional) Defaults to false. Set to true to get rental prices for in-store inventory. Set to false to get online prices from BookRenter.com.
+    #
+    def retrieve_inventory(isbns = nil, segment = nil, page = nil, per_page = nil, delta_range_start_date = nil, delta_range_end_date = nil, in_store = nil)
+
+      service_url = ""
+
+      if (isbns.present? && isbns.length > 0)
+        service_url << "isbns=" << isbns.join(',') << '&'
+      end
+
+      if (segment.present?)
+        service_url << "segment=" << segment << "&"
+      end
+
+      if (page.present?)
+        service_url << "page=" << page << "&"
+      end
+
+      if (per_page.present?)
+        service_url << "per_page=" << per_page << "&"
+      end
+
+      if (delta_range_start_date.present?)
+        service_url << "delta_range_start_date=" << delta_range_start_date << "&"
+      end
+
+      if (delta_range_end_date.present?)
+        service_url << "delta_range_end_date=" << delta_range_end_date << "&"
+      end
+
+      if (in_store.present?)
+        service_url << "in_store=#{in_store}&"
+      end
+
+      url = '/inventory_books.xml'
+      if (service_url != "")
+        service_url = service_url[0..-2]
+        url = "/inventory_books.xml?#{service_url}"
+      end
+
+      BWS::Inventory.new(get(url))
+    end
+
+    #
+    # Retrieves a single book with pricing and available rental terms.
+    #
+    # Parameters:
+    #   BOOK_ISBN_13 - The ISBN13 for the book requesting inventory.
+    #   segment - (optional) Your inventory specific segmentation. If your inventory is segmented, this may affect the price and periods available.
+    #   in_store - (optional) Defaults to false. Set to true to get rental prices for in-store inventory. Set to false to prices for online offers fulfilled by BookRenter.
+    #
+    def retrieve_inventory_by_isbn(isbn = nil, segment = nil, in_store = nil)
+      raise BadParams unless isbn
+
+      service_url = ""
+
+      if (segment.present?)
+        service_url << "segment=" << segment << "&"
+      end
+
+      if (in_store.present?)
+        service_url << "in_store=#{in_store}&"
+      end
+
+      url = "/inventory_books/#{isbn}.xml"
+      if (service_url != "")
+        service_url = service_url[0..-2]
+        url = "/inventory_books/#{isbn}.xml?#{service_url}"
+      end
+
+      BWS::Inventory.new(get(url))
+    end
+
+    #
+    # Retrieves order events for for a specified time period.
+    #
+    # Parameters:
+    #   start_time - (optional) The start time of events to retrieve. If not specified, starts at first event.
+    #   end_time - (optional) The start time of events to retrieve. If not specified, starts at first event.
+    #   types	- (optional) Include only the types of events specified. If not specified, all events are included. Valid events types are order_created, order_charged, order_frozen_for_fraud_check, order_failed_fraud_check, line_item_cancelled, line_item_shipment_to_customer_created, line_item_replaced, line_item_refunded, line_item_extended, line_item_purchased, line_item_shipment_to_receiving_facility_created, line_item_checked_in.
+    #   page - (optional) The page number to request. Page numbers start at 1.
+    #   per_page	- (optional) The number of results per page. The maximum number of events per page is 25. This is also the default.
+    #
+    def retrieve_order_events(types = nil, start_time = nil, end_time = nil, page = nil, per_page = nil)
+
+      service_url = ""
+
+      if (start_time)
+        service_url << "start_time=" << start_time << "&"
+      end
+
+      if (end_time)
+        service_url << "end_time=" << end_time << "&"
+      end
+
+      if (types && types.length > 0)
+        service_url << "types=" << types.join(',') << '&'
+      end
+
+      if (page)
+        service_url << "page=" << page << "&"
+      end
+
+      if (per_page)
+        service_url << "per_page=" << per_page << "&"
+      end
+
+      url = '/order_events.xml'
+      if (service_url != "")
+        service_url = service_url[0..-2]
+        url = "/order_events.xml?#{service_url}"
+      end
+
+      BWS::OrderEvents.new(get(url))
+    end
+
+    #
+    # Retrieves all events for a specific order.
+    #
+    # Parameters:
+    #   BR-ORDER-ID - The Bookrenter Order ID.
+    #   types	- (optional) Include only the types of events specified. If not specified, all events are included. Valid events types are order_created, order_charged, order_frozen_for_fraud_check, order_failed_fraud_check, line_item_cancelled, line_item_shipment_to_customer_created, line_item_replaced, line_item_refunded, line_item_extended, line_item_purchased, line_item_shipment_to_receiving_facility_created, line_item_checked_in.
+    #
+    def retrieve_order_events_by_order(types = nil, br_order_id = nil)
+      raise BadParams unless br_order_id
+
+      service_url = ""
+
+      if (types && types.length > 0)
+        service_url << "types=" << types.join(',') << '&'
+      end
+
+      url = "/order_events/#{br_order_id}.xml"
+      if (service_url != "")
+        service_url = service_url[0..-2]
+        url = "/order_events/#{br_order_id}.xml?#{service_url}"
+      end
+
+      BWS::OrderEvents.new(get(url))
+    end
+
+    #
+    # View a customer's order data on BookRenter. This service displays most order information necessary to gather status and shipment detail for a given order.
+    #
+    # Parameters:
+    #   public_id* - (optional) BookRenter's unique identifier for this order
+    #   external_order_id*	- (optional) Partner's unique identifier for this order
+    #
+    #   * either BookRenter public_id or Partner external_order_id must be provided in the url.
+    #
+    #   order_id can receive public_id or external_order_id
+    #
+    def retrieve_orders_show(order_id = nil)
+      raise BadParams unless order_id
+
+      url = "/orders/#{order_id}.xml"
+
+      BWS::Orders.new(get(url))
+    end
+
+    #
+    # The first step of order checkout. From a user's phone number, product list, shipping information, billing information, gets the product price, subtotal, subtotal tax, and available shipping options. Shipping options include price and tax information for each available shipping method.
+    #
+    # Note: If customer, billing address, shipping address or products changes, you will need to re-price the order.
+    #
+    def checkout_price_order(checkout_price_order_hash = nil)
+      raise BadParams unless checkout_price_order_hash
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.checkout_price_order do
+            if checkout_price_order_hash['customer']
+              xml.customer do
+                xml.email checkout_price_order_hash['customer']['email'] if checkout_price_order_hash['customer']['email']
+                xml.external_user_id checkout_price_order_hash['customer']['external_user_id'] if checkout_price_order_hash['customer']['external_user_id']
+                xml.mobile_phone_number checkout_price_order_hash['customer']['mobile_phone_number'] if checkout_price_order_hash['customer']['mobile_phone_number']
+              end
+            end
+            if checkout_price_order_hash['product_list']
+              xml.product_list do
+                xml.segment checkout_price_order_hash['product_list']['segment'] if checkout_price_order_hash['product_list']['segment']
+                if checkout_price_order_hash['product_list']['products']
+                  xml.products do
+                    if checkout_price_order_hash['product_list']['products']['product'].class == Array
+                      checkout_price_order_hash['product_list']['products']['product'].each do |product|
+                        xml.product do
+                          xml.product_id product['product_id'] if product['product_id']
+                          xml.product_type product['product_type'] if product['product_type']
+                          xml.quantity product['quantity'] if product['quantity']
+                          xml.rental_period product['rental_period'] if product['rental_period']
+                        end
+                      end
+                    else
+                      product = checkout_price_order_hash['product_list']['products']['product']
+                      xml.product do
+                        xml.product_id product['product_id'] if product['product_id']
+                        xml.product_type product['product_type'] if product['product_type']
+                        xml.quantity product['quantity'] if product['quantity']
+                        xml.rental_period product['rental_period'] if product['rental_period']
+                      end
+                    end
+                  end
+                end
+              end
+            end
+            if checkout_price_order_hash['billing_address']
+              xml.billing_address do
+                xml.first_name checkout_price_order_hash['billing_address']['first_name'] if checkout_price_order_hash['billing_address']['first_name']
+                xml.last_name checkout_price_order_hash['billing_address']['last_name'] if checkout_price_order_hash['billing_address']['last_name']
+                xml.street_address checkout_price_order_hash['billing_address']['street_address'] if checkout_price_order_hash['billing_address']['street_address']
+                xml.street_address_2 checkout_price_order_hash['billing_address']['street_address_2'] if checkout_price_order_hash['billing_address']['street_address_2']
+                xml.city checkout_price_order_hash['billing_address']['city'] if checkout_price_order_hash['billing_address']['city']
+                xml.state checkout_price_order_hash['billing_address']['state'] if checkout_price_order_hash['billing_address']['state']
+                xml.zip checkout_price_order_hash['billing_address']['zip'] if checkout_price_order_hash['billing_address']['zip']
+                xml.country checkout_price_order_hash['billing_address']['country'] if checkout_price_order_hash['billing_address']['country']
+              end
+            end
+
+            if checkout_price_order_hash['shipping_address']
+              xml.shipping_address do
+                xml.first_name checkout_price_order_hash['shipping_address']['first_name'] if checkout_price_order_hash['shipping_address']['first_name']
+                xml.last_name checkout_price_order_hash['shipping_address']['last_name'] if checkout_price_order_hash['shipping_address']['last_name']
+                xml.street_address checkout_price_order_hash['shipping_address']['street_address'] if checkout_price_order_hash['shipping_address']['street_address']
+                xml.street_address_2 checkout_price_order_hash['shipping_address']['street_address_2'] if checkout_price_order_hash['shipping_address']['street_address_2']
+                xml.city checkout_price_order_hash['shipping_address']['city'] if checkout_price_order_hash['shipping_address']['city']
+                xml.state checkout_price_order_hash['shipping_address']['state'] if checkout_price_order_hash['shipping_address']['state']
+                xml.zip checkout_price_order_hash['shipping_address']['zip'] if checkout_price_order_hash['shipping_address']['zip']
+                xml.country checkout_price_order_hash['shipping_address']['country'] if checkout_price_order_hash['shipping_address']['country']
+              end
+            end
+          end
+        end
+      end
+      BWS::Checkout.new(post("/checkout/price_order.xml", xml_target))
+    end
+
+    #
+    # The second step of order checkout. Ensures that the credit card is valid. Renting books requires that the card expiration extend beyond the date of the latest return date for the books being rented.
+    #
+    # Note: If billing address or products changes, you will need to re-validate the credit card information.
+    #
+    def checkout_validate_credit_card(checkout_validate_credit_card_hash = nil)
+      raise BadParams unless checkout_validate_credit_card_hash
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.checkout_validate_credit_card do
+            xml.checkout_verification_code checkout_validate_credit_card_hash['checkout_verification_code'] if checkout_validate_credit_card_hash['checkout_verification_code']
+            if checkout_validate_credit_card_hash['product_list']
+              xml.product_list do
+                xml.product_list_verification_code checkout_validate_credit_card_hash['product_list']['product_list_verification_code'] if checkout_validate_credit_card_hash['product_list']['product_list_verification_code']
+                xml.segment checkout_validate_credit_card_hash['product_list']['segment'] if checkout_validate_credit_card_hash['product_list']['segment']
+                if checkout_validate_credit_card_hash['product_list']['products']
+                  xml.products do
+                    if checkout_validate_credit_card_hash['product_list']['products']['product'].class == Array
+                      checkout_validate_credit_card_hash['product_list']['products']['product'].each do |product|
+                        xml.product do
+                          xml.product_id product['product_id'] if product['product_id']
+                          xml.product_type product['product_type'] if product['product_type']
+                          xml.quantity product['quantity'] if product['quantity']
+                          xml.rental_period product['rental_period'] if product['rental_period']
+                        end
+                      end
+                    else
+                      product = checkout_validate_credit_card_hash['product_list']['products']['product']
+                      xml.product do
+                        xml.product_id product['product_id'] if product['product_id']
+                        xml.product_type product['product_type'] if product['product_type']
+                        xml.quantity product['quantity'] if product['quantity']
+                        xml.rental_period product['rental_period'] if product['rental_period']
+                      end
+                    end
+                  end
+                end
+              end
+            end
+            if checkout_validate_credit_card_hash['billing_address']
+              xml.billing_address do
+                xml.billing_address_verification_code checkout_validate_credit_card_hash['billing_address']['billing_address_verification_code'] if checkout_validate_credit_card_hash['billing_address']['billing_address_verification_code']
+                xml.first_name checkout_validate_credit_card_hash['billing_address']['first_name'] if checkout_validate_credit_card_hash['billing_address']['first_name']
+                xml.last_name checkout_validate_credit_card_hash['billing_address']['last_name'] if checkout_validate_credit_card_hash['billing_address']['last_name']
+                xml.street_address checkout_validate_credit_card_hash['billing_address']['street_address'] if checkout_validate_credit_card_hash['billing_address']['street_address']
+                xml.street_address_2 checkout_validate_credit_card_hash['billing_address']['street_address_2'] if checkout_validate_credit_card_hash['billing_address']['street_address_2']
+                xml.city checkout_validate_credit_card_hash['billing_address']['city'] if checkout_validate_credit_card_hash['billing_address']['city']
+                xml.state checkout_validate_credit_card_hash['billing_address']['state'] if checkout_validate_credit_card_hash['billing_address']['state']
+                xml.zip checkout_validate_credit_card_hash['billing_address']['zip'] if checkout_validate_credit_card_hash['billing_address']['zip']
+                xml.country checkout_validate_credit_card_hash['billing_address']['country'] if checkout_validate_credit_card_hash['billing_address']['country']
+              end
+            end
+
+            if checkout_validate_credit_card_hash['credit_card']
+              xml.credit_card do
+                xml.number checkout_validate_credit_card_hash['credit_card']['number'] if checkout_validate_credit_card_hash['credit_card']['number']
+                xml.month checkout_validate_credit_card_hash['credit_card']['month'] if checkout_validate_credit_card_hash['credit_card']['month']
+                xml.year checkout_validate_credit_card_hash['credit_card']['year'] if checkout_validate_credit_card_hash['credit_card']['year']
+                xml.verification_value checkout_validate_credit_card_hash['credit_card']['verification_value'] if checkout_validate_credit_card_hash['credit_card']['verification_value']
+                xml.type checkout_validate_credit_card_hash['credit_card']['type'] if checkout_validate_credit_card_hash['credit_card']['type']
+              end
+            end
+          end
+        end
+      end
+      BWS::Checkout.new(post("/checkout/validate_credit_card.xml", xml_target))
+    end
+
+    #
+    # The second step of order checkout. Ensures that the credit card is valid. Renting books requires that the card expiration extend beyond the date of the latest return date for the books being rented.
+    #
+    # Note: If billing address or products changes, you will need to re-validate the credit card information.
+    #
+    def checkout_create_order(checkout_create_order_hash = nil)
+      raise BadParams unless checkout_create_order_hash
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.checkout_create_order do
+            xml.checkout_verification_code checkout_create_order_hash['checkout_verification_code'] if checkout_create_order_hash['checkout_verification_code']
+            xml.charge_amount_cents checkout_create_order_hash['charge_amount_cents'] if checkout_create_order_hash['charge_amount_cents']
+            xml.external_order_id checkout_create_order_hash['external_order_id'] if checkout_create_order_hash['external_order_id']
+            if checkout_create_order_hash['customer']
+              xml.customer do
+                xml.customer_verification_code checkout_create_order_hash['customer']['customer_verification_code'] if checkout_create_order_hash['customer']['customer_verification_code']
+                xml.email checkout_create_order_hash['customer']['email'] if checkout_create_order_hash['customer']['email']
+                xml.external_user_id checkout_create_order_hash['customer']['external_user_id'] if checkout_create_order_hash['customer']['external_user_id']
+                xml.mobile_phone_number checkout_create_order_hash['customer']['mobile_phone_number'] if checkout_create_order_hash['customer']['mobile_phone_number']
+              end
+            end
+            if checkout_create_order_hash['product_list']
+              xml.product_list do
+                xml.product_list_verification_code checkout_create_order_hash['product_list']['product_list_verification_code'] if checkout_create_order_hash['product_list']['product_list_verification_code']
+                xml.segment checkout_create_order_hash['product_list']['segment'] if checkout_create_order_hash['product_list']['segment']
+                if checkout_create_order_hash['product_list']['products']
+                  xml.products do
+                    if checkout_create_order_hash['product_list']['products']['product'].class == Array
+                      checkout_create_order_hash['product_list']['products']['product'].each do |product|
+                        xml.product do
+                          xml.product_id product['product_id'] if product['product_id']
+                          xml.product_type product['product_type'] if product['product_type']
+                          xml.quantity product['quantity'] if product['quantity']
+                          xml.rental_due_date product['rental_due_date'] if product['rental_due_date']
+                          xml.rental_period product['rental_period'] if product['rental_period']
+                          if product['external_line_item_ids']
+                            xml.external_line_item_ids do
+                              if product['external_line_item_ids']['external_line_item_id'].class == Array
+                                product['external_line_item_ids']['external_line_item_id'].each do |external_line_item_id|
+                                  xml.external_line_item_id external_line_item_id
+                                end
+                              else
+                                external_line_item_id = product['external_line_item_ids']['external_line_item_id']
+                                xml.external_line_item_id external_line_item_id
+                              end
+                            end
+                          end
+                        end
+                      end
+                    else
+                      product = checkout_create_order_hash['product_list']['products']['product']
+                      xml.product do
+                        xml.product_id product['product_id'] if product['product_id']
+                        xml.product_type product['product_type'] if product['product_type']
+                        xml.quantity product['quantity'] if product['quantity']
+                        xml.rental_due_date product['rental_due_date'] if product['rental_due_date']
+                        xml.rental_period product['rental_period'] if product['rental_period']
+                        if product['external_line_item_ids']
+                          xml.external_line_item_ids do
+                            if product['external_line_item_ids']['external_line_item_id'].class == Array
+                              product['external_line_item_ids']['external_line_item_id'].each do |external_line_item_id|
+                                xml.external_line_item_id external_line_item_id
+                              end
+                            else
+                              external_line_item_id = product['external_line_item_ids']['external_line_item_id']
+                              xml.external_line_item_id external_line_item_id
+                            end
+                          end
+                        end
+                      end
+                    end
+                  end
+                end
+              end
+            end
+            if checkout_create_order_hash['billing_address']
+              xml.billing_address do
+                xml.billing_address_verification_code checkout_create_order_hash['billing_address']['billing_address_verification_code'] if checkout_create_order_hash['billing_address']['billing_address_verification_code']
+                xml.first_name checkout_create_order_hash['billing_address']['first_name'] if checkout_create_order_hash['billing_address']['first_name']
+                xml.last_name checkout_create_order_hash['billing_address']['last_name'] if checkout_create_order_hash['billing_address']['last_name']
+                xml.street_address checkout_create_order_hash['billing_address']['street_address'] if checkout_create_order_hash['billing_address']['street_address']
+                xml.street_address_2 checkout_create_order_hash['billing_address']['street_address_2'] if checkout_create_order_hash['billing_address']['street_address_2']
+                xml.city checkout_create_order_hash['billing_address']['city'] if checkout_create_order_hash['billing_address']['city']
+                xml.state checkout_create_order_hash['billing_address']['state'] if checkout_create_order_hash['billing_address']['state']
+                xml.zip checkout_create_order_hash['billing_address']['zip'] if checkout_create_order_hash['billing_address']['zip']
+                xml.country checkout_create_order_hash['billing_address']['country'] if checkout_create_order_hash['billing_address']['country']
+              end
+            end
+
+            if checkout_create_order_hash['shipping_address']
+              xml.shipping_address do
+                xml.shipping_address_verification_code checkout_create_order_hash['shipping_address']['shipping_address_verification_code'] if checkout_create_order_hash['shipping_address']['shipping_address_verification_code']
+                xml.first_name checkout_create_order_hash['shipping_address']['first_name'] if checkout_create_order_hash['shipping_address']['first_name']
+                xml.last_name checkout_create_order_hash['shipping_address']['last_name'] if checkout_create_order_hash['shipping_address']['last_name']
+                xml.street_address checkout_create_order_hash['shipping_address']['street_address'] if checkout_create_order_hash['shipping_address']['street_address']
+                xml.street_address_2 checkout_create_order_hash['shipping_address']['street_address_2'] if checkout_create_order_hash['shipping_address']['street_address_2']
+                xml.city checkout_create_order_hash['shipping_address']['city'] if checkout_create_order_hash['shipping_address']['city']
+                xml.state checkout_create_order_hash['shipping_address']['state'] if checkout_create_order_hash['shipping_address']['state']
+                xml.zip checkout_create_order_hash['shipping_address']['zip'] if checkout_create_order_hash['shipping_address']['zip']
+                xml.country checkout_create_order_hash['shipping_address']['country'] if checkout_create_order_hash['shipping_address']['country']
+              end
+            end
+
+            if checkout_create_order_hash['credit_card']
+              xml.credit_card do
+                xml.credit_card_verification_code checkout_create_order_hash['credit_card']['credit_card_verification_code'] if checkout_create_order_hash['credit_card']['credit_card_verification_code']
+                xml.number checkout_create_order_hash['credit_card']['number'] if checkout_create_order_hash['credit_card']['number']
+                xml.month checkout_create_order_hash['credit_card']['month'] if checkout_create_order_hash['credit_card']['month']
+                xml.year checkout_create_order_hash['credit_card']['year'] if checkout_create_order_hash['credit_card']['year']
+                xml.verification_value checkout_create_order_hash['credit_card']['verification_value'] if checkout_create_order_hash['credit_card']['verification_value']
+                xml.type checkout_create_order_hash['credit_card']['type'] if checkout_create_order_hash['credit_card']['type']
+              end
+            end
+
+            if checkout_create_order_hash['shipping_option']
+              xml.shipping_option do
+                xml.shipping_option_verification_code checkout_create_order_hash['shipping_option']['shipping_option_verification_code'] if checkout_create_order_hash['shipping_option']['shipping_option_verification_code']
+                xml.method_name checkout_create_order_hash['shipping_option']['method_name'] if checkout_create_order_hash['shipping_option']['method_name']
+              end
+            end
+          end
+        end
+      end
+      BWS::Checkout.new(post("/checkout/create_order.xml", xml_target))
+    end
+
+    #
+    # Creates an order from the information provided in the Request Body. Used as an alternative to the 3 step create order process. It can be utilized when all required information is available on the partner site at request time
+    #
+    # Note: All input data will be validated prior to order creation. See Errors section for details on possible failed validation responses.
+    #
+    def checkout_single_post_create_order(checkout_single_post_create_order_hash = nil)
+      raise BadParams unless checkout_single_post_create_order_hash
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.checkout_single_post_create_order do
+            xml.date_ordered checkout_single_post_create_order_hash['date_ordered'] if checkout_single_post_create_order_hash['date_ordered']
+            xml.charge_amount_cents checkout_single_post_create_order_hash['charge_amount_cents'] if checkout_single_post_create_order_hash['charge_amount_cents']
+            xml.external_order_id checkout_single_post_create_order_hash['external_order_id'] if checkout_single_post_create_order_hash['external_order_id']
+            if checkout_single_post_create_order_hash['customer']
+              xml.customer do
+                xml.customer_verification_code checkout_single_post_create_order_hash['customer']['customer_verification_code'] if checkout_single_post_create_order_hash['customer']['customer_verification_code']
+                xml.email checkout_single_post_create_order_hash['customer']['email'] if checkout_single_post_create_order_hash['customer']['email']
+                xml.external_user_id checkout_single_post_create_order_hash['customer']['external_user_id'] if checkout_single_post_create_order_hash['customer']['external_user_id']
+                xml.mobile_phone_number checkout_single_post_create_order_hash['customer']['mobile_phone_number'] if checkout_single_post_create_order_hash['customer']['mobile_phone_number']
+              end
+            end
+            if checkout_single_post_create_order_hash['product_list']
+              xml.product_list do
+                xml.subtotal_cents checkout_single_post_create_order_hash['product_list']['subtotal_cents'] if checkout_single_post_create_order_hash['product_list']['subtotal_cents']
+                xml.subtotal_tax_cents checkout_single_post_create_order_hash['product_list']['subtotal_tax_cents'] if checkout_single_post_create_order_hash['product_list']['subtotal_tax_cents']
+
+                if checkout_single_post_create_order_hash['product_list']['products']
+                  xml.products do
+
+                    xml.segment checkout_single_post_create_order_hash['product_list']['products']['segment'] if checkout_single_post_create_order_hash['product_list']['products']['segment']
+                    if checkout_single_post_create_order_hash['product_list']['products']['product'].class == Array
+                      checkout_single_post_create_order_hash['product_list']['products']['product'].each do |product|
+                        xml.product do
+                          xml.product_id product['product_id'] if product['product_id']
+                          xml.product_type product['product_type'] if product['product_type']
+                          xml.quantity product['quantity'] if product['quantity']
+                          xml.rental_due_date product['rental_due_date'] if product['rental_due_date']
+                          xml.rental_period product['rental_period'] if product['rental_period']
+                          if product['external_line_item_ids']
+                            xml.external_line_item_ids do
+                              if product['external_line_item_ids']['external_line_item_id'].class == Array
+                                product['external_line_item_ids']['external_line_item_id'].each do |external_line_item_id|
+                                  xml.external_line_item_id external_line_item_id
+                                end
+                              else
+                                external_line_item_id = product['external_line_item_ids']['external_line_item_id']
+                                xml.external_line_item_id external_line_item_id
+                              end
+                            end
+                          end
+                          xml.price_cents product['price_cents'] if product['price_cents']
+                          xml.retail_price_cents product['retail_price_cents'] if product['retail_price_cents']
+
+                          if product['line_item_extension']
+                            xml.line_item_extension do
+                              xml.external_line_item_id product['line_item_extension']['external_line_item_id'] if product['line_item_extension']['external_line_item_id']
+                              xml.period product['line_item_extension']['period'] if product['line_item_extension']['period']
+                            end
+                          end
+
+                        end
+                      end
+                    else
+                      product = checkout_single_post_create_order_hash['product_list']['products']['product']
+                      xml.product do
+                        xml.product_id product['product_id'] if product['product_id']
+                        xml.product_type product['product_type'] if product['product_type']
+                        xml.quantity product['quantity'] if product['quantity']
+                        xml.rental_due_date product['rental_due_date'] if product['rental_due_date']
+                        xml.rental_period product['rental_period'] if product['rental_period']
+                        if product['external_line_item_ids']
+                          xml.external_line_item_ids do
+                            if product['external_line_item_ids']['external_line_item_id'].class == Array
+                              product['external_line_item_ids']['external_line_item_id'].each do |external_line_item_id|
+                                xml.external_line_item_id external_line_item_id
+                              end
+                            else
+                              external_line_item_id = product['external_line_item_ids']['external_line_item_id']
+                              xml.external_line_item_id external_line_item_id
+                            end
+                          end
+                        end
+                        xml.price_cents product['price_cents'] if product['price_cents']
+                        xml.retail_price_cents product['retail_price_cents'] if product['retail_price_cents']
+
+                        if product['line_item_extension']
+                          xml.line_item_extension do
+                            xml.external_line_item_id product['line_item_extension']['external_line_item_id'] if product['line_item_extension']['external_line_item_id']
+                            xml.period product['line_item_extension']['period'] if product['line_item_extension']['period']
+                          end
+                        end
+
+                      end
+                    end
+                  end
+                end
+              end
+            end
+            if checkout_single_post_create_order_hash['billing_address']
+              xml.billing_address do
+                xml.billing_address_verification_code checkout_single_post_create_order_hash['billing_address']['billing_address_verification_code'] if checkout_single_post_create_order_hash['billing_address']['billing_address_verification_code']
+                xml.first_name checkout_single_post_create_order_hash['billing_address']['first_name'] if checkout_single_post_create_order_hash['billing_address']['first_name']
+                xml.last_name checkout_single_post_create_order_hash['billing_address']['last_name'] if checkout_single_post_create_order_hash['billing_address']['last_name']
+                xml.street_address checkout_single_post_create_order_hash['billing_address']['street_address'] if checkout_single_post_create_order_hash['billing_address']['street_address']
+                if checkout_single_post_create_order_hash['billing_address']['street_address_2']
+                  xml.street_address_2 checkout_single_post_create_order_hash['billing_address']['street_address_2']
+                else
+                  xml.street_address_2 ""
+                end
+                xml.city checkout_single_post_create_order_hash['billing_address']['city'] if checkout_single_post_create_order_hash['billing_address']['city']
+                xml.state checkout_single_post_create_order_hash['billing_address']['state'] if checkout_single_post_create_order_hash['billing_address']['state']
+                xml.zip checkout_single_post_create_order_hash['billing_address']['zip'] if checkout_single_post_create_order_hash['billing_address']['zip']
+                xml.country checkout_single_post_create_order_hash['billing_address']['country'] if checkout_single_post_create_order_hash['billing_address']['country']
+              end
+            end
+
+            if checkout_single_post_create_order_hash['shipping_address']
+              xml.shipping_address do
+                xml.shipping_address_verification_code checkout_single_post_create_order_hash['shipping_address']['shipping_address_verification_code'] if checkout_single_post_create_order_hash['shipping_address']['shipping_address_verification_code']
+                xml.first_name checkout_single_post_create_order_hash['shipping_address']['first_name'] if checkout_single_post_create_order_hash['shipping_address']['first_name']
+                xml.last_name checkout_single_post_create_order_hash['shipping_address']['last_name'] if checkout_single_post_create_order_hash['shipping_address']['last_name']
+                xml.street_address checkout_single_post_create_order_hash['shipping_address']['street_address'] if checkout_single_post_create_order_hash['shipping_address']['street_address']
+                xml.street_address_2 checkout_single_post_create_order_hash['shipping_address']['street_address_2'] if checkout_single_post_create_order_hash['shipping_address']['street_address_2']
+                xml.city checkout_single_post_create_order_hash['shipping_address']['city'] if checkout_single_post_create_order_hash['shipping_address']['city']
+                xml.state checkout_single_post_create_order_hash['shipping_address']['state'] if checkout_single_post_create_order_hash['shipping_address']['state']
+                xml.zip checkout_single_post_create_order_hash['shipping_address']['zip'] if checkout_single_post_create_order_hash['shipping_address']['zip']
+                xml.country checkout_single_post_create_order_hash['shipping_address']['country'] if checkout_single_post_create_order_hash['shipping_address']['country']
+              end
+            end
+
+            if checkout_single_post_create_order_hash['credit_card']
+              xml.credit_card do
+                xml.credit_card_verification_code checkout_single_post_create_order_hash['credit_card']['credit_card_verification_code'] if checkout_single_post_create_order_hash['credit_card']['credit_card_verification_code']
+                xml.number checkout_single_post_create_order_hash['credit_card']['number'] if checkout_single_post_create_order_hash['credit_card']['number']
+                xml.month checkout_single_post_create_order_hash['credit_card']['month'] if checkout_single_post_create_order_hash['credit_card']['month']
+                xml.year checkout_single_post_create_order_hash['credit_card']['year'] if checkout_single_post_create_order_hash['credit_card']['year']
+                xml.verification_value checkout_single_post_create_order_hash['credit_card']['verification_value'] if checkout_single_post_create_order_hash['credit_card']['verification_value']
+                xml.type checkout_single_post_create_order_hash['credit_card']['type'] if checkout_single_post_create_order_hash['credit_card']['type']
+              end
+            end
+
+            if checkout_single_post_create_order_hash['shipping_option']
+              xml.shipping_option do
+                xml.method_name checkout_single_post_create_order_hash['shipping_option']['method_name'] if checkout_single_post_create_order_hash['shipping_option']['method_name']
+                xml.shipping_price_cents checkout_single_post_create_order_hash['shipping_option']['shipping_price_cents'] if checkout_single_post_create_order_hash['shipping_option']['shipping_price_cents']
+                xml.tax_cost_cents checkout_single_post_create_order_hash['shipping_option']['tax_cost_cents'] if checkout_single_post_create_order_hash['shipping_option']['tax_cost_cents']
+              end
+            end
+          end
+        end
+      end
+      BWS::Checkout.new(post("/checkout/single_post_create_order.xml", xml_target))
+    end
+
+    #
+    # TODO Implement this method following https://bws.demo.bookrenter.com/v1/retail_docs/create_store_order
+    # A file called test_sequoia_main_use_case.rb has that structure. It was sent by email.
+    #
+    def checkout_create_store_order(checkout_create_store_order_hash = nil)
+      raise BadParams unless checkout_single_post_create_order_hash
+
+
+    end
+
+    #
+    # This report produces a list of active ISBNs forecasted to be in the BookRenter eco-system.
+    # Each active_isbn record will include the elements listed in the response if they are available.
+    #
+    def retrieve_active_isbn_report(active_isbn_report_hash = nil)
+      raise BadParams unless active_isbn_report_hash
+
+      xml_target = ''
+      xml = Builder::XmlMarkup.new :target => xml_target
+      xml.envelope do
+        xml.body do
+          xml.reports_active_isbn_report do
+            if active_isbn_report_hash['pagination'] then
+              xml.pagination do
+                xml.page active_isbn_report_hash['pagination']['page'] if active_isbn_report_hash['pagination']['page']
+                xml.items_per_page active_isbn_report_hash['pagination']['items_per_page'] if active_isbn_report_hash['pagination']['items_per_page']
+              end
+            end
+            if active_isbn_report_hash['active_isbn_report'] then
+              xml.active_isbn_report do
+                if active_isbn_report_hash['active_isbn_report']['active_isbns'] then
+                  xml.active_isbns do
+                    if active_isbn_report_hash['active_isbn_report']['active_isbns']['active_isbn'] then
+                      if active_isbn_report_hash['active_isbn_report']['active_isbns']['active_isbn'].class == Array then
+                        active_isbns = active_isbn_report_hash['active_isbn_report']['active_isbns']['active_isbn']
+                      else
+                        active_isbns = [ active_isbn_report_hash['active_isbn_report']['active_isbns']['active_isbn'] ]
+                      end
+                      active_isbns.each do |active_isbn|
+                        if active_isbn['isbn'] then
+                          xml.active_isbn do
+                            xml.isbn active_isbn['isbn']
+                          end
+                        end
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+      BWS::ActiveIsbnReport.new(post("/reports/active_isbn_report.xml", xml_target))
+    end
+
+    private
+    def get(url)
+      full_url = url.match(/\?/) ? "#{base_uri}#{url}&api_key=#{api_key}" : "#{base_uri}#{url}?api_key=#{api_key}"
+      if(defined? Rails)
+        Rails.logger.debug("----------------------------------------------------------------------------------------")
+        Rails.logger.debug("BWS GET call")
+        Rails.logger.debug("URL: #{full_url}")
+        Rails.logger.debug("----------------------------------------------------------------------------------------")
+      end
+      self.class.get(full_url, :timeout => @timeout)
+    end
+
+    def post(url, data)
+      full_url = "#{base_uri}#{url}?api_key=#{api_key}"
+      if(defined? Rails)
+        Rails.logger.debug("----------------------------------------------------------------------------------------")
+        Rails.logger.debug("BWS POST call")
+        Rails.logger.debug("URL: #{full_url}")
+        Rails.logger.debug("XML: #{data}")
+        Rails.logger.debug("----------------------------------------------------------------------------------------")
+      end
+      self.class.post(full_url, :body => data, :timeout => @timeout)
+    end
+  end
+end