amzn / selling-partner-api-models

This repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.
Apache License 2.0
569 stars 730 forks source link

[BUG] [SP-API] [Regression] Fulfillment Inbound v2024-03-20 API provides 0 methods to retrieve inbounded items #558

Closed emakunin closed 2 months ago

emakunin commented 4 months ago

I'm submitting a...


[X] Regression (a behavior that used to work and stopped working in a new release)
[ ] Bug report  
[ ] Feature request
[ ] Documentation issue or request
[ ] Other... Please describe:

According to the anounce (https://developer-docs.amazon.com/sp-api/changelog/get-early-access-to-new-fulfillment-inbound-api-v2024-03-20) V0 inbound API will stop working soon. However it contains crucial methods (getshipmentitems, getshipmentitemsbyshipmentid) that provide QuantityShipped and QuantityReceived information. New Fulfillment Inbound v2024-03-20 API does not provide any means to retrive such data.

The fields are important as quite often during inbound process FBA recieves less items than was shipped. But the shipments will be still closed with less items than shipped. It brakes automation tools and will force our application customers to manually check the information on SellerCentral.

Inventory API getinventorysummaries seems to have a limitation that will not allow checking inventor inbound process as well

If specified, all inventory summaries that have changed since then are returned. You must specify a date and time that is no earlier than 18 months prior to the date and time when you call the API. Note: Changes in inboundWorkingQuantity, inboundShippedQuantity and inboundReceivingQuantity are not detected

SP-API Name and Version or Report/Feed Type

Expected Behavior

Inbound API should provide means to obtain shipped VS inbound items quantities. Ideally defective/rejected/etc. Alternatively access to getShipmentItems and/or getShipmentItemsByShipmentId should remain untouched post-deprecation. Similarly to getLabels and getBillOfLading that will remain operational according to FAQ

Current Behavior

Currently customers can obtain inbound quantities by using getShipments and then getShipmentItems or getShipmentItemsByShipmentId

The methods return InboundShipmentItem struct that contains QuantityShipped and QuantityReceived fields.

Context/Screenshots

Our integration needs to validate shipped VS inbound quanties once an inbound shipment is closed as they may differ. Without an API we have to rely on SellerCentral UI to check notifications or shipments dashboards manully.

The only alternative to receive this info seems to be FBA inbound-performance report that is much less convenient for automation and will reuire migration. Also this report contains completely wrong data I requested a couple of them and they do not report problematic shipments. Or return the ones that are marked ad CLOSED with no errors in Seller central

Related issues:

  1. https://github.com/amzn/selling-partner-api-models/issues/555

Your Environment

We host an selling-partner application that tracks inbound shipments. The application uses "Fulfillment Inbound API v0" currently.

emakunin commented 4 months ago

UPD: FBA reports are not reliable. My testing shows that they return inconsistent data. In my report I see shipments that are OK in SellerCentral, but do not see the ones that are inbounded partially. It make it impossible for us to check which shipment is fully inbounded and which is not.

emakunin commented 4 months ago

Amazon dev support reply

Greetings from Amazon,

My name is Joshua, from the Developer Support team.

I understand you have a concern regarding FBA inbound API migration.

Indeed some functions are currently not available on the new version of this API. However, rest assured that we are coordinating with the corresponding teams so that these functions are either available on the new API, or available through V0.

Please stay on the lookout for our announcements for this: https://developer-docs.amazon.com/sp-api/changelog

I hope that this contact finds you well.

github-actions[bot] commented 3 months ago

This is a very old issue that is probably not getting as much attention as it deserves. We encourage you to check if this is still an issue after the latest release and if you find that this is still a problem, please feel free to open a new issue and make a reference to this one.

github-actions[bot] commented 2 months ago

closed for inactivity

emakunin commented 2 months ago

The issue is still valid.

SuperFlyingCow commented 1 month ago

Have you all able to get received and shipped quantity through the latest API?

emakunin commented 1 month ago

Noop, you'll have to use V0 API. Note that it can return inconsistent data. Even after shipments are "CLOSED" Amazon still keeps updating quantities