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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. {python_amazon_sp_api-2.0.15.dist-info → python_amazon_sp_api-2.1.3.dist-info}/METADATA +7 -7
  2. python_amazon_sp_api-2.1.3.dist-info/RECORD +350 -0
  3. sp_api/__version__.py +1 -1
  4. sp_api/api/__init__.py +160 -4
  5. sp_api/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py +85 -110
  6. sp_api/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu_2024_05_09.py +456 -0
  7. sp_api/api/aplus_content/aplus_content.py +176 -125
  8. sp_api/api/application_integrations/application_integrations.py +59 -68
  9. sp_api/api/application_management/application_management.py +20 -13
  10. sp_api/api/authorization/authorization.py +8 -26
  11. sp_api/api/catalog/catalog.py +27 -61
  12. sp_api/api/catalog_items/catalog_items.py +108 -78
  13. sp_api/api/catalog_items/catalog_items_2020_12_01.py +86 -0
  14. sp_api/api/catalog_items/catalog_items_2022_04_01.py +89 -0
  15. sp_api/api/customer_feedback/customer_feedback.py +100 -0
  16. sp_api/api/data_kiosk/data_kiosk.py +80 -75
  17. sp_api/api/delivery_by_amazon/__init__.py +0 -0
  18. sp_api/api/delivery_by_amazon/delivery_by_amazon.py +92 -0
  19. sp_api/api/delivery_by_amazon/delivery_by_amazon_2022_07_01.py +81 -0
  20. sp_api/api/easy_ship/easy_ship.py +121 -111
  21. sp_api/api/external_fulfillment/external_fulfillment.py +211 -434
  22. sp_api/api/external_fulfillment/inventory.py +120 -0
  23. sp_api/api/external_fulfillment/inventory_2021_01_06.py +71 -0
  24. sp_api/api/external_fulfillment/inventory_2024_09_11.py +96 -0
  25. sp_api/api/external_fulfillment/returns.py +120 -0
  26. sp_api/api/external_fulfillment/returns_2021_08_19.py +88 -0
  27. sp_api/api/external_fulfillment/returns_2024_09_11.py +141 -0
  28. sp_api/api/external_fulfillment/shipping.py +120 -0
  29. sp_api/api/external_fulfillment/shipping_2021_01_06.py +256 -0
  30. sp_api/api/external_fulfillment/shipping_2024_09_11.py +233 -0
  31. sp_api/api/fba_inbound_eligibility/fba_inbound_eligibility.py +30 -24
  32. sp_api/api/fba_small_and_light/fba_small_and_light.py +60 -99
  33. sp_api/api/feeds/feeds.py +75 -245
  34. sp_api/api/feeds/feeds_2021_06_30.py +320 -0
  35. sp_api/api/finances/finances.py +123 -90
  36. sp_api/api/finances/finances_2024_06_01.py +71 -0
  37. sp_api/api/finances/finances_2024_06_19.py +114 -0
  38. sp_api/api/finances/finances_v0.py +116 -0
  39. sp_api/api/fulfillment_inbound/fulfillment_inbound.py +107 -1784
  40. sp_api/api/fulfillment_inbound/fulfillment_inbound_2024_03_20.py +1722 -0
  41. sp_api/api/fulfillment_inbound/fulfillment_inbound_v0.py +1384 -0
  42. sp_api/api/fulfillment_outbound/fulfillment_outbound.py +256 -480
  43. sp_api/api/inventories/inventories.py +79 -42
  44. sp_api/api/invoices/__init__.py +0 -0
  45. sp_api/api/invoices/invoices.py +92 -0
  46. sp_api/api/invoices/invoices_2024_06_19.py +344 -0
  47. sp_api/api/listings_items/listings_items.py +110 -163
  48. sp_api/api/listings_items/listings_items_2020_09_01.py +189 -0
  49. sp_api/api/listings_items/listings_items_2021_08_01.py +233 -0
  50. sp_api/api/listings_restrictions/listings_restrictions.py +23 -10
  51. sp_api/api/merchant_fulfillment/merchant_fulfillment.py +107 -222
  52. sp_api/api/messaging/messaging.py +184 -198
  53. sp_api/api/notifications/notifications.py +144 -106
  54. sp_api/api/orders/orders.py +9 -46
  55. sp_api/api/orders/orders_2026_01_01.py +19 -65
  56. sp_api/api/orders/orders_v0.py +152 -184
  57. sp_api/api/product_fees/product_fees.py +101 -75
  58. sp_api/api/product_type_definitions/product_type_definitions.py +47 -36
  59. sp_api/api/products/products.py +94 -386
  60. sp_api/api/products/products_2022_05_01.py +96 -0
  61. sp_api/api/products/products_v0.py +389 -0
  62. sp_api/api/replenishment/replenishment.py +58 -69
  63. sp_api/api/reports/reports.py +124 -157
  64. sp_api/api/sales/sales.py +22 -39
  65. sp_api/api/seller_wallet/__init__.py +0 -0
  66. sp_api/api/seller_wallet/seller_wallet.py +92 -0
  67. sp_api/api/seller_wallet/seller_wallet_2024_03_01.py +300 -0
  68. sp_api/api/sellers/sellers.py +15 -35
  69. sp_api/api/services/services.py +479 -82
  70. sp_api/api/shipment_invoicing/__init__.py +0 -0
  71. sp_api/api/shipment_invoicing/shipment_invoicing.py +92 -0
  72. sp_api/api/shipment_invoicing/shipment_invoicing_v0.py +101 -0
  73. sp_api/api/shipping/shipping.py +94 -440
  74. sp_api/api/shipping/shippingV2.py +183 -474
  75. sp_api/api/shipping/shipping_v1.py +330 -0
  76. sp_api/api/shipping/shipping_v2.py +723 -0
  77. sp_api/api/solicitations/solicitations.py +28 -18
  78. sp_api/api/supply_sources/supply_sources.py +67 -57
  79. sp_api/api/tokens/tokens.py +14 -35
  80. sp_api/api/vehicles/__init__.py +0 -0
  81. sp_api/api/vehicles/vehicles.py +92 -0
  82. sp_api/api/vehicles/vehicles_2024_11_01.py +33 -0
  83. sp_api/api/vendor_direct_fulfillment_inventory/vendor_direct_fulfillment_inventory.py +16 -29
  84. sp_api/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders.py +116 -189
  85. sp_api/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders_2021_12_28.py +114 -0
  86. sp_api/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders_v1.py +114 -0
  87. sp_api/api/vendor_direct_fulfillment_payments/vendor_direct_fulfillment_payments.py +15 -225
  88. sp_api/api/vendor_direct_fulfillment_sandbox_test_data/__init__.py +0 -0
  89. sp_api/api/vendor_direct_fulfillment_sandbox_test_data/vendor_direct_fulfillment_sandbox_test_data.py +92 -0
  90. sp_api/api/vendor_direct_fulfillment_sandbox_test_data/vendor_direct_fulfillment_sandbox_test_data_2021_10_28.py +50 -0
  91. sp_api/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping.py +122 -624
  92. sp_api/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping_2021_12_28.py +390 -0
  93. sp_api/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping_v1.py +320 -0
  94. sp_api/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions.py +113 -29
  95. sp_api/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions_2021_12_28.py +47 -0
  96. sp_api/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions_v1.py +47 -0
  97. sp_api/api/vendor_invoices/vendor_invoices.py +15 -264
  98. sp_api/api/vendor_orders/vendor_orders.py +83 -131
  99. sp_api/api/vendor_shipments/vendor_shipments.py +149 -68
  100. sp_api/api/vendor_transaction_status/vendor_transaction_status.py +16 -11
  101. sp_api/asyncio/api/__init__.py +159 -4
  102. sp_api/asyncio/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py +84 -110
  103. sp_api/asyncio/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu_2024_05_09.py +457 -0
  104. sp_api/asyncio/api/aplus_content/aplus_content.py +176 -125
  105. sp_api/asyncio/api/application_integrations/application_integrations.py +59 -68
  106. sp_api/asyncio/api/application_management/application_management.py +20 -13
  107. sp_api/asyncio/api/authorization/authorization.py +8 -26
  108. sp_api/asyncio/api/catalog/catalog.py +27 -61
  109. sp_api/asyncio/api/catalog_items/catalog_items.py +94 -71
  110. sp_api/asyncio/api/catalog_items/catalog_items_2020_12_01.py +87 -0
  111. sp_api/asyncio/api/catalog_items/catalog_items_2022_04_01.py +90 -0
  112. sp_api/asyncio/api/customer_feedback/customer_feedback.py +100 -0
  113. sp_api/asyncio/api/data_kiosk/data_kiosk.py +80 -75
  114. sp_api/asyncio/api/delivery_by_amazon/__init__.py +0 -0
  115. sp_api/asyncio/api/delivery_by_amazon/delivery_by_amazon.py +92 -0
  116. sp_api/asyncio/api/delivery_by_amazon/delivery_by_amazon_2022_07_01.py +82 -0
  117. sp_api/asyncio/api/easy_ship/easy_ship.py +121 -111
  118. sp_api/asyncio/api/external_fulfillment/external_fulfillment.py +212 -435
  119. sp_api/asyncio/api/external_fulfillment/inventory.py +126 -0
  120. sp_api/asyncio/api/external_fulfillment/inventory_2021_01_06.py +73 -0
  121. sp_api/asyncio/api/external_fulfillment/inventory_2024_09_11.py +98 -0
  122. sp_api/asyncio/api/external_fulfillment/returns.py +124 -0
  123. sp_api/asyncio/api/external_fulfillment/returns_2021_08_19.py +90 -0
  124. sp_api/asyncio/api/external_fulfillment/returns_2024_09_11.py +143 -0
  125. sp_api/asyncio/api/external_fulfillment/shipping.py +124 -0
  126. sp_api/asyncio/api/external_fulfillment/shipping_2021_01_06.py +258 -0
  127. sp_api/asyncio/api/external_fulfillment/shipping_2024_09_11.py +235 -0
  128. sp_api/asyncio/api/fba_inbound_eligibility/fba_inbound_eligibility.py +31 -25
  129. sp_api/asyncio/api/fba_small_and_light/fba_small_and_light.py +61 -100
  130. sp_api/asyncio/api/feeds/feeds.py +75 -243
  131. sp_api/asyncio/api/feeds/feeds_2021_06_30.py +318 -0
  132. sp_api/asyncio/api/finances/finances.py +123 -91
  133. sp_api/asyncio/api/finances/finances_2024_06_01.py +72 -0
  134. sp_api/asyncio/api/finances/finances_2024_06_19.py +115 -0
  135. sp_api/asyncio/api/finances/finances_v0.py +117 -0
  136. sp_api/asyncio/api/fulfillment_inbound/fulfillment_inbound.py +107 -1785
  137. sp_api/asyncio/api/fulfillment_inbound/fulfillment_inbound_2024_03_20.py +1723 -0
  138. sp_api/asyncio/api/fulfillment_inbound/fulfillment_inbound_v0.py +1385 -0
  139. sp_api/asyncio/api/fulfillment_outbound/fulfillment_outbound.py +257 -481
  140. sp_api/asyncio/api/inventories/inventories.py +79 -42
  141. sp_api/asyncio/api/invoices/__init__.py +0 -0
  142. sp_api/asyncio/api/invoices/invoices.py +92 -0
  143. sp_api/asyncio/api/invoices/invoices_2024_06_19.py +345 -0
  144. sp_api/asyncio/api/listings_items/listings_items.py +109 -163
  145. sp_api/asyncio/api/listings_items/listings_items_2020_09_01.py +190 -0
  146. sp_api/asyncio/api/listings_items/listings_items_2021_08_01.py +233 -0
  147. sp_api/asyncio/api/listings_restrictions/listings_restrictions.py +23 -10
  148. sp_api/asyncio/api/merchant_fulfillment/merchant_fulfillment.py +110 -222
  149. sp_api/asyncio/api/messaging/messaging.py +185 -199
  150. sp_api/asyncio/api/notifications/notifications.py +145 -107
  151. sp_api/asyncio/api/orders/orders.py +9 -46
  152. sp_api/asyncio/api/orders/orders_2026_01_01.py +19 -65
  153. sp_api/asyncio/api/orders/orders_v0.py +152 -184
  154. sp_api/asyncio/api/product_fees/product_fees.py +101 -75
  155. sp_api/asyncio/api/product_type_definitions/product_type_definitions.py +47 -36
  156. sp_api/asyncio/api/products/products.py +94 -387
  157. sp_api/asyncio/api/products/products_2022_05_01.py +109 -0
  158. sp_api/asyncio/api/products/products_v0.py +388 -0
  159. sp_api/asyncio/api/replenishment/replenishment.py +59 -70
  160. sp_api/asyncio/api/reports/reports.py +124 -157
  161. sp_api/asyncio/api/sales/sales.py +22 -39
  162. sp_api/asyncio/api/seller_wallet/__init__.py +0 -0
  163. sp_api/asyncio/api/seller_wallet/seller_wallet.py +92 -0
  164. sp_api/asyncio/api/seller_wallet/seller_wallet_2024_03_01.py +301 -0
  165. sp_api/asyncio/api/sellers/sellers.py +16 -36
  166. sp_api/asyncio/api/services/services.py +479 -82
  167. sp_api/asyncio/api/shipment_invoicing/__init__.py +0 -0
  168. sp_api/asyncio/api/shipment_invoicing/shipment_invoicing.py +92 -0
  169. sp_api/asyncio/api/shipment_invoicing/shipment_invoicing_v0.py +102 -0
  170. sp_api/asyncio/api/shipping/shipping.py +94 -441
  171. sp_api/asyncio/api/shipping/shippingV2.py +181 -472
  172. sp_api/asyncio/api/shipping/shipping_v1.py +331 -0
  173. sp_api/asyncio/api/shipping/shipping_v2.py +717 -0
  174. sp_api/asyncio/api/solicitations/solicitations.py +29 -19
  175. sp_api/asyncio/api/supply_sources/supply_sources.py +67 -57
  176. sp_api/asyncio/api/tokens/tokens.py +14 -35
  177. sp_api/asyncio/api/vehicles/__init__.py +0 -0
  178. sp_api/asyncio/api/vehicles/vehicles.py +92 -0
  179. sp_api/asyncio/api/vehicles/vehicles_2024_11_01.py +34 -0
  180. sp_api/asyncio/api/vendor_direct_fulfillment_inventory/vendor_direct_fulfillment_inventory.py +16 -29
  181. sp_api/asyncio/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders.py +120 -192
  182. sp_api/asyncio/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders_2021_12_28.py +116 -0
  183. sp_api/asyncio/api/vendor_direct_fulfillment_orders/vendor_direct_fulfillment_orders_v1.py +115 -0
  184. sp_api/asyncio/api/vendor_direct_fulfillment_payments/vendor_direct_fulfillment_payments.py +15 -225
  185. sp_api/asyncio/api/vendor_direct_fulfillment_sandbox_test_data/__init__.py +0 -0
  186. sp_api/asyncio/api/vendor_direct_fulfillment_sandbox_test_data/vendor_direct_fulfillment_sandbox_test_data.py +92 -0
  187. sp_api/asyncio/api/vendor_direct_fulfillment_sandbox_test_data/vendor_direct_fulfillment_sandbox_test_data_2021_10_28.py +51 -0
  188. sp_api/asyncio/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping.py +120 -623
  189. sp_api/asyncio/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping_2021_12_28.py +392 -0
  190. sp_api/asyncio/api/vendor_direct_fulfillment_shipping/vendor_direct_fulfillment_shipping_v1.py +321 -0
  191. sp_api/asyncio/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions.py +112 -29
  192. sp_api/asyncio/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions_2021_12_28.py +49 -0
  193. sp_api/asyncio/api/vendor_direct_fulfillment_transactions/vendor_direct_fulfillment_transactions_v1.py +48 -0
  194. sp_api/asyncio/api/vendor_invoices/vendor_invoices.py +16 -265
  195. sp_api/asyncio/api/vendor_orders/vendor_orders.py +84 -132
  196. sp_api/asyncio/api/vendor_shipments/vendor_shipments.py +150 -69
  197. sp_api/asyncio/api/vendor_transaction_status/vendor_transaction_status.py +17 -12
  198. sp_api/asyncio/base/client.py +2 -2
  199. sp_api/asyncio/util/load_date_bound.py +1 -1
  200. sp_api/base/__init__.py +10 -0
  201. sp_api/base/_core.py +2 -2
  202. sp_api/base/client.py +3 -3
  203. sp_api/base/helpers.py +12 -1
  204. sp_api/base/marketplaces.py +6 -3
  205. sp_api/util/__init__.py +2 -0
  206. sp_api/util/load_date_bound.py +1 -1
  207. sp_api/util/versioned_client.py +45 -0
  208. python_amazon_sp_api-2.0.15.dist-info/RECORD +0 -255
  209. sp_api/asyncio/api/models/__init__.py +0 -4
  210. sp_api/asyncio/api/overrides/__init__.py +0 -1
  211. {python_amazon_sp_api-2.0.15.data → python_amazon_sp_api-2.1.3.data}/scripts/make_endpoint +0 -0
  212. {python_amazon_sp_api-2.0.15.dist-info → python_amazon_sp_api-2.1.3.dist-info}/WHEEL +0 -0
  213. {python_amazon_sp_api-2.0.15.dist-info → python_amazon_sp_api-2.1.3.dist-info}/licenses/LICENSE +0 -0
  214. {python_amazon_sp_api-2.0.15.dist-info → python_amazon_sp_api-2.1.3.dist-info}/top_level.txt +0 -0
