-
Notifications
You must be signed in to change notification settings - Fork 756
/
Copy pathfbaInbound.json
664 lines (664 loc) · 30.1 KB
/
fbaInbound.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
{
"swagger": "2.0",
"info": {
"description": "With the FBA Inbound Eligibility API, you can build applications that let sellers get eligibility previews for items before shipping them to Amazon's fulfillment centers. With this API you can find out if an item is eligible for inbound shipment to Amazon's fulfillment centers in a specific marketplace. You can also find out if an item is eligible for using the manufacturer barcode for FBA inventory tracking. Sellers can use this information to inform their decisions about which items to ship Amazon's fulfillment centers.",
"version": "v1",
"title": "Selling Partner API for FBA Inbound Eligibilty",
"contact": {
"name": "Selling Partner API Developer Support",
"url": "https://sellercentral.amazon.com/gp/mws/contactus.html"
},
"license": {
"name": "Apache License 2.0",
"url": "http://www.apache.org/licenses/LICENSE-2.0"
}
},
"host": "sellingpartnerapi-na.amazon.com",
"schemes": [
"https"
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"paths": {
"/fba/inbound/v1/eligibility/itemPreview": {
"get": {
"tags": [
"fbaInbound"
],
"description": "This operation gets an eligibility preview for an item that you specify. You can specify the type of eligibility preview that you want (INBOUND or COMMINGLING). For INBOUND previews, you can specify the marketplace in which you want to determine the item's eligibility.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "getItemEligibilityPreview",
"parameters": [
{
"name": "marketplaceIds",
"in": "query",
"description": "The identifier for the marketplace in which you want to determine eligibility. Required only when program=INBOUND.",
"required": false,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
},
{
"name": "asin",
"in": "query",
"description": "The ASIN of the item for which you want an eligibility preview.",
"required": true,
"type": "string"
},
{
"name": "program",
"in": "query",
"description": "The program that you want to check eligibility against.",
"required": true,
"type": "string",
"enum": [
"INBOUND",
"COMMINGLING"
]
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"examples": {
"ItemEligibilityPreview": {
"payload": {
"asin": "TEST_ASIN",
"marketplaceId": "TEST_MARKETPLACE_ID",
"program": "INBOUND",
"isEligibleForProgram": true
}
}
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_200"
}
}
},
"response": {
"payload": {
"asin": "TEST_CASE_200",
"marketplaceId": "TEST_CASE_200",
"program": "INBOUND",
"isEligibleForProgram": true
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_400"
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_401"
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"403": {
"description": "403 can be caused for reasons like Access Denied, Unauthorized, Expired Token, Invalid Signature or Resource Not Found.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_403"
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_404"
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource doesn't exist."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_429"
}
}
},
"response": {
"errors": [
{
"code": "QuotaExceeded",
"message": "You exceeded your quota for the requested resource."
}
]
}
}
]
}
},
"500": {
"description": "Encountered an unexpected condition which prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_500"
}
}
},
"response": {
"errors": [
{
"code": "InternalFailure",
"message": "We encountered an internal error. Please try again."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/GetItemEligibilityPreviewResponse"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference ID."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"asin": {
"value": "TEST_CASE_503"
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service is temporarily unavailable. Please try again."
}
]
}
}
]
}
}
}
}
}
},
"definitions": {
"GetItemEligibilityPreviewResponse": {
"type": "object",
"properties": {
"payload": {
"description": "The payload for the getItemEligibilityPreview operation.",
"$ref": "#/definitions/ItemEligibilityPreview"
},
"errors": {
"description": "An unexpected condition occurred during the GetItemEligibilityPreview operation.",
"$ref": "#/definitions/ErrorList"
}
},
"description": "The response schema for the getItemEligibilityPreview operation."
},
"ItemEligibilityPreview": {
"type": "object",
"required": [
"asin",
"isEligibleForProgram",
"program"
],
"properties": {
"asin": {
"type": "string",
"description": "The ASIN for which eligibility was determined."
},
"marketplaceId": {
"type": "string",
"description": "The marketplace for which eligibility was determined."
},
"program": {
"type": "string",
"description": "The program for which eligibility was determined.",
"enum": [
"INBOUND",
"COMMINGLING"
],
"x-docgen-enum-table-extension": [
{
"value": "INBOUND",
"description": "Inbound shipment."
},
{
"value": "COMMINGLING",
"description": "Using the manufacturer barcode for FBA inventory tracking."
}
]
},
"isEligibleForProgram": {
"type": "boolean",
"description": "Indicates if the item is eligible for the program."
},
"ineligibilityReasonList": {
"type": "array",
"description": "Potential Ineligibility Reason Codes.",
"items": {
"type": "string",
"description": "Potential Ineligibility Reason Codes.",
"enum": [
"FBA_INB_0004",
"FBA_INB_0006",
"FBA_INB_0007",
"FBA_INB_0008",
"FBA_INB_0009",
"FBA_INB_0010",
"FBA_INB_0011",
"FBA_INB_0012",
"FBA_INB_0013",
"FBA_INB_0014",
"FBA_INB_0015",
"FBA_INB_0016",
"FBA_INB_0017",
"FBA_INB_0018",
"FBA_INB_0019",
"FBA_INB_0034",
"FBA_INB_0035",
"FBA_INB_0036",
"FBA_INB_0037",
"FBA_INB_0038",
"FBA_INB_0050",
"FBA_INB_0051",
"FBA_INB_0053",
"FBA_INB_0055",
"FBA_INB_0056",
"FBA_INB_0059",
"FBA_INB_0065",
"FBA_INB_0066",
"FBA_INB_0067",
"FBA_INB_0068",
"FBA_INB_0095",
"FBA_INB_0097",
"FBA_INB_0098",
"FBA_INB_0099",
"FBA_INB_0100",
"FBA_INB_0103",
"FBA_INB_0104",
"FBA_INB_0197",
"UNKNOWN_INB_ERROR_CODE"
],
"x-docgen-enum-table-extension": [
{
"value": "FBA_INB_0004",
"description": "Missing package dimensions. This product is missing necessary information; dimensions need to be provided in the manufacturer's original packaging."
},
{
"value": "FBA_INB_0006",
"description": "The SKU for this product is unknown or cannot be found."
},
{
"value": "FBA_INB_0007",
"description": "Product Under Dangerous Goods (Hazmat) Review. We do not have enough information to determine what the product is or comes with to enable us to complete our dangerous goods review. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. You will need to add more details to the product listings, such as a clear title, bullet points, description, and image. The review process takes 4 business days."
},
{
"value": "FBA_INB_0008",
"description": "Product Under Dangerous Goods (Hazmat) Review. We require detailed battery information to correctly classify the product, and until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Download an exemption sheet for battery and battery-powered products available in multiple languages in \"Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet\" in Seller Central and follow instructions to submit it through the same page. The review process takes 4 business days."
},
{
"value": "FBA_INB_0009",
"description": "Product Under Dangerous Goods (Hazmat) Review. We do not have enough dangerous goods information to correctly classify the product and until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide a Safety Data Sheet (SDS) through \"Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet\" in Seller Central, and make sure the SDS complies with all the requirements. The review process takes 4 business days."
},
{
"value": "FBA_INB_0010",
"description": "Product Under Dangerous Goods (Hazmat) Review. The dangerous goods information is mismatched and so the product cannot be correctly classified. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide compliant documents through \"Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet\" in Seller Central, and make sure it complies with all the requirements. The review process takes 4 business days, the product will remain unfulfillable until review process is complete."
},
{
"value": "FBA_INB_0011",
"description": "Product Under Dangerous Goods (Hazmat) Review. We have incomplete, inaccurate or conflicting dangerous goods information and cannot correctly classify the product. Until you provide the necessary information, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. Please provide compliant documents through \"Upload dangerous goods documents: safety data sheet (SDS) or exemption sheet\" in Seller Central, and make sure it complies with all the requirements. The review process takes 4 business days and the product will remain unfulfillable until the review process is complete."
},
{
"value": "FBA_INB_0012",
"description": "Product Under Dangerous Goods (Hazmat) Review. We have determined there is conflicting product information (title, bullet points, images, or product description) within the product detail pages or with other offers for the product. Until the conflicting information is corrected, the products will not be available for sale and you will not be able to send more units to Amazon fulfillment centers. We need you to confirm the information on the product detail page The review process takes 4 business days."
},
{
"value": "FBA_INB_0013",
"description": "Product Under Dangerous Goods (Hazmat) Review. Additional information is required in order to complete the Hazmat review process."
},
{
"value": "FBA_INB_0014",
"description": "Product Under Dangerous Goods (Hazmat) Review. The product has been identified as possible dangerous goods. The review process generally takes 4 - 7 business days and until the review process is complete the product is unfulfillable and cannot be received at Amazon fulfilment centers or ordered by customers. For more information about dangerous goods please see \"Dangerous goods identification guide (hazmat)\"\" help page in Seller Central."
},
{
"value": "FBA_INB_0015",
"description": "Dangerous goods (Hazmat). The product is regulated as unfulfillable and not eligible for sale with Amazon. We ask that you refrain from sending additional units in new shipments. We will need to dispose of your dangerous goods inventory in accordance with the terms of the Amazon Business Services Agreement. If you have questions or concerns, please contact Seller Support within five business days of this notice. For more information about dangerous goods please see “Dangerous goods identification guide (hazmat)” help page in Seller Central."
},
{
"value": "FBA_INB_0016",
"description": "Dangerous goods (Hazmat). The product is regulated as a fulfillable dangerous good (Hazmat). You may need to be in the FBA dangerous good (Hazmat) program to be able to sell your product. For more information on the FBA dangerous good (Hazmat) program please contact Seller Support. For more information about dangerous goods please see the \"Dangerous goods identification guide (hazmat)\" help page in Seller Central."
},
{
"value": "FBA_INB_0017",
"description": "This product does not exist in the destination marketplace catalog. The necessary product information will need to be provided before it can be inbounded."
},
{
"value": "FBA_INB_0018",
"description": "Product missing category. This product must have a category specified before it can be sent to Amazon."
},
{
"value": "FBA_INB_0019",
"description": "This product must have a title before it can be sent to Amazon."
},
{
"value": "FBA_INB_0034",
"description": "Product cannot be stickerless, commingled. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels."
},
{
"value": "FBA_INB_0035",
"description": "Expiration-dated/lot-controlled product needs to be labeled. This product requires labeling to be received at our fulfillment centers."
},
{
"value": "FBA_INB_0036",
"description": "Expiration-dated or lot-controlled product needs to be commingled. This product cannot be shipped to Amazon without being commingled. This error condition cannot be corrected from here. This product must be removed."
},
{
"value": "FBA_INB_0037",
"description": "This product is not eligible to be shipped to our fulfillment center. You do not have all the required tax documents. If you have already filed documents please wait up to 48 hours for the data to propagate."
},
{
"value": "FBA_INB_0038",
"description": "Parent ASIN cannot be fulfilled by Amazon. You can send this product by creating a listing against the child ASIN."
},
{
"value": "FBA_INB_0050",
"description": "There is currently no fulfillment center in the destination country capable of receiving this product. Please delete this product from the shipment or contact Seller Support if you believe this is an error."
},
{
"value": "FBA_INB_0051",
"description": "This product has been blocked by FBA and cannot currently be sent to Amazon for fulfillment."
},
{
"value": "FBA_INB_0053",
"description": "Product is not eligible in the destination marketplace. This product is not eligible either because the required shipping option is not available or because the product is too large or too heavy."
},
{
"value": "FBA_INB_0055",
"description": "Product unfulfillable due to media region restrictions. This product has a region code restricted for this marketplace. This product must be removed."
},
{
"value": "FBA_INB_0056",
"description": "Product is ineligible for inbound. Used non-media goods cannot be shipped to Amazon."
},
{
"value": "FBA_INB_0059",
"description": "Unknown Exception. This product must be removed at this time."
},
{
"value": "FBA_INB_0065",
"description": "Product cannot be stickerless, commingled. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels."
},
{
"value": "FBA_INB_0066",
"description": "Unknown Exception. This product must be removed at this time."
},
{
"value": "FBA_INB_0067",
"description": "Product ineligible for freight shipping. This item is ineligible for freight shipping with our Global Shipping Service. This item must be removed."
},
{
"value": "FBA_INB_0068",
"description": "Account not configured for expiration-dated or lot-controlled products. Please contact TAM if you would like to configure your account to handle expiration-dated or lot-controlled inventory. Once configured, you will be able to send in this product."
},
{
"value": "FBA_INB_0095",
"description": "The barcode (UPC/EAN/JAN/ISBN) for this product is associated with more than one product in our fulfillment system. This product must be removed. You can send in new inventory by creating a new listing for this product that requires product labels."
},
{
"value": "FBA_INB_0097",
"description": "Fully regulated dangerous good."
},
{
"value": "FBA_INB_0098",
"description": "Merchant is not authorized to send item to destination marketplace."
},
{
"value": "FBA_INB_0099",
"description": "Seller account previously terminated."
},
{
"value": "FBA_INB_0100",
"description": "You do not have the required tax information to send inventory to fulfillment centers in Mexico."
},
{
"value": "FBA_INB_0103",
"description": "This is an expiration-dated/lot-controlled product that cannot be handled at this time."
},
{
"value": "FBA_INB_0104",
"description": "Item Requires Manufacturer Barcode. Only NEW products can be stored in our fulfillment centers without product labels."
},
{
"value": "FBA_INB_0197",
"description": "Item requires safety and compliance documentation. Orders for this product cannot be fulfilled by FBA without required safety and compliance documentation."
},
{
"value": "UNKNOWN_INB_ERROR_CODE",
"description": "Unknown Ineligibility Reason."
}
]
}
}
},
"description": "The response object which contains the ASIN, marketplaceId if required, eligibility program, the eligibility status (boolean), and a list of ineligibility reason codes."
},
"ErrorList": {
"type": "array",
"description": "A list of error responses returned when a request is unsuccessful.",
"items": {
"$ref": "#/definitions/Error"
}
},
"Error": {
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occurred."
},
"message": {
"type": "string",
"description": "A message that describes the error condition in a human-readable form."
},
"details": {
"type": "string",
"description": "Additional information that can help the caller understand or fix the issue."
}
},
"description": "Error response returned when the request is unsuccessful."
}
}
}