Add endpoint for solicitations API

[ryanalco]

See the endpoint on this link: https://github.com/amzn/selling-partner-api-docs/blob/main/references/solicitations-api/solicitations.md
It'd be great to be able to request reviews from buyers.

[mastamatto]

1. create a directory called 'solicitations' in the 'apis' directory
2. add two .py files (__init__.py, solicitations.py)

__init__.py is an empty file

solicitations.py:

import urllib.parse
from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse


class Solicitations(Client):
  """
  """
  @sp_endpoint('/solicitations/v1/orders/{}')
  def get_solicitation_actions_for_order(self, order_id: str, **kwargs) -> ApiResponse:
      """
      get_solicitation_actions_for_order(self, order_id: str, **kwargs) -> ApiResponse

      Args:
          order_id:
          key marketplaceIds: str
          **kwargs:

      Returns:
          ApiResponse:
      """
      kwargs.update({'marketplaceIds': kwargs.get('marketplaceIds', None) or self.marketplace_id})
      return self._request(fill_query_params(kwargs.pop('path'), order_id), params=kwargs)
  
  @sp_endpoint('/solicitations/v1/orders/{}/productReviewAndSellerFeedback','POST')
  def create_product_review_and_seller_feedback_solicitation(self,order_id: str, **kwargs) -> ApiResponse:
      """
      create_product_review_and_seller_feedback_solicitation(self, order_id: str, **kwargs) -> ApiResponse

      Args:
          order_id:
          key marketplaceIds: str
          **kwargs:

      Returns:
          ApiResponse:
      """
      kwargs.update({'marketplaceIds': kwargs.get('marketplaceIds', None) or self.marketplace_id})
      return self._request(fill_query_params(kwargs.pop('path'), order_id), params=kwargs)

3. add solicitation module to package's __init__.py module

from .finances.finances import Finances
from .notifications.notifications import Notifications
from .orders.orders import Orders
from .product_fees.product_fees import ProductFees
from .sellers.sellers import Sellers
from .reports.reports import Reports
from .products.products import Products
from .sales.sales import Sales
from .catalog.catalog import Catalog
from .feeds.feeds import Feeds
from .inventories.inventories import Inventories
from .fulfillment_inbound.fulfillment_inbound import FulfillmentInbound
from .upload.upload import Upload
from .messaging.messaging import Messaging
from .solicitations.solicitations import Solicitations
from .merchant_fulfillment.merchant_fulfillment import MerchantFulfillment

__all__ = [
    "Sales",
    "Products",
    "Reports",
    "Orders",
    "Sellers",
    "Notifications",
    "ProductFees",
    "Finances",
    "Catalog",
    "Feeds",
    "Inventories",
    "FulfillmentInbound",
    'Upload',
    "Messaging",
    "FulfillmentInbound",
    "MerchantFulfillment",
    "Solicitations"
]

I hope this works for you.
Hopefully they add more functionality for this down the road.

[ryanalco]

Thank you!