python-amazon-sp-api 2.0.15__py3-none-any.whl → 2.1.3__py3-none-any.whl

sp_api/api/finances/finances_2024_06_19.py

@@ -0,0 +1,114 @@
+from sp_api.base import Client, ApiResponse
+from sp_api.base import sp_endpoint, fill_query_params
+
+
+class FinancesV20240619(Client):
+
+    @sp_endpoint("/finances/2024-06-19/orders/{}/financialEvents")
+    def get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse:
+        """
+        get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse
+        
+         
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV20240619().get_financial_events_for_order("value")
+        
+        Args:
+            order_id:  | required
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(
+            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/2024-06-19/financialEvents")
+    def list_financial_events(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_events(self, **kwargs) -> ApiResponse
+        
+         
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV20240619().list_financial_events()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(fill_query_params(kwargs.pop("path")), params={**kwargs})
+
+    @sp_endpoint("/finances/2024-06-19/financialEventGroups/{}/financialEvents")
+    def list_financial_events_by_group_id(
+        self, event_group_id, **kwargs
+    ) -> ApiResponse:
+        """
+        list_financial_events_by_group_id(self, event_group_id, **kwargs) -> ApiResponse
+        
+         
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV20240619().list_financial_events_by_group_id("value")
+        
+        Args:
+            event_group_id:  | required
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(
+            fill_query_params(kwargs.pop("path"), event_group_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/2024-06-19/financialEventGroups")
+    def list_financial_event_groups(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_event_groups(self, **kwargs) -> ApiResponse
+        
+         
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV20240619().list_financial_event_groups()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/finances/2024-06-19/transactions")
+    def list_transactions(self, **kwargs) -> ApiResponse:
+        """
+        list_transactions(self, **kwargs) -> ApiResponse
+        
+        Returns transactions for the given parameters. Financial events might not include orders from the last 48 hours.
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV20240619().list_transactions()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+
+        return self._request(kwargs.pop("path"), params={**kwargs})

sp_api/api/finances/finances_v0.py

@@ -0,0 +1,116 @@
+from sp_api.base import Client, ApiResponse
+from sp_api.base import sp_endpoint, fill_query_params
+
+
+class FinancesV0(Client):
+
+    @sp_endpoint("/finances/v0/orders/{}/financialEvents")
+    def get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse:
+        """
+        get_financial_events_for_order(self, order_id, **kwargs) -> ApiResponse
+        
+        Returns all financial events for the specified order. Orders from the last 48 hours might not be included in financial events.
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV0().get_financial_events_for_order("value")
+        
+        Args:
+            order_id:  | required
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(
+            fill_query_params(kwargs.pop("path"), order_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/v0/financialEvents")
+    def list_financial_events(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_events(self, **kwargs) -> ApiResponse
+        
+        Returns financial events for the specified data range. Orders from the last 48 hours might not be included in financial events.
+                        **Note:** in `ListFinancialEvents`, deferred events don't show up in responses until they are released.
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV0().list_financial_events()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(fill_query_params(kwargs.pop("path")), params={**kwargs})
+
+    @sp_endpoint("/finances/v0/financialEventGroups/{}/financialEvents")
+    def list_financial_events_by_group_id(
+        self, event_group_id, **kwargs
+    ) -> ApiResponse:
+        """
+        list_financial_events_by_group_id(self, event_group_id, **kwargs) -> ApiResponse
+        
+        Returns all financial events for the specified financial event group. Orders from the last 48 hours might not be included in financial events.
+                        **Note:** This operation only retrieves a group's data for the past two years. A request for data spanning more than two years produces an empty response.
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV0().list_financial_events_by_group_id("value")
+        
+        Args:
+            event_group_id:  | required
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(
+            fill_query_params(kwargs.pop("path"), event_group_id), params={**kwargs}
+        )
+
+    @sp_endpoint("/finances/v0/financialEventGroups")
+    def list_financial_event_groups(self, **kwargs) -> ApiResponse:
+        """
+        list_financial_event_groups(self, **kwargs) -> ApiResponse
+        
+        Returns financial event groups for a given date range. Orders from the last 48 hours might not be included in financial events.
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV0().list_financial_event_groups()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+        return self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/finances/v0/transactions")
+    def list_transactions(self, **kwargs) -> ApiResponse:
+        """
+        list_transactions(self, **kwargs) -> ApiResponse
+        
+         
+        
+        Examples:
+            literal blocks::
+            
+                FinancesV0().list_transactions()
+        
+        Args:
+            **kwargs:
+        
+        Returns:
+            ApiResponse
+        """
+
+        return self._request(kwargs.pop("path"), params={**kwargs})