@@ -1,627 +1,124 @@
1
- import urllib.parse
1
+ from __future__ import annotations
2
2
 
3
- from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
4
- from sp_api.asyncio.base import AsyncBaseClient
5
-
6
-
7
- class VendorDirectFulfillmentShipping(AsyncBaseClient):
8
- """
9
- VendorDirectFulfillmentShipping SP-API Client
10
- :link:
3
+ import enum
4
+ from typing import Any, Literal, TYPE_CHECKING, overload
11
5
 
12
- The Selling Partner API for Direct Fulfillment Shipping provides programmatic access to a direct fulfillment vendor's shipping data.
6
+ from sp_api.asyncio.base import AsyncBaseClient
7
+ from sp_api.util.versioned_client import VersionedClientMeta
8
+
9
+ from .vendor_direct_fulfillment_shipping_2021_12_28 import (
10
+ VendorDirectFulfillmentShippingV20211228,
11
+ )
12
+ from .vendor_direct_fulfillment_shipping_v1 import VendorDirectFulfillmentShippingV1
13
+
14
+
15
+ class VendorDirectFulfillmentShippingVersion(str, enum.Enum):
16
+ V1 = "v1"
17
+ V_2021_12_28 = "2021-12-28"
18
+ LATEST = "2021-12-28"
19
+
20
+
21
+ if TYPE_CHECKING:
22
+
23
+ class _VendorDirectFulfillmentShippingMeta(VersionedClientMeta):
24
+ @overload
25
+ def __call__(
26
+ cls,
27
+ *args: Any,
28
+ version: Literal[
29
+ VendorDirectFulfillmentShippingVersion.V_2021_12_28,
30
+ VendorDirectFulfillmentShippingVersion.LATEST,
31
+ "2021-12-28",
32
+ ],
33
+ **kwargs: Any,
34
+ ) -> VendorDirectFulfillmentShippingV20211228: ...
35
+
36
+ @overload
37
+ def __call__(
38
+ cls,
39
+ *args: Any,
40
+ version: Literal[VendorDirectFulfillmentShippingVersion.V1, "v1"],
41
+ **kwargs: Any,
42
+ ) -> VendorDirectFulfillmentShippingV1: ...
43
+
44
+ @overload
45
+ def __call__(
46
+ cls,
47
+ *args: Any,
48
+ version: None = None,
49
+ **kwargs: Any,
50
+ ) -> VendorDirectFulfillmentShippingV1: ...
51
+
52
+ @overload
53
+ def __call__(
54
+ cls,
55
+ *args: Any,
56
+ version: str | VendorDirectFulfillmentShippingVersion,
57
+ **kwargs: Any,
58
+ ) -> AsyncBaseClient: ...
59
+
60
+
61
+ else:
62
+ _VendorDirectFulfillmentShippingMeta = VersionedClientMeta
63
+
64
+
65
+ class VendorDirectFulfillmentShipping(
66
+ AsyncBaseClient, metaclass=_VendorDirectFulfillmentShippingMeta
67
+ ):
68
+ """Vendor Direct Fulfillment Shipping API client.
69
+
70
+ This class dispatches to a versioned Vendor Direct Fulfillment Shipping API client.
71
+
72
+ If you do not pass a version, the constructor returns the oldest supported implementation ("v1").
13
73
  """
14
74
 
15
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/shippingLabels", method="GET")
16
- async def get_shipping_labels(self, **kwargs) -> ApiResponse:
17
- """
18
- get_shipping_labels(self, **kwargs) -> ApiResponse
19
-
20
- Returns a list of shipping labels created during the time frame that you specify. You define that time frame using the createdAfter and createdBefore parameters. You must use both of these parameters. The date range to search must not be more than 7 days.
21
-
22
- **Usage Plans:**
23
-
24
- ====================================== ==============
25
- Rate (requests per second) Burst
26
- ====================================== ==============
27
- 10 10
28
- ====================================== ==============
29
-
30
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
31
-
32
- Args:
33
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.
34
- key limit:integer | The limit to the number of records returned.
35
- key createdAfter:string | * REQUIRED Shipping labels that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.
36
- key createdBefore:string | * REQUIRED Shipping labels that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.
37
- key sortOrder:string | Sort ASC or DESC by order creation date.
38
- key nextToken:string | Used for pagination when there are more ship labels than the specified result size limit. The token value is returned in the previous API call.
39
-
40
- Returns:
41
- ApiResponse:
42
- """
43
-
44
- return await self._request(kwargs.pop("path"), params=kwargs)
45
-
46
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/shippingLabels", method="POST")
47
- async def submit_shipping_label_request(self, **kwargs) -> ApiResponse:
48
- """
49
- submit_shipping_label_request(self, **kwargs) -> ApiResponse
50
-
51
- Creates a shipping label for a purchase order and returns a transactionId for reference.
52
-
53
- **Usage Plans:**
54
-
55
-
56
- ====================================== ==============
57
- Rate (requests per second) Burst
58
- ====================================== ==============
59
- 10 10
60
- ====================================== ==============
61
-
62
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
63
-
64
- Args:
65
- body: {
66
- "shippingLabelRequests": [
67
- {
68
- "purchaseOrderNumber": "string",
69
- "sellingParty": {
70
- "partyId": "string",
71
- "address": {
72
- "name": "string",
73
- "addressLine1": "string",
74
- "addressLine2": "string",
75
- "addressLine3": "string",
76
- "city": "string",
77
- "county": "string",
78
- "district": "string",
79
- "stateOrRegion": "string",
80
- "postalCode": "string",
81
- "countryCode": "string",
82
- "phone": "string"
83
- },
84
- "taxRegistrationDetails": [
85
- {
86
- "taxRegistrationType": "VAT",
87
- "taxRegistrationNumber": "string",
88
- "taxRegistrationAddress": {
89
- "name": "string",
90
- "addressLine1": "string",
91
- "addressLine2": "string",
92
- "addressLine3": "string",
93
- "city": "string",
94
- "county": "string",
95
- "district": "string",
96
- "stateOrRegion": "string",
97
- "postalCode": "string",
98
- "countryCode": "string",
99
- "phone": "string"
100
- },
101
- "taxRegistrationMessages": "string"
102
- }
103
- ]
104
- },
105
- "shipFromParty": {
106
- "partyId": "string",
107
- "address": {
108
- "name": "string",
109
- "addressLine1": "string",
110
- "addressLine2": "string",
111
- "addressLine3": "string",
112
- "city": "string",
113
- "county": "string",
114
- "district": "string",
115
- "stateOrRegion": "string",
116
- "postalCode": "string",
117
- "countryCode": "string",
118
- "phone": "string"
119
- },
120
- "taxRegistrationDetails": [
121
- {
122
- "taxRegistrationType": "VAT",
123
- "taxRegistrationNumber": "string",
124
- "taxRegistrationAddress": {
125
- "name": "string",
126
- "addressLine1": "string",
127
- "addressLine2": "string",
128
- "addressLine3": "string",
129
- "city": "string",
130
- "county": "string",
131
- "district": "string",
132
- "stateOrRegion": "string",
133
- "postalCode": "string",
134
- "countryCode": "string",
135
- "phone": "string"
136
- },
137
- "taxRegistrationMessages": "string"
138
- }
139
- ]
140
- },
141
- "containers": [
142
- {
143
- "containerType": "carton",
144
- "containerIdentifier": "string",
145
- "trackingNumber": "string",
146
- "manifestId": "string",
147
- "manifestDate": "string",
148
- "shipMethod": "string",
149
- "scacCode": "string",
150
- "carrier": "string",
151
- "containerSequenceNumber": 0,
152
- "dimensions": {
153
- "length": "string",
154
- "width": "string",
155
- "height": "string",
156
- "unitOfMeasure": "IN"
157
- },
158
- "weight": {
159
- "unitOfMeasure": "KG",
160
- "value": "string"
161
- },
162
- "packedItems": [
163
- {
164
- "itemSequenceNumber": 0,
165
- "buyerProductIdentifier": "string",
166
- "vendorProductIdentifier": "string",
167
- "packedQuantity": {
168
- "amount": 0,
169
- "unitOfMeasure": "string"
170
- }
171
- }
172
- ]
173
- }
174
- ]
175
- }
176
- ]
177
- }
178
-
179
- Returns:
180
- ApiResponse:
181
- """
182
-
183
- return await self._request(kwargs.pop("path"), data=kwargs, add_marketplace=False)
184
-
185
- @sp_endpoint(
186
- "/vendor/directFulfillment/shipping/v1/shippingLabels/{}", method="GET"
187
- )
188
- async def get_shipping_label(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
189
- """
190
- get_shipping_label(self, purchaseOrderNumber, **kwargs) -> ApiResponse
191
-
192
- Returns a shipping label for the purchaseOrderNumber that you specify.
193
-
194
- **Usage Plans:**
195
-
196
-
197
- ====================================== ==============
198
- Rate (requests per second) Burst
199
- ====================================== ==============
200
- 10 10
201
- ====================================== ==============
202
-
203
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
204
-
205
- Args:
206
- purchaseOrderNumber:string | * REQUIRED The purchase order number for which you want to return the shipping label. It should be the same purchaseOrderNumber as received in the order.
207
-
208
- Returns:
209
- ApiResponse:
210
- """
211
-
212
- return await self._request(
213
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
214
- )
215
-
216
- @sp_endpoint(
217
- "/vendor/directFulfillment/shipping/v1/shipmentConfirmations", method="POST"
218
- )
219
- async def submit_shipment_confirmations(self, **kwargs) -> ApiResponse:
220
- """
221
- submit_shipment_confirmations(self, **kwargs) -> ApiResponse
222
-
223
- Submits one or more shipment confirmations for vendor orders.
224
-
225
- **Usage Plans:**
226
-
227
-
228
- ====================================== ==============
229
- Rate (requests per second) Burst
230
- ====================================== ==============
231
- 10 10
232
- ====================================== ==============
233
-
234
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
235
-
236
- Args:
237
- body: {
238
- "shipmentConfirmations": [
239
- {
240
- "purchaseOrderNumber": "string",
241
- "shipmentDetails": {
242
- "shippedDate": "2019-08-24T14:15:22Z",
243
- "shipmentStatus": "SHIPPED",
244
- "isPriorityShipment": true,
245
- "vendorOrderNumber": "string",
246
- "estimatedDeliveryDate": "2019-08-24T14:15:22Z"
247
- },
248
- "sellingParty": {
249
- "partyId": "string",
250
- "address": {
251
- "name": "string",
252
- "addressLine1": "string",
253
- "addressLine2": "string",
254
- "addressLine3": "string",
255
- "city": "string",
256
- "county": "string",
257
- "district": "string",
258
- "stateOrRegion": "string",
259
- "postalCode": "string",
260
- "countryCode": "string",
261
- "phone": "string"
262
- },
263
- "taxRegistrationDetails": [
264
- {
265
- "taxRegistrationType": "VAT",
266
- "taxRegistrationNumber": "string",
267
- "taxRegistrationAddress": {
268
- "name": "string",
269
- "addressLine1": "string",
270
- "addressLine2": "string",
271
- "addressLine3": "string",
272
- "city": "string",
273
- "county": "string",
274
- "district": "string",
275
- "stateOrRegion": "string",
276
- "postalCode": "string",
277
- "countryCode": "string",
278
- "phone": "string"
279
- },
280
- "taxRegistrationMessages": "string"
281
- }
282
- ]
283
- },
284
- "shipFromParty": {
285
- "partyId": "string",
286
- "address": {
287
- "name": "string",
288
- "addressLine1": "string",
289
- "addressLine2": "string",
290
- "addressLine3": "string",
291
- "city": "string",
292
- "county": "string",
293
- "district": "string",
294
- "stateOrRegion": "string",
295
- "postalCode": "string",
296
- "countryCode": "string",
297
- "phone": "string"
298
- },
299
- "taxRegistrationDetails": [
300
- {
301
- "taxRegistrationType": "VAT",
302
- "taxRegistrationNumber": "string",
303
- "taxRegistrationAddress": {
304
- "name": "string",
305
- "addressLine1": "string",
306
- "addressLine2": "string",
307
- "addressLine3": "string",
308
- "city": "string",
309
- "county": "string",
310
- "district": "string",
311
- "stateOrRegion": "string",
312
- "postalCode": "string",
313
- "countryCode": "string",
314
- "phone": "string"
315
- },
316
- "taxRegistrationMessages": "string"
317
- }
318
- ]
319
- },
320
- "items": [
321
- {
322
- "itemSequenceNumber": 0,
323
- "buyerProductIdentifier": "string",
324
- "vendorProductIdentifier": "string",
325
- "shippedQuantity": {
326
- "amount": 0,
327
- "unitOfMeasure": "string"
328
- }
329
- }
330
- ],
331
- "containers": [
332
- {
333
- "containerType": "carton",
334
- "containerIdentifier": "string",
335
- "trackingNumber": "string",
336
- "manifestId": "string",
337
- "manifestDate": "string",
338
- "shipMethod": "string",
339
- "scacCode": "string",
340
- "carrier": "string",
341
- "containerSequenceNumber": 0,
342
- "dimensions": {
343
- "length": "string",
344
- "width": "string",
345
- "height": "string",
346
- "unitOfMeasure": "IN"
347
- },
348
- "weight": {
349
- "unitOfMeasure": "KG",
350
- "value": "string"
351
- },
352
- "packedItems": [
353
- {
354
- "itemSequenceNumber": 0,
355
- "buyerProductIdentifier": "string",
356
- "vendorProductIdentifier": "string",
357
- "packedQuantity": {
358
- "amount": 0,
359
- "unitOfMeasure": "string"
360
- }
361
- }
362
- ]
363
- }
364
- ]
365
- }
366
- ]
367
- }
368
-
369
- Returns:
370
- ApiResponse:
371
- """
372
-
373
- return await self._request(kwargs.pop("path"), data=kwargs, add_marketplace=False)
374
-
375
- @sp_endpoint(
376
- "/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates", method="POST"
377
- )
378
- async def submit_shipment_status_updates(self, **kwargs) -> ApiResponse:
379
- """
380
- submit_shipment_status_updates(self, **kwargs) -> ApiResponse
381
-
382
- This API call is only to be used by Vendor-Own-Carrier (VOC) vendors. Calling this API will submit a shipment status update for the package that a vendor has shipped. It will provide the Amazon customer visibility on their order, when the package is outside of Amazon Network visibility.
383
-
384
- **Usage Plans:**
385
-
386
- ====================================== ==============
387
- Rate (requests per second) Burst
388
- ====================================== ==============
389
- 10 10
390
- ====================================== ==============
391
-
392
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
393
-
394
- Args:
395
- body: {
396
- "shipmentStatusUpdates": [
397
- {
398
- "purchaseOrderNumber": "string",
399
- "sellingParty": {
400
- "partyId": "string",
401
- "address": {
402
- "name": "string",
403
- "addressLine1": "string",
404
- "addressLine2": "string",
405
- "addressLine3": "string",
406
- "city": "string",
407
- "county": "string",
408
- "district": "string",
409
- "stateOrRegion": "string",
410
- "postalCode": "string",
411
- "countryCode": "string",
412
- "phone": "string"
413
- },
414
- "taxRegistrationDetails": [
415
- {
416
- "taxRegistrationType": "VAT",
417
- "taxRegistrationNumber": "string",
418
- "taxRegistrationAddress": {
419
- "name": "string",
420
- "addressLine1": "string",
421
- "addressLine2": "string",
422
- "addressLine3": "string",
423
- "city": "string",
424
- "county": "string",
425
- "district": "string",
426
- "stateOrRegion": "string",
427
- "postalCode": "string",
428
- "countryCode": "string",
429
- "phone": "string"
430
- },
431
- "taxRegistrationMessages": "string"
432
- }
433
- ]
434
- },
435
- "shipFromParty": {
436
- "partyId": "string",
437
- "address": {
438
- "name": "string",
439
- "addressLine1": "string",
440
- "addressLine2": "string",
441
- "addressLine3": "string",
442
- "city": "string",
443
- "county": "string",
444
- "district": "string",
445
- "stateOrRegion": "string",
446
- "postalCode": "string",
447
- "countryCode": "string",
448
- "phone": "string"
449
- },
450
- "taxRegistrationDetails": [
451
- {
452
- "taxRegistrationType": "VAT",
453
- "taxRegistrationNumber": "string",
454
- "taxRegistrationAddress": {
455
- "name": "string",
456
- "addressLine1": "string",
457
- "addressLine2": "string",
458
- "addressLine3": "string",
459
- "city": "string",
460
- "county": "string",
461
- "district": "string",
462
- "stateOrRegion": "string",
463
- "postalCode": "string",
464
- "countryCode": "string",
465
- "phone": "string"
466
- },
467
- "taxRegistrationMessages": "string"
468
- }
469
- ]
470
- },
471
- "statusUpdateDetails": {
472
- "trackingNumber": "string",
473
- "statusCode": "string",
474
- "reasonCode": "string",
475
- "statusDateTime": "2019-08-24T14:15:22Z",
476
- "statusLocationAddress": {
477
- "name": "string",
478
- "addressLine1": "string",
479
- "addressLine2": "string",
480
- "addressLine3": "string",
481
- "city": "string",
482
- "county": "string",
483
- "district": "string",
484
- "stateOrRegion": "string",
485
- "postalCode": "string",
486
- "countryCode": "string",
487
- "phone": "string"
488
- },
489
- "shipmentSchedule": {
490
- "estimatedDeliveryDateTime": "2019-08-24T14:15:22Z",
491
- "apptWindowStartDateTime": "2019-08-24T14:15:22Z",
492
- "apptWindowEndDateTime": "2019-08-24T14:15:22Z"
493
- }
494
- }
495
- }
496
- ]
497
- }
498
-
499
- Returns:
500
- ApiResponse:
501
- """
502
-
503
- return await self._request(kwargs.pop("path"), data=kwargs)
504
-
505
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/customerInvoices", method="GET")
506
- async def get_customer_invoices(self, **kwargs) -> ApiResponse:
507
- """
508
- get_customer_invoices(self, **kwargs) -> ApiResponse
509
-
510
- Returns a list of customer invoices created during a time frame that you specify. You define the time frame using the createdAfter and createdBefore parameters. You must use both of these parameters. The date range to search must be no more than 7 days.
511
-
512
- **Usage Plans:**
513
-
514
-
515
- ====================================== ==============
516
- Rate (requests per second) Burst
517
- ====================================== ==============
518
- 10 10
519
- ====================================== ==============
520
-
521
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
522
-
523
- Args:
524
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.
525
- key limit:integer | The limit to the number of records returned
526
- key createdAfter:string | * REQUIRED Orders that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.
527
- key createdBefore:string | * REQUIRED Orders that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.
528
- key sortOrder:string | Sort ASC or DESC by order creation date.
529
- key nextToken:string | Used for pagination when there are more orders than the specified result size limit. The token value is returned in the previous API call.
530
-
531
- Returns:
532
- ApiResponse:
533
- """
534
-
535
- return await self._request(kwargs.pop("path"), params=kwargs)
536
-
537
- @sp_endpoint(
538
- "/vendor/directFulfillment/shipping/v1/customerInvoices/{}", method="GET"
539
- )
540
- async def get_customer_invoice(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
541
- """
542
- get_customer_invoice(self, purchaseOrderNumber, **kwargs) -> ApiResponse
543
-
544
- Returns a customer invoice based on the purchaseOrderNumber that you specify.
545
-
546
- **Usage Plans:**
547
-
548
-
549
- ====================================== ==============
550
- Rate (requests per second) Burst
551
- ====================================== ==============
552
- 10 10
553
- ====================================== ==============
554
-
555
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
556
-
557
- Args:
558
- purchaseOrderNumber:string | * REQUIRED Purchase order number of the shipment for which to return the invoice.
559
-
560
- Returns:
561
- ApiResponse:
562
- """
563
-
564
- return await self._request(
565
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
566
- )
567
-
568
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/packingSlips", method="GET")
569
- async def get_packing_slips(self, **kwargs) -> ApiResponse:
570
- """
571
- get_packing_slips(self, **kwargs) -> ApiResponse
572
-
573
- Returns a list of packing slips for the purchase orders that match the criteria specified. Date range to search must not be more than 7 days.
574
-
575
- **Usage Plans:**
576
-
577
-
578
- ====================================== ==============
579
- Rate (requests per second) Burst
580
- ====================================== ==============
581
- 10 10
582
- ====================================== ==============
583
-
584
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
585
-
586
- Args:
587
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified the result will contain orders for all warehouses.
588
- key limit:integer | The limit to the number of records returned
589
- key createdAfter:string | * REQUIRED Packing slips that became available after this date and time will be included in the result. Must be in ISO-8601 date/time format.
590
- key createdBefore:string | * REQUIRED Packing slips that became available before this date and time will be included in the result. Must be in ISO-8601 date/time format.
591
- key sortOrder:string | Sort ASC or DESC by packing slip creation date.
592
- key nextToken:string | Used for pagination when there are more packing slips than the specified result size limit. The token value is returned in the previous API call.
593
-
594
- Returns:
595
- ApiResponse:
596
- """
597
-
598
- return await self._request(kwargs.pop("path"), params=kwargs)
599
-
600
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/packingSlips/{}", method="GET")
601
- async def get_packing_slip(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
602
- """
603
- get_packing_slip(self, purchaseOrderNumber, **kwargs) -> ApiResponse
604
-
605
- Returns a packing slip based on the purchaseOrderNumber that you specify.
606
-
607
- **Usage Plans:**
608
-
609
-
610
- ====================================== ==============
611
- Rate (requests per second) Burst
612
- ====================================== ==============
613
- 10 10
614
- ====================================== ==============
615
-
616
- The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
617
-
618
- Args:
619
- purchaseOrderNumber:string | * REQUIRED The purchaseOrderNumber for the packing slip you want.
620
-
621
- Returns:
622
- ApiResponse:
623
- """
624
-
625
- return await self._request(
626
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
627
- )
75
+ if TYPE_CHECKING:
76
+ @overload
77
+ def __new__(
78
+ cls,
79
+ *args: Any,
80
+ version: Literal[
81
+ VendorDirectFulfillmentShippingVersion.V_2021_12_28,
82
+ VendorDirectFulfillmentShippingVersion.LATEST,
83
+ "2021-12-28",
84
+ ],
85
+ **kwargs: Any,
86
+ ) -> VendorDirectFulfillmentShippingV20211228: ...
87
+
88
+ @overload
89
+ def __new__(
90
+ cls,
91
+ *args: Any,
92
+ version: Literal[VendorDirectFulfillmentShippingVersion.V1, "v1"],
93
+ **kwargs: Any,
94
+ ) -> VendorDirectFulfillmentShippingV1: ...
95
+
96
+ @overload
97
+ def __new__(
98
+ cls,
99
+ *args: Any,
100
+ version: None = None,
101
+ **kwargs: Any,
102
+ ) -> VendorDirectFulfillmentShippingV1: ...
103
+
104
+ @overload
105
+ def __new__(
106
+ cls,
107
+ *args: Any,
108
+ version: str | VendorDirectFulfillmentShippingVersion,
109
+ **kwargs: Any,
110
+ ) -> AsyncBaseClient: ...
111
+
112
+ _DISPATCH = True
113
+
114
+ _DEFAULT_VERSION = "v1"
115
+
116
+ _VERSION_MAP = {
117
+ "v1": VendorDirectFulfillmentShippingV1,
118
+ "2021-12-28": VendorDirectFulfillmentShippingV20211228,
119
+ }
120
+
121
+ _VERSION_ALIASES = {
122
+ "v1": "v1",
123
+ "2021-12-28": "2021-12-28",
124
+ }