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,626 +1,124 @@
1
- import urllib.parse
2
-
3
- from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
4
-
5
-
6
- class VendorDirectFulfillmentShipping(Client):
1
+ from __future__ import annotations
2
+
3
+ import enum
4
+ from typing import Any, Literal, TYPE_CHECKING, overload
5
+ from sp_api.util.versioned_client import VersionedClientMeta
6
+
7
+ from sp_api.base import Client
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
+ ) -> Client: ...
59
+
60
+
61
+ else:
62
+ _VendorDirectFulfillmentShippingMeta = VersionedClientMeta
63
+
64
+
65
+ class VendorDirectFulfillmentShipping(
66
+ Client, 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").
7
73
  """
8
- VendorDirectFulfillmentShipping SP-API Client
9
- :link:
10
-
11
- The Selling Partner API for Direct Fulfillment Shipping provides programmatic access to a direct fulfillment vendor's shipping data.
12
- """
13
-
14
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/shippingLabels", method="GET")
15
- def get_shipping_labels(self, **kwargs) -> ApiResponse:
16
- """
17
- get_shipping_labels(self, **kwargs) -> ApiResponse
18
-
19
- 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.
20
-
21
- **Usage Plans:**
22
-
23
- ====================================== ==============
24
- Rate (requests per second) Burst
25
- ====================================== ==============
26
- 10 10
27
- ====================================== ==============
28
-
29
- 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.
30
-
31
- Args:
32
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.
33
- key limit:integer | The limit to the number of records returned.
34
- 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.
35
- 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.
36
- key sortOrder:string | Sort ASC or DESC by order creation date.
37
- 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.
38
-
39
- Returns:
40
- ApiResponse:
41
- """
42
-
43
- return self._request(kwargs.pop("path"), params=kwargs)
44
-
45
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/shippingLabels", method="POST")
46
- def submit_shipping_label_request(self, **kwargs) -> ApiResponse:
47
- """
48
- submit_shipping_label_request(self, **kwargs) -> ApiResponse
49
-
50
- Creates a shipping label for a purchase order and returns a transactionId for reference.
51
-
52
- **Usage Plans:**
53
-
54
-
55
- ====================================== ==============
56
- Rate (requests per second) Burst
57
- ====================================== ==============
58
- 10 10
59
- ====================================== ==============
60
-
61
- 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.
62
-
63
- Args:
64
- body: {
65
- "shippingLabelRequests": [
66
- {
67
- "purchaseOrderNumber": "string",
68
- "sellingParty": {
69
- "partyId": "string",
70
- "address": {
71
- "name": "string",
72
- "addressLine1": "string",
73
- "addressLine2": "string",
74
- "addressLine3": "string",
75
- "city": "string",
76
- "county": "string",
77
- "district": "string",
78
- "stateOrRegion": "string",
79
- "postalCode": "string",
80
- "countryCode": "string",
81
- "phone": "string"
82
- },
83
- "taxRegistrationDetails": [
84
- {
85
- "taxRegistrationType": "VAT",
86
- "taxRegistrationNumber": "string",
87
- "taxRegistrationAddress": {
88
- "name": "string",
89
- "addressLine1": "string",
90
- "addressLine2": "string",
91
- "addressLine3": "string",
92
- "city": "string",
93
- "county": "string",
94
- "district": "string",
95
- "stateOrRegion": "string",
96
- "postalCode": "string",
97
- "countryCode": "string",
98
- "phone": "string"
99
- },
100
- "taxRegistrationMessages": "string"
101
- }
102
- ]
103
- },
104
- "shipFromParty": {
105
- "partyId": "string",
106
- "address": {
107
- "name": "string",
108
- "addressLine1": "string",
109
- "addressLine2": "string",
110
- "addressLine3": "string",
111
- "city": "string",
112
- "county": "string",
113
- "district": "string",
114
- "stateOrRegion": "string",
115
- "postalCode": "string",
116
- "countryCode": "string",
117
- "phone": "string"
118
- },
119
- "taxRegistrationDetails": [
120
- {
121
- "taxRegistrationType": "VAT",
122
- "taxRegistrationNumber": "string",
123
- "taxRegistrationAddress": {
124
- "name": "string",
125
- "addressLine1": "string",
126
- "addressLine2": "string",
127
- "addressLine3": "string",
128
- "city": "string",
129
- "county": "string",
130
- "district": "string",
131
- "stateOrRegion": "string",
132
- "postalCode": "string",
133
- "countryCode": "string",
134
- "phone": "string"
135
- },
136
- "taxRegistrationMessages": "string"
137
- }
138
- ]
139
- },
140
- "containers": [
141
- {
142
- "containerType": "carton",
143
- "containerIdentifier": "string",
144
- "trackingNumber": "string",
145
- "manifestId": "string",
146
- "manifestDate": "string",
147
- "shipMethod": "string",
148
- "scacCode": "string",
149
- "carrier": "string",
150
- "containerSequenceNumber": 0,
151
- "dimensions": {
152
- "length": "string",
153
- "width": "string",
154
- "height": "string",
155
- "unitOfMeasure": "IN"
156
- },
157
- "weight": {
158
- "unitOfMeasure": "KG",
159
- "value": "string"
160
- },
161
- "packedItems": [
162
- {
163
- "itemSequenceNumber": 0,
164
- "buyerProductIdentifier": "string",
165
- "vendorProductIdentifier": "string",
166
- "packedQuantity": {
167
- "amount": 0,
168
- "unitOfMeasure": "string"
169
- }
170
- }
171
- ]
172
- }
173
- ]
174
- }
175
- ]
176
- }
177
-
178
- Returns:
179
- ApiResponse:
180
- """
181
-
182
- return self._request(kwargs.pop("path"), data=kwargs, add_marketplace=False)
183
-
184
- @sp_endpoint(
185
- "/vendor/directFulfillment/shipping/v1/shippingLabels/{}", method="GET"
186
- )
187
- def get_shipping_label(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
188
- """
189
- get_shipping_label(self, purchaseOrderNumber, **kwargs) -> ApiResponse
190
-
191
- Returns a shipping label for the purchaseOrderNumber that you specify.
192
-
193
- **Usage Plans:**
194
-
195
-
196
- ====================================== ==============
197
- Rate (requests per second) Burst
198
- ====================================== ==============
199
- 10 10
200
- ====================================== ==============
201
-
202
- 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.
203
-
204
- Args:
205
- 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.
206
-
207
- Returns:
208
- ApiResponse:
209
- """
210
-
211
- return self._request(
212
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
213
- )
214
-
215
- @sp_endpoint(
216
- "/vendor/directFulfillment/shipping/v1/shipmentConfirmations", method="POST"
217
- )
218
- def submit_shipment_confirmations(self, **kwargs) -> ApiResponse:
219
- """
220
- submit_shipment_confirmations(self, **kwargs) -> ApiResponse
221
-
222
- Submits one or more shipment confirmations for vendor orders.
223
-
224
- **Usage Plans:**
225
-
226
-
227
- ====================================== ==============
228
- Rate (requests per second) Burst
229
- ====================================== ==============
230
- 10 10
231
- ====================================== ==============
232
-
233
- 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.
234
-
235
- Args:
236
- body: {
237
- "shipmentConfirmations": [
238
- {
239
- "purchaseOrderNumber": "string",
240
- "shipmentDetails": {
241
- "shippedDate": "2019-08-24T14:15:22Z",
242
- "shipmentStatus": "SHIPPED",
243
- "isPriorityShipment": true,
244
- "vendorOrderNumber": "string",
245
- "estimatedDeliveryDate": "2019-08-24T14:15:22Z"
246
- },
247
- "sellingParty": {
248
- "partyId": "string",
249
- "address": {
250
- "name": "string",
251
- "addressLine1": "string",
252
- "addressLine2": "string",
253
- "addressLine3": "string",
254
- "city": "string",
255
- "county": "string",
256
- "district": "string",
257
- "stateOrRegion": "string",
258
- "postalCode": "string",
259
- "countryCode": "string",
260
- "phone": "string"
261
- },
262
- "taxRegistrationDetails": [
263
- {
264
- "taxRegistrationType": "VAT",
265
- "taxRegistrationNumber": "string",
266
- "taxRegistrationAddress": {
267
- "name": "string",
268
- "addressLine1": "string",
269
- "addressLine2": "string",
270
- "addressLine3": "string",
271
- "city": "string",
272
- "county": "string",
273
- "district": "string",
274
- "stateOrRegion": "string",
275
- "postalCode": "string",
276
- "countryCode": "string",
277
- "phone": "string"
278
- },
279
- "taxRegistrationMessages": "string"
280
- }
281
- ]
282
- },
283
- "shipFromParty": {
284
- "partyId": "string",
285
- "address": {
286
- "name": "string",
287
- "addressLine1": "string",
288
- "addressLine2": "string",
289
- "addressLine3": "string",
290
- "city": "string",
291
- "county": "string",
292
- "district": "string",
293
- "stateOrRegion": "string",
294
- "postalCode": "string",
295
- "countryCode": "string",
296
- "phone": "string"
297
- },
298
- "taxRegistrationDetails": [
299
- {
300
- "taxRegistrationType": "VAT",
301
- "taxRegistrationNumber": "string",
302
- "taxRegistrationAddress": {
303
- "name": "string",
304
- "addressLine1": "string",
305
- "addressLine2": "string",
306
- "addressLine3": "string",
307
- "city": "string",
308
- "county": "string",
309
- "district": "string",
310
- "stateOrRegion": "string",
311
- "postalCode": "string",
312
- "countryCode": "string",
313
- "phone": "string"
314
- },
315
- "taxRegistrationMessages": "string"
316
- }
317
- ]
318
- },
319
- "items": [
320
- {
321
- "itemSequenceNumber": 0,
322
- "buyerProductIdentifier": "string",
323
- "vendorProductIdentifier": "string",
324
- "shippedQuantity": {
325
- "amount": 0,
326
- "unitOfMeasure": "string"
327
- }
328
- }
329
- ],
330
- "containers": [
331
- {
332
- "containerType": "carton",
333
- "containerIdentifier": "string",
334
- "trackingNumber": "string",
335
- "manifestId": "string",
336
- "manifestDate": "string",
337
- "shipMethod": "string",
338
- "scacCode": "string",
339
- "carrier": "string",
340
- "containerSequenceNumber": 0,
341
- "dimensions": {
342
- "length": "string",
343
- "width": "string",
344
- "height": "string",
345
- "unitOfMeasure": "IN"
346
- },
347
- "weight": {
348
- "unitOfMeasure": "KG",
349
- "value": "string"
350
- },
351
- "packedItems": [
352
- {
353
- "itemSequenceNumber": 0,
354
- "buyerProductIdentifier": "string",
355
- "vendorProductIdentifier": "string",
356
- "packedQuantity": {
357
- "amount": 0,
358
- "unitOfMeasure": "string"
359
- }
360
- }
361
- ]
362
- }
363
- ]
364
- }
365
- ]
366
- }
367
-
368
- Returns:
369
- ApiResponse:
370
- """
371
-
372
- return self._request(kwargs.pop("path"), data=kwargs, add_marketplace=False)
373
-
374
- @sp_endpoint(
375
- "/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates", method="POST"
376
- )
377
- def submit_shipment_status_updates(self, **kwargs) -> ApiResponse:
378
- """
379
- submit_shipment_status_updates(self, **kwargs) -> ApiResponse
380
-
381
- 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.
382
-
383
- **Usage Plans:**
384
-
385
- ====================================== ==============
386
- Rate (requests per second) Burst
387
- ====================================== ==============
388
- 10 10
389
- ====================================== ==============
390
-
391
- 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.
392
-
393
- Args:
394
- body: {
395
- "shipmentStatusUpdates": [
396
- {
397
- "purchaseOrderNumber": "string",
398
- "sellingParty": {
399
- "partyId": "string",
400
- "address": {
401
- "name": "string",
402
- "addressLine1": "string",
403
- "addressLine2": "string",
404
- "addressLine3": "string",
405
- "city": "string",
406
- "county": "string",
407
- "district": "string",
408
- "stateOrRegion": "string",
409
- "postalCode": "string",
410
- "countryCode": "string",
411
- "phone": "string"
412
- },
413
- "taxRegistrationDetails": [
414
- {
415
- "taxRegistrationType": "VAT",
416
- "taxRegistrationNumber": "string",
417
- "taxRegistrationAddress": {
418
- "name": "string",
419
- "addressLine1": "string",
420
- "addressLine2": "string",
421
- "addressLine3": "string",
422
- "city": "string",
423
- "county": "string",
424
- "district": "string",
425
- "stateOrRegion": "string",
426
- "postalCode": "string",
427
- "countryCode": "string",
428
- "phone": "string"
429
- },
430
- "taxRegistrationMessages": "string"
431
- }
432
- ]
433
- },
434
- "shipFromParty": {
435
- "partyId": "string",
436
- "address": {
437
- "name": "string",
438
- "addressLine1": "string",
439
- "addressLine2": "string",
440
- "addressLine3": "string",
441
- "city": "string",
442
- "county": "string",
443
- "district": "string",
444
- "stateOrRegion": "string",
445
- "postalCode": "string",
446
- "countryCode": "string",
447
- "phone": "string"
448
- },
449
- "taxRegistrationDetails": [
450
- {
451
- "taxRegistrationType": "VAT",
452
- "taxRegistrationNumber": "string",
453
- "taxRegistrationAddress": {
454
- "name": "string",
455
- "addressLine1": "string",
456
- "addressLine2": "string",
457
- "addressLine3": "string",
458
- "city": "string",
459
- "county": "string",
460
- "district": "string",
461
- "stateOrRegion": "string",
462
- "postalCode": "string",
463
- "countryCode": "string",
464
- "phone": "string"
465
- },
466
- "taxRegistrationMessages": "string"
467
- }
468
- ]
469
- },
470
- "statusUpdateDetails": {
471
- "trackingNumber": "string",
472
- "statusCode": "string",
473
- "reasonCode": "string",
474
- "statusDateTime": "2019-08-24T14:15:22Z",
475
- "statusLocationAddress": {
476
- "name": "string",
477
- "addressLine1": "string",
478
- "addressLine2": "string",
479
- "addressLine3": "string",
480
- "city": "string",
481
- "county": "string",
482
- "district": "string",
483
- "stateOrRegion": "string",
484
- "postalCode": "string",
485
- "countryCode": "string",
486
- "phone": "string"
487
- },
488
- "shipmentSchedule": {
489
- "estimatedDeliveryDateTime": "2019-08-24T14:15:22Z",
490
- "apptWindowStartDateTime": "2019-08-24T14:15:22Z",
491
- "apptWindowEndDateTime": "2019-08-24T14:15:22Z"
492
- }
493
- }
494
- }
495
- ]
496
- }
497
-
498
- Returns:
499
- ApiResponse:
500
- """
501
-
502
- return self._request(kwargs.pop("path"), data=kwargs)
503
-
504
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/customerInvoices", method="GET")
505
- def get_customer_invoices(self, **kwargs) -> ApiResponse:
506
- """
507
- get_customer_invoices(self, **kwargs) -> ApiResponse
508
-
509
- 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.
510
-
511
- **Usage Plans:**
512
-
513
-
514
- ====================================== ==============
515
- Rate (requests per second) Burst
516
- ====================================== ==============
517
- 10 10
518
- ====================================== ==============
519
-
520
- 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.
521
-
522
- Args:
523
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified, the result will contain orders for all warehouses.
524
- key limit:integer | The limit to the number of records returned
525
- 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.
526
- 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.
527
- key sortOrder:string | Sort ASC or DESC by order creation date.
528
- 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.
529
-
530
- Returns:
531
- ApiResponse:
532
- """
533
-
534
- return self._request(kwargs.pop("path"), params=kwargs)
535
-
536
- @sp_endpoint(
537
- "/vendor/directFulfillment/shipping/v1/customerInvoices/{}", method="GET"
538
- )
539
- def get_customer_invoice(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
540
- """
541
- get_customer_invoice(self, purchaseOrderNumber, **kwargs) -> ApiResponse
542
-
543
- Returns a customer invoice based on the purchaseOrderNumber that you specify.
544
-
545
- **Usage Plans:**
546
-
547
-
548
- ====================================== ==============
549
- Rate (requests per second) Burst
550
- ====================================== ==============
551
- 10 10
552
- ====================================== ==============
553
-
554
- 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.
555
-
556
- Args:
557
- purchaseOrderNumber:string | * REQUIRED Purchase order number of the shipment for which to return the invoice.
558
-
559
- Returns:
560
- ApiResponse:
561
- """
562
-
563
- return self._request(
564
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
565
- )
566
-
567
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/packingSlips", method="GET")
568
- def get_packing_slips(self, **kwargs) -> ApiResponse:
569
- """
570
- get_packing_slips(self, **kwargs) -> ApiResponse
571
-
572
- 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.
573
-
574
- **Usage Plans:**
575
-
576
-
577
- ====================================== ==============
578
- Rate (requests per second) Burst
579
- ====================================== ==============
580
- 10 10
581
- ====================================== ==============
582
-
583
- 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.
584
-
585
- Args:
586
- key shipFromPartyId:string | The vendor warehouseId for order fulfillment. If not specified the result will contain orders for all warehouses.
587
- key limit:integer | The limit to the number of records returned
588
- 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.
589
- 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.
590
- key sortOrder:string | Sort ASC or DESC by packing slip creation date.
591
- 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.
592
-
593
- Returns:
594
- ApiResponse:
595
- """
596
-
597
- return self._request(kwargs.pop("path"), params=kwargs)
598
-
599
- @sp_endpoint("/vendor/directFulfillment/shipping/v1/packingSlips/{}", method="GET")
600
- def get_packing_slip(self, purchaseOrderNumber, **kwargs) -> ApiResponse:
601
- """
602
- get_packing_slip(self, purchaseOrderNumber, **kwargs) -> ApiResponse
603
-
604
- Returns a packing slip based on the purchaseOrderNumber that you specify.
605
-
606
- **Usage Plans:**
607
-
608
-
609
- ====================================== ==============
610
- Rate (requests per second) Burst
611
- ====================================== ==============
612
- 10 10
613
- ====================================== ==============
614
-
615
- 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.
616
-
617
- Args:
618
- purchaseOrderNumber:string | * REQUIRED The purchaseOrderNumber for the packing slip you want.
619
-
620
- Returns:
621
- ApiResponse:
622
- """
623
74
 
624
- return self._request(
625
- fill_query_params(kwargs.pop("path"), purchaseOrderNumber), params=kwargs
626
- )
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
+ ) -> Client: ...
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
+ }