python-amazon-sp-api 1.9.18__py3-none-any.whl → 2.0.7__py3-none-any.whl

sp_api/asyncio/api/sellers/sellers.py

@@ -0,0 +1,70 @@
+from sp_api.base.helpers import sp_endpoint
+from sp_api.base import Client, Marketplaces, ApiResponse
+from sp_api.asyncio.base import AsyncBaseClient
+
+
+class Sellers(AsyncBaseClient):
+    """
+    :link: https://github.com/amzn/selling-partner-api-docs/blob/main/references/sellers-api/sellers.md
+
+    """
+
+    @sp_endpoint("/sellers/v1/marketplaceParticipations")
+    async def get_marketplace_participation(self, **kwargs) -> ApiResponse:
+        """
+        get_marketplace_participation(self, **kwargs) -> ApiResponse
+        Returns a list of marketplaces that the seller submitting the request can sell in and information about the seller's participation in those marketplaces.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        .016                                    15
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Examples:
+            literal blocks::
+
+                res = Sellers().get_marketplace_participation()
+
+        Args:
+            **kwargs:
+
+        Returns:
+            GetMarketplaceParticipationsResponse:
+
+        """
+        return await self._request(kwargs.pop("path"), add_marketplace=False)
+
+    @sp_endpoint("/sellers/v1/account")
+    async def get_account(self, **kwargs) -> ApiResponse:
+        """
+        get_account(self, **kwargs) -> ApiResponse
+        Returns information about a seller account and its marketplaces.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        .016                                    15
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Examples:
+            literal blocks::
+
+                res = Sellers().get_account()
+
+        Args:
+            **kwargs:
+
+        Returns:
+            GetAccountResponse:
+
+        """
+        return await self._request(kwargs.pop("path"), add_marketplace=False)

sp_api/asyncio/api/services/services.py

@@ -0,0 +1,218 @@
+import urllib.parse
+
+from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
+from sp_api.asyncio.base import AsyncBaseClient
+
+
+class Services(AsyncBaseClient):
+    """
+    Services SP-API Client
+    :link:
+
+    With the Services API, you can build applications that help service providers get and modify their service orders.
+    """
+
+    @sp_endpoint("/service/v1/serviceJobs/{}", method="GET")
+    async def get_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse:
+        """
+        get_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse
+
+        Gets service job details for the service job indicated by the service job identifier you specify.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        20                                      40
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            serviceJobId:string | * REQUIRED A service job identifier.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), serviceJobId), params=kwargs
+        )
+
+    @sp_endpoint("/service/v1/serviceJobs/{}/cancellations", method="PUT")
+    async def cancel_service_job_by_service_job_id(
+        self, serviceJobId, **kwargs
+    ) -> ApiResponse:
+        """
+        cancel_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse
+
+        Cancels the service job indicated by the service job identifier you specify.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        5                                       20
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            serviceJobId:string | * REQUIRED An Amazon defined service job identifier.
+            key cancellationReasonCode:string | * REQUIRED A cancel reason code that specifies the reason for cancelling a service job.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), serviceJobId), data=kwargs
+        )
+
+    @sp_endpoint("/service/v1/serviceJobs/{}/completions", method="PUT")
+    async def complete_service_job_by_service_job_id(
+        self, serviceJobId, **kwargs
+    ) -> ApiResponse:
+        """
+        complete_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse
+
+        Completes the service job indicated by the service job identifier you specify.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        5                                       20
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            serviceJobId:string | * REQUIRED An Amazon defined service job identifier.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), serviceJobId), data=kwargs
+        )
+
+    @sp_endpoint("/service/v1/serviceJobs", method="GET")
+    async def get_service_jobs(self, **kwargs) -> ApiResponse:
+        """
+        get_service_jobs(self, **kwargs) -> ApiResponse
+
+        Gets service job details for the specified filter query.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        10                                      40
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            key serviceOrderIds: array |  List of service order ids for the query you want to perform.Max values supported 20.
+            key serviceJobStatus: array |  A list of one or more job status by which to filter the list of jobs.
+            key pageToken: string |  String returned in the response of your previous request.
+            key pageSize: integer |  A non-negative integer that indicates the maximum number of jobs to return in the list, Value must be 1 - 20. Default 20.
+            key sortField: string |  Sort fields on which you want to sort the output.
+            key sortOrder: string |  Sort order for the query you want to perform.
+            key createdAfter: string |  A date used for selecting jobs created after (or at) a specified time must be in ISO 8601 format. Required if LastUpdatedAfter is not specified.Specifying both CreatedAfter and LastUpdatedAfter returns an error.
+            key createdBefore: string |  A date used for selecting jobs created before (or at) a specified time must be in ISO 8601 format.
+            key lastUpdatedAfter: string |  A date used for selecting jobs updated after (or at) a specified time must be in ISO 8601 format. Required if createdAfter is not specified.Specifying both CreatedAfter and LastUpdatedAfter returns an error.
+            key lastUpdatedBefore: string |  A date used for selecting jobs updated before (or at) a specified time must be in ISO 8601 format.
+            key scheduleStartDate: string |  A date used for filtering jobs schedule after (or at) a specified time must be in ISO 8601 format. schedule end date should not be earlier than schedule start date.
+            key scheduleEndDate: string |  A date used for filtering jobs schedule before (or at) a specified time must be in ISO 8601 format. schedule end date should not be earlier than schedule start date.
+            key marketplaceIds: array | * REQUIRED Used to select jobs that were placed in the specified marketplaces.
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(kwargs.pop("path"), params=kwargs)
+
+    @sp_endpoint("/service/v1/serviceJobs/{}/appointments", method="POST")
+    async def add_appointment_for_service_job_by_service_job_id(
+        self, serviceJobId, **kwargs
+    ) -> ApiResponse:
+        """
+        add_appointment_for_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse
+
+        Adds an appointment to the service job indicated by the service job identifier you specify.
+
+        **Usage Plan:**
+
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        5                                       20
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            serviceJobId:string | * REQUIRED An Amazon defined service job identifier.
+            body: {
+              "appointmentTime": {
+                "startTime": "2019-08-24T14:15:22Z",
+                "durationInMinutes": 0
+              }
+            }
+
+         Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), serviceJobId), data=kwargs
+        )
+
+    @sp_endpoint("/service/v1/serviceJobs/{}", method="POST")
+    async def reschedule_appointment_for_service_job_by_service_job_id(
+        self, serviceJobId, **kwargs
+    ) -> ApiResponse:
+        """
+        reschedule_appointment_for_service_job_by_service_job_id(self, serviceJobId, **kwargs) -> ApiResponse
+
+        Reschedules an appointment for the service job indicated by the service job identifier you specify.
+
+        **Usage Plan:**
+
+        ======================================  ==============
+        Rate (requests per second)               Burst
+        ======================================  ==============
+        5                                       20
+        ======================================  ==============
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Args:
+            serviceJobId:string | * REQUIRED An Amazon defined service job identifier.
+            appointmentId:string | * REQUIRED An existing appointment identifier for the Service Job.
+            kwargs: Example | >>>
+                {
+                    "appointmentTime": {
+                        "startTime": "2019-08-24T14:15:22Z",
+                        "durationInMinutes": 0
+                    },
+                    "rescheduleReasonCode": "string"
+                }
+
+        Returns:
+            ApiResponse:
+        """
+
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), serviceJobId), data=kwargs
+        )