peddler 2.4.5 → 3.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +402 -140
- data/lib/peddler/api/amazon_warehousing_and_distribution_2024_05_09.rb +92 -0
- data/lib/peddler/api/aplus_content_2020_11_01.rb +246 -0
- data/lib/peddler/api/application_integrations_2024_04_01.rb +56 -0
- data/lib/peddler/api/application_management_2023_11_30.rb +35 -0
- data/lib/peddler/api/catalog_items_2020_12_01.rb +81 -0
- data/lib/peddler/api/catalog_items_2022_04_01.rb +93 -0
- data/lib/peddler/api/catalog_items_v0.rb +103 -0
- data/lib/peddler/api/data_kiosk_2023_11_15.rb +108 -0
- data/lib/peddler/api/easy_ship_2022_03_23.rb +127 -0
- data/lib/peddler/api/fba_inbound_eligibility_v1.rb +44 -0
- data/lib/peddler/api/fba_inventory_v1.rb +122 -0
- data/lib/peddler/api/feeds_2021_06_30.rb +122 -0
- data/lib/peddler/api/finances_2024_06_19.rb +50 -0
- data/lib/peddler/api/finances_v0.rb +148 -0
- data/lib/peddler/api/fulfillment_inbound_2024_03_20.rb +759 -0
- data/lib/peddler/api/fulfillment_inbound_v0.rb +352 -0
- data/lib/peddler/api/fulfillment_outbound_2020_07_01.rb +259 -0
- data/lib/peddler/api/invoices_2024_06_19.rb +180 -0
- data/lib/peddler/api/listings_items_2020_09_01.rb +95 -0
- data/lib/peddler/api/listings_items_2021_08_01.rb +170 -0
- data/lib/peddler/api/listings_restrictions_2021_08_01.rb +47 -0
- data/lib/peddler/api/merchant_fulfillment_v0.rb +80 -0
- data/lib/peddler/api/messaging_v1.rb +273 -0
- data/lib/peddler/api/notifications_v1.rb +145 -0
- data/lib/peddler/api/orders_v0.rb +279 -0
- data/lib/peddler/api/product_fees_v0.rb +77 -0
- data/lib/peddler/api/product_pricing_2022_05_01.rb +54 -0
- data/lib/peddler/api/product_pricing_v0.rb +162 -0
- data/lib/peddler/api/product_type_definitions_2020_09_01.rb +86 -0
- data/lib/peddler/api/replenishment_2022_11_07.rb +57 -0
- data/lib/peddler/api/reports_2021_06_30.rb +163 -0
- data/lib/peddler/api/sales_v1.rb +77 -0
- data/lib/peddler/api/sellers_v1.rb +45 -0
- data/lib/peddler/api/services_v1.rb +348 -0
- data/lib/peddler/api/shipment_invoicing_v0.rb +59 -0
- data/lib/peddler/api/shipping_v1.rb +132 -0
- data/lib/peddler/api/shipping_v2.rb +319 -0
- data/lib/peddler/api/solicitations_v1.rb +63 -0
- data/lib/peddler/api/supply_sources_2020_07_01.rb +100 -0
- data/lib/peddler/api/tokens_2021_03_01.rb +38 -0
- data/lib/peddler/api/uploads_2020_11_01.rb +50 -0
- data/lib/peddler/api/vendor_direct_fulfillment_inventory_v1.rb +32 -0
- data/lib/peddler/api/vendor_direct_fulfillment_orders_2021_12_28.rb +84 -0
- data/lib/peddler/api/vendor_direct_fulfillment_orders_v1.rb +84 -0
- data/lib/peddler/api/vendor_direct_fulfillment_payments_v1.rb +31 -0
- data/lib/peddler/api/vendor_direct_fulfillment_sandbox_test_data_2021_10_28.rb +45 -0
- data/lib/peddler/api/vendor_direct_fulfillment_shipping_2021_12_28.rb +203 -0
- data/lib/peddler/api/vendor_direct_fulfillment_shipping_v1.rb +189 -0
- data/lib/peddler/api/vendor_direct_fulfillment_transactions_2021_12_28.rb +32 -0
- data/lib/peddler/api/vendor_direct_fulfillment_transactions_v1.rb +32 -0
- data/lib/peddler/api/vendor_invoices_v1.rb +30 -0
- data/lib/peddler/api/vendor_orders_v1.rb +159 -0
- data/lib/peddler/api/vendor_shipments_v1.rb +132 -0
- data/lib/peddler/api/vendor_transaction_status_v1.rb +33 -0
- data/lib/peddler/api.rb +138 -0
- data/lib/peddler/endpoint.rb +51 -0
- data/lib/peddler/error.rb +31 -0
- data/lib/peddler/marketplace.rb +38 -68
- data/lib/peddler/token.rb +70 -0
- data/lib/peddler/version.rb +1 -1
- data/lib/peddler.rb +56 -1
- metadata +74 -80
- data/lib/mws/easy_ship/client.rb +0 -93
- data/lib/mws/easy_ship.rb +0 -3
- data/lib/mws/feeds/client.rb +0 -122
- data/lib/mws/feeds.rb +0 -3
- data/lib/mws/finances/client.rb +0 -82
- data/lib/mws/finances.rb +0 -3
- data/lib/mws/fulfillment_inbound_shipment/client.rb +0 -388
- data/lib/mws/fulfillment_inbound_shipment.rb +0 -3
- data/lib/mws/fulfillment_inventory/client.rb +0 -57
- data/lib/mws/fulfillment_inventory.rb +0 -3
- data/lib/mws/fulfillment_outbound_shipment/client.rb +0 -211
- data/lib/mws/fulfillment_outbound_shipment.rb +0 -3
- data/lib/mws/merchant_fulfillment/client.rb +0 -87
- data/lib/mws/merchant_fulfillment.rb +0 -3
- data/lib/mws/off_amazon_payments.rb +0 -3
- data/lib/mws/orders/client.rb +0 -120
- data/lib/mws/orders.rb +0 -3
- data/lib/mws/products/client.rb +0 -268
- data/lib/mws/products.rb +0 -3
- data/lib/mws/recommendations/client.rb +0 -72
- data/lib/mws/recommendations.rb +0 -3
- data/lib/mws/reports/client.rb +0 -236
- data/lib/mws/reports.rb +0 -3
- data/lib/mws/sellers/client.rb +0 -44
- data/lib/mws/sellers.rb +0 -3
- data/lib/mws/shipment_invoicing/client.rb +0 -74
- data/lib/mws/shipment_invoicing.rb +0 -3
- data/lib/mws/subscriptions/client.rb +0 -179
- data/lib/mws/subscriptions.rb +0 -3
- data/lib/mws.rb +0 -29
- data/lib/peddler/client.rb +0 -159
- data/lib/peddler/errors/builder.rb +0 -64
- data/lib/peddler/errors/class_generator.rb +0 -40
- data/lib/peddler/errors/error.rb +0 -45
- data/lib/peddler/errors/parser.rb +0 -28
- data/lib/peddler/flat_file_parser.rb +0 -56
- data/lib/peddler/headers.rb +0 -102
- data/lib/peddler/operation.rb +0 -78
- data/lib/peddler/parser.rb +0 -33
- data/lib/peddler/structured_list.rb +0 -23
- data/lib/peddler/vcr_matcher.rb +0 -97
- data/lib/peddler/xml_parser.rb +0 -38
- data/lib/peddler/xml_response_parser.rb +0 -25
@@ -1,211 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'peddler/client'
|
4
|
-
require 'excon'
|
5
|
-
|
6
|
-
module MWS
|
7
|
-
module FulfillmentOutboundShipment
|
8
|
-
# The Fulfillment Outbound Shipment API enables you to fulfill orders placed
|
9
|
-
# through channels other than Amazon's retail web site, using your inventory
|
10
|
-
# in the Amazon Fulfillment Network. You can request previews of potential
|
11
|
-
# fulfillment orders that return estimated shipping fees and shipping dates
|
12
|
-
# based on shipping speed. You can get detailed item-level, shipment-level,
|
13
|
-
# and order-level information for any existing fulfillment order that you
|
14
|
-
# specify. You can also request lists of existing fulfillment orders based
|
15
|
-
# on when they were fulfilled and by the fulfillment method associated with
|
16
|
-
# them.
|
17
|
-
class Client < ::Peddler::Client
|
18
|
-
self.version = '2010-10-01'
|
19
|
-
self.path = "/FulfillmentOutboundShipment/#{version}"
|
20
|
-
|
21
|
-
# Lists fulfillment order previews
|
22
|
-
#
|
23
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_GetFulfillmentPreview.html
|
24
|
-
# @param [Struct, Hash] address
|
25
|
-
# @param [Array<Struct, Hash>] items
|
26
|
-
# @param [Hash] opts
|
27
|
-
# @option opts Array[String] :shipping_speed_categories
|
28
|
-
# @option opts [Boolean] :include_cod_fulfillment_preview
|
29
|
-
# @return [Peddler::XMLParser]
|
30
|
-
def get_fulfillment_preview(address, items, opts = {})
|
31
|
-
operation('GetFulfillmentPreview')
|
32
|
-
.add(opts)
|
33
|
-
.add('Address' => address, 'Items' => items)
|
34
|
-
.structure!('Items', 'member')
|
35
|
-
.structure!('ShippingSpeedCategories', 'member')
|
36
|
-
|
37
|
-
run
|
38
|
-
end
|
39
|
-
|
40
|
-
# Requests that Amazon ship items from the seller's Amazon Fulfillment
|
41
|
-
# Network inventory to a destination address
|
42
|
-
#
|
43
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_CreateFulfillmentOrder.html
|
44
|
-
# @param [String] seller_fulfillment_order_id
|
45
|
-
# @param [String] displayable_order_id
|
46
|
-
# @param [String, #iso8601] displayable_order_date_time
|
47
|
-
# @param [String] displayable_order_comment
|
48
|
-
# @param [String] shipping_speed_category
|
49
|
-
# @param [Struct, Hash] destination_address
|
50
|
-
# @param [Array<Struct, Hash>] items
|
51
|
-
# @param [Hash] opts
|
52
|
-
# @option opts [String] :fulfillment_action
|
53
|
-
# @option opts [String] :fulfillment_policy
|
54
|
-
# @option opts [Array<String>] :notification_email_list
|
55
|
-
# @option opts [Struct, Hash] :cod_settings
|
56
|
-
# @return [Peddler::XMLParser]
|
57
|
-
def create_fulfillment_order(seller_fulfillment_order_id,
|
58
|
-
displayable_order_id,
|
59
|
-
displayable_order_date_time,
|
60
|
-
displayable_order_comment,
|
61
|
-
shipping_speed_category,
|
62
|
-
destination_address, items, opts = {})
|
63
|
-
operation('CreateFulfillmentOrder')
|
64
|
-
.add(opts)
|
65
|
-
.add('SellerFulfillmentOrderId' => seller_fulfillment_order_id,
|
66
|
-
'DisplayableOrderId' => displayable_order_id,
|
67
|
-
'DisplayableOrderDateTime' => displayable_order_date_time,
|
68
|
-
'DisplayableOrderComment' => displayable_order_comment,
|
69
|
-
'ShippingSpeedCategory' => shipping_speed_category,
|
70
|
-
'DestinationAddress' => destination_address,
|
71
|
-
'Items' => items)
|
72
|
-
.structure!('Items', 'member')
|
73
|
-
.structure!('NotificationEmailList', 'member')
|
74
|
-
|
75
|
-
run
|
76
|
-
end
|
77
|
-
|
78
|
-
# Updates and/or requests shipment for a fulfillment order with an order
|
79
|
-
# hold on it
|
80
|
-
#
|
81
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_UpdateFulfillmentOrder.html
|
82
|
-
# @param [String] seller_fulfillment_order_id
|
83
|
-
# @param [Hash] opts
|
84
|
-
# @option opts [String] :fulfillment_action
|
85
|
-
# @option opts [String] :displayable_order_id
|
86
|
-
# @option opts [String, #iso8601] :displayable_order_date_time
|
87
|
-
# @option opts [String] :displayable_order_comment
|
88
|
-
# @option opts [String] :shipping_speed_category
|
89
|
-
# @option opts [Struct, Hash] :destination_address
|
90
|
-
# @option opts [String] :fulfillment_policy
|
91
|
-
# @option opts [Array<String>] :notification_email_list
|
92
|
-
# @option opts [Array<Struct, Hash>] :items
|
93
|
-
# @return [Peddler::XMLParser]
|
94
|
-
def update_fulfillment_order(seller_fulfillment_order_id, opts = {})
|
95
|
-
operation('UpdateFulfillmentOrder')
|
96
|
-
.add(opts)
|
97
|
-
.add('SellerFulfillmentOrderId' => seller_fulfillment_order_id)
|
98
|
-
.structure!('NotificationEmailList', 'member')
|
99
|
-
.structure!('Items', 'member')
|
100
|
-
|
101
|
-
run
|
102
|
-
end
|
103
|
-
|
104
|
-
# Gets a fulfillment order
|
105
|
-
#
|
106
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_GetFulfillmentOrder.html
|
107
|
-
# @param [String] seller_fulfillment_order_id
|
108
|
-
# @return [Peddler::XMLParser]
|
109
|
-
def get_fulfillment_order(seller_fulfillment_order_id)
|
110
|
-
operation('GetFulfillmentOrder')
|
111
|
-
.add('SellerFulfillmentOrderId' => seller_fulfillment_order_id)
|
112
|
-
|
113
|
-
run
|
114
|
-
end
|
115
|
-
|
116
|
-
# Returns a list of fulfillment orders fulfilled on or after a date
|
117
|
-
#
|
118
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_ListAllFulfillmentOrders.html
|
119
|
-
# @param [Hash] opts
|
120
|
-
# @option opts [String, #iso8601] :query_start_date_time
|
121
|
-
# @return [Peddler::XMLParser]
|
122
|
-
def list_all_fulfillment_orders(opts = {})
|
123
|
-
operation('ListAllFulfillmentOrders')
|
124
|
-
.add(opts)
|
125
|
-
|
126
|
-
run
|
127
|
-
end
|
128
|
-
|
129
|
-
# Returns the next page of fulfillment orders
|
130
|
-
#
|
131
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_ListAllFulfillmentOrdersByNextToken.html
|
132
|
-
# @param [String] next_token
|
133
|
-
# @return [Peddler::XMLParser]
|
134
|
-
def list_all_fulfillment_orders_by_next_token(next_token)
|
135
|
-
operation('ListAllFulfillmentOrdersByNextToken')
|
136
|
-
.add('NextToken' => next_token)
|
137
|
-
|
138
|
-
run
|
139
|
-
end
|
140
|
-
|
141
|
-
# Returns delivery tracking information for a package in an outbound
|
142
|
-
# shipment for a Multi-Channel Fulfillment order
|
143
|
-
#
|
144
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_GetPackageTrackingDetails.html
|
145
|
-
# @param [String] package_number
|
146
|
-
# @return [Peddler::XMLParser]
|
147
|
-
def get_package_tracking_details(package_number)
|
148
|
-
operation('GetPackageTrackingDetails')
|
149
|
-
.add('PackageNumber' => package_number)
|
150
|
-
|
151
|
-
run
|
152
|
-
end
|
153
|
-
|
154
|
-
# Requests that Amazon stop attempting to fulfill an existing fulfillment
|
155
|
-
# order
|
156
|
-
#
|
157
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_CancelFulfillmentOrder.html
|
158
|
-
# @param [String] seller_fulfillment_order_id
|
159
|
-
# @return [Peddler::XMLParser]
|
160
|
-
def cancel_fulfillment_order(seller_fulfillment_order_id)
|
161
|
-
operation('CancelFulfillmentOrder')
|
162
|
-
.add('SellerFulfillmentOrderId' => seller_fulfillment_order_id)
|
163
|
-
|
164
|
-
run
|
165
|
-
end
|
166
|
-
|
167
|
-
# Returns a list of return reason codes for a seller SKU in a given
|
168
|
-
# marketplace.
|
169
|
-
#
|
170
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_ListReturnReasonCodes.html
|
171
|
-
# @param [String] seller_sku
|
172
|
-
# @param [Hash] opts
|
173
|
-
# @option opts [String] :marketplace_id
|
174
|
-
# @option opts [String] :seller_fulfillment_order_id
|
175
|
-
# @option opts [String] :language
|
176
|
-
# @return [Peddler::XMLParser]
|
177
|
-
def list_return_reason_codes(seller_sku, opts = {})
|
178
|
-
operation('ListReturnReasonCodes')
|
179
|
-
.add(opts)
|
180
|
-
.add('SellerSKU' => seller_sku)
|
181
|
-
.structure!('List', 'member')
|
182
|
-
|
183
|
-
run
|
184
|
-
end
|
185
|
-
|
186
|
-
# Creates a fulfillment return.
|
187
|
-
#
|
188
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/FBAOutbound_CreateFulfillmentReturn.html
|
189
|
-
# @param [String] seller_fulfillment_order_id
|
190
|
-
# @param [Array] items
|
191
|
-
# @return [Peddler::XMLParser]
|
192
|
-
def create_fulfillment_return(seller_fulfillment_order_id, items)
|
193
|
-
operation('CreateFulfillmentReturn')
|
194
|
-
.add('SellerFulfillmentOrderId' => seller_fulfillment_order_id,
|
195
|
-
'Items' => items)
|
196
|
-
.structure!('Items', 'member')
|
197
|
-
|
198
|
-
run
|
199
|
-
end
|
200
|
-
|
201
|
-
# Gets the operational status of the API
|
202
|
-
#
|
203
|
-
# @see https://docs.developer.amazonservices.com/en_US/fba_outbound/MWS_GetServiceStatus.html
|
204
|
-
# @return [Peddler::XMLParser]
|
205
|
-
def get_service_status
|
206
|
-
operation('GetServiceStatus')
|
207
|
-
run
|
208
|
-
end
|
209
|
-
end
|
210
|
-
end
|
211
|
-
end
|
@@ -1,87 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'peddler/client'
|
4
|
-
|
5
|
-
module MWS
|
6
|
-
module MerchantFulfillment
|
7
|
-
# The Merchant Fulfillment API provides programmatic access to Amazon's
|
8
|
-
# Shipping Services for sellers, including competitive rates from
|
9
|
-
# Amazon-partnered carriers. Sellers can find out what shipping service
|
10
|
-
# offers are available by submitting information about a proposed shipment,
|
11
|
-
# such as package size and weight, shipment origin, and delivery date
|
12
|
-
# requirements. Sellers can choose from the shipping service offers returned
|
13
|
-
# by Amazon, and then purchase shipping labels for fulfilling their orders.
|
14
|
-
class Client < ::Peddler::Client
|
15
|
-
self.version = '2015-06-01'
|
16
|
-
self.path = "/MerchantFulfillment/#{version}"
|
17
|
-
|
18
|
-
# Returns a list of shipping service offers that satisfy the shipment
|
19
|
-
# request details that you specify
|
20
|
-
#
|
21
|
-
# @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_GetEligibleShippingServices.html
|
22
|
-
# @param [Struct, Hash] shipment_request_details
|
23
|
-
# @return [Peddler::XMLParser]
|
24
|
-
def get_eligible_shipping_services(shipment_request_details)
|
25
|
-
operation('GetEligibleShippingServices')
|
26
|
-
.add('ShipmentRequestDetails' => shipment_request_details)
|
27
|
-
.structure!('ItemList', 'Item')
|
28
|
-
|
29
|
-
run
|
30
|
-
end
|
31
|
-
|
32
|
-
# Purchases shipping and returns PNG or PDF document data for a shipping
|
33
|
-
# label
|
34
|
-
#
|
35
|
-
# @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_CreateShipment.html
|
36
|
-
# @param [Struct, Hash] shipment_request_details
|
37
|
-
# @param [String] shipping_service_id
|
38
|
-
# @param [Hash] opts
|
39
|
-
# @option opts [String] :shipping_service_offer_id
|
40
|
-
# @return [Peddler::XMLParser]
|
41
|
-
def create_shipment(shipment_request_details, shipping_service_id,
|
42
|
-
opts = {})
|
43
|
-
operation('CreateShipment')
|
44
|
-
.add(opts)
|
45
|
-
.add('ShipmentRequestDetails' => shipment_request_details,
|
46
|
-
'ShippingServiceId' => shipping_service_id)
|
47
|
-
.structure!('ItemList', 'Item')
|
48
|
-
|
49
|
-
run
|
50
|
-
end
|
51
|
-
|
52
|
-
# Returns an existing shipment for the ShipmentId value that you specify
|
53
|
-
#
|
54
|
-
# @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_GetShipment.html
|
55
|
-
# @param [String] shipment_id
|
56
|
-
# @return [Peddler::XMLParser]
|
57
|
-
def get_shipment(shipment_id)
|
58
|
-
operation('GetShipment')
|
59
|
-
.add('ShipmentId' => shipment_id)
|
60
|
-
|
61
|
-
run
|
62
|
-
end
|
63
|
-
|
64
|
-
# Cancels an existing shipment and requests a refund for the ShipmentId
|
65
|
-
# value that you specify
|
66
|
-
#
|
67
|
-
# @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_CancelShipment.html
|
68
|
-
# @param [String] shipment_id
|
69
|
-
# @return [Peddler::XMLParser]
|
70
|
-
def cancel_shipment(shipment_id)
|
71
|
-
operation('CancelShipment')
|
72
|
-
.add('ShipmentId' => shipment_id)
|
73
|
-
|
74
|
-
run
|
75
|
-
end
|
76
|
-
|
77
|
-
# Gets the operational status of the API
|
78
|
-
#
|
79
|
-
# @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MWS_GetServiceStatus.html
|
80
|
-
# @return [Peddler::XMLParser]
|
81
|
-
def get_service_status
|
82
|
-
operation('GetServiceStatus')
|
83
|
-
run
|
84
|
-
end
|
85
|
-
end
|
86
|
-
end
|
87
|
-
end
|
data/lib/mws/orders/client.rb
DELETED
@@ -1,120 +0,0 @@
|
|
1
|
-
# frozen_string_literal: true
|
2
|
-
|
3
|
-
require 'peddler/client'
|
4
|
-
|
5
|
-
module MWS
|
6
|
-
module Orders
|
7
|
-
# With the MWS Orders API, you can list orders created or updated during a
|
8
|
-
# time frame you specify or retrieve information about specific orders.
|
9
|
-
class Client < ::Peddler::Client
|
10
|
-
self.version = '2013-09-01'
|
11
|
-
self.path = "/Orders/#{version}"
|
12
|
-
|
13
|
-
# Lists orders
|
14
|
-
#
|
15
|
-
# @note When calling this operation, you must specify a time frame using
|
16
|
-
# either created_after or last_updated_after. When requesting orders by
|
17
|
-
# "Unshipped" status you must also request "PartiallyShipped" orders.
|
18
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrders.html
|
19
|
-
# @overload list_orders(*marketplace_id, opts = {})
|
20
|
-
# @param [Array<String>] marketplace_id
|
21
|
-
# @param [Hash] opts
|
22
|
-
# @option opts [String, #iso8601] :created_after
|
23
|
-
# @option opts [String, #iso8601] :created_before
|
24
|
-
# @option opts [String, #iso8601] :last_updated_after
|
25
|
-
# @option opts [String, #iso8601] :last_updated_before
|
26
|
-
# @option opts [Array<String>, String] :order_status
|
27
|
-
# @option opts [Array<String>, String] :fulfillment_channel
|
28
|
-
# @option opts [Array<String>, String] :payment_method
|
29
|
-
# @option opts [String] :buyer_email
|
30
|
-
# @option opts [String] :seller_order_id
|
31
|
-
# @option opts [String] :max_results_per_page
|
32
|
-
# @option opts [String] :tfm_shipment_status
|
33
|
-
# @return [Peddler::XMLParser]
|
34
|
-
def list_orders(*marketplace_id)
|
35
|
-
marketplace_id = marketplace_id.dup
|
36
|
-
opts = extract_options(marketplace_id)
|
37
|
-
opts['TFMShipmentStatus'] = opts.delete(:tfm_shipment_status) if opts.key?(:tfm_shipment_status)
|
38
|
-
|
39
|
-
operation('ListOrders')
|
40
|
-
.add(opts)
|
41
|
-
.add('MarketplaceId' => marketplace_id)
|
42
|
-
.structure!('OrderStatus', 'Status')
|
43
|
-
.structure!('FulfillmentChannel', 'Channel')
|
44
|
-
.structure!('MarketplaceId', 'Id')
|
45
|
-
.structure!('PaymentMethod')
|
46
|
-
.structure!('TFMShipmentStatus', 'Status')
|
47
|
-
require_start_time!
|
48
|
-
|
49
|
-
run
|
50
|
-
end
|
51
|
-
|
52
|
-
# Lists the next page of orders
|
53
|
-
#
|
54
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrdersByNextToken.html
|
55
|
-
# @param [String] next_token
|
56
|
-
# @return [Peddler::XMLParser]
|
57
|
-
def list_orders_by_next_token(next_token)
|
58
|
-
operation('ListOrdersByNextToken')
|
59
|
-
.add('NextToken' => next_token)
|
60
|
-
|
61
|
-
run
|
62
|
-
end
|
63
|
-
|
64
|
-
# Gets one or more orders
|
65
|
-
#
|
66
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_GetOrder.html
|
67
|
-
# @param [Array<String>] amazon_order_ids
|
68
|
-
# @return [Peddler::XMLParser]
|
69
|
-
def get_order(*amazon_order_ids)
|
70
|
-
operation('GetOrder')
|
71
|
-
.add('AmazonOrderId' => amazon_order_ids)
|
72
|
-
.structure!('AmazonOrderId', 'Id')
|
73
|
-
|
74
|
-
run
|
75
|
-
end
|
76
|
-
|
77
|
-
# Lists order items for an order
|
78
|
-
#
|
79
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrderItems.html
|
80
|
-
# @param [String] amazon_order_id
|
81
|
-
# @return [Peddler::XMLParser]
|
82
|
-
def list_order_items(amazon_order_id)
|
83
|
-
operation('ListOrderItems')
|
84
|
-
.add('AmazonOrderId' => amazon_order_id)
|
85
|
-
|
86
|
-
run
|
87
|
-
end
|
88
|
-
|
89
|
-
# Lists the next page of order items for an order
|
90
|
-
#
|
91
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrderItemsByNextToken.html
|
92
|
-
# @param [String] next_token
|
93
|
-
# @return [Peddler::XMLParser]
|
94
|
-
def list_order_items_by_next_token(next_token)
|
95
|
-
operation('ListOrderItemsByNextToken')
|
96
|
-
.add('NextToken' => next_token)
|
97
|
-
|
98
|
-
run
|
99
|
-
end
|
100
|
-
|
101
|
-
# Gets the service status of the API
|
102
|
-
#
|
103
|
-
# @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/MWS_GetServiceStatus.html
|
104
|
-
# @return [Peddler::XMLParser]
|
105
|
-
def get_service_status
|
106
|
-
operation('GetServiceStatus')
|
107
|
-
run
|
108
|
-
end
|
109
|
-
|
110
|
-
private
|
111
|
-
|
112
|
-
def require_start_time!
|
113
|
-
return if operation.key?('CreatedAfter')
|
114
|
-
return if operation.key?('LastUpdatedAfter')
|
115
|
-
|
116
|
-
raise ArgumentError, 'specify created_after or last_updated_after'
|
117
|
-
end
|
118
|
-
end
|
119
|
-
end
|
120
|
-
end
|
data/lib/mws/orders.rb
DELETED