Merge pull request #7 from truehostcloud/purchase_multiple_products

Purchase multiple products

Author: willymwai

olittwhmcs/serializer.py

@@ -73,9 +73,17 @@ def update_client_request_parameters(**kwargs):
     """
     parameters = get_default_parameters()
     parameters.update({'action': 'UpdateClient'})
-    param_map = {'first_name': 'firstname', 'last_name': 'lastname', 'email': 'clientemail', 'country': 'country',
-                 'state': 'state', 'city': 'city', 'postcode': 'postcode', 'address': 'address1', 'phone': 'phonenumber',
-                 'password': 'password2'}
+    param_map = {
+        'first_name': 'firstname',
+        'last_name': 'lastname',
+        'email': 'clientemail',
+        'country': 'country',
+        'state': 'state',
+        'city': 'city',
+        'postcode': 'postcode',
+        'address': 'address1',
+        'phone': 'phonenumber',
+        'password': 'password2'}
     for param, value in kwargs.items():
         parameters.update({param_map[param]: value})
     return parameters
@@ -188,6 +196,20 @@ def order_domain_request_parameters(client_id, domain, payment_method,
     return parameters
 
 
+def order_bulk_products_request_parameters(parameters, **kwargs):
+    """
+    Retrieve parameters for the domain order request.
+    :param parameters: dict of the order placed.
+    :param kwargs: (Optional) Other parameters to add to the order payload.
+        Eg promo_code, affiliate_id, price (override), ...
+    :return: payload for the order product request
+    :rtype: Dictionary
+    """
+    default_parameters  = get_default_parameters()
+    parameters.update(default_parameters )
+    return parameters
+
+
 def upgrade_product_request_parameters(service_id, payment_method, billing_cycle=None,
                                        package_id=None):
     """Retrieve parameters for the product upgrade request.

olittwhmcs/whmcs.py

@@ -1,9 +1,9 @@
 """This module contains the api surface for consuming this package."""
 
+from datetime import datetime
 import hashlib
 import os
 import time
-from datetime import datetime
 
 from olittwhmcs import serializer, models
 from olittwhmcs.exceptions import WhmcsException
@@ -14,7 +14,7 @@
     create_user_request_parameters, get_client_product_request_parameters, \
     upgrade_product_request_parameters, prepare_get_invoices_request, \
     prepare_get_orders_request, prepare_cancel_order_request, \
-    order_domain_request_parameters
+    order_domain_request_parameters, order_bulk_products_request_parameters
 
 
 ##########
@@ -81,6 +81,7 @@ def update_client(**kwargs):
     default_error = "Unable to update client details"
     raise WhmcsException(response_or_error if response_or_error else default_error)
 
+
 ###########
 # PRODUCT #
 ###########
@@ -175,6 +176,29 @@ def order_product(client_id, payment_method, billing_cycle, product_id=None,
     raise WhmcsException(response_or_error if response_or_error else default_error)
 
 
+def order_bulk_products(parameters=None, **kwargs):
+    """
+    Place a multiple products order in WHMCS.
+    :param parameters: dict of the order placed.
+    :param product_id: Integer, id of the product to order.
+    :param kwargs: (Optional) Other parameters to add to the order payload.
+        Eg promo_code, affiliate_id, price (override), ...
+    :return: id of placed order, id of corresponding invoice
+    :rtype: int, int
+    :raises WhmcsException: If an error occurs.
+    """
+    if not parameters:
+        parameters = {}
+    updated_parameters = order_bulk_products_request_parameters(parameters)
+    is_successful, response_or_error = get_whmcs_response(updated_parameters)
+    if is_successful and response_or_error:
+        order_id = response_or_error.get('orderid')
+        invoice_id = response_or_error.get('invoiceid')
+        return order_id, invoice_id
+    default_error = "Unable to fetch products"
+    raise WhmcsException(response_or_error if response_or_error else default_error)
+
+
 def upgrade_client_product(service_id, payment_method, billing_cycle=None,
                            package_id=None):
     """Upgrade a product in WHMCS.