search

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
571 stars 730 forks source link

Fulfillment_Inbound_2024_03_20.SpdTrackingItem+TrackingNumberValidationStatus Is returning a value not allowed by the documentation #4035

Open ben-pierre opened 1 month ago

ben-pierre commented 1 month ago

Calls to /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId} return an enum with path 'trackingDetails.spdTrackingDetail.spdTrackingItems[0].trackingNumberValidationStatus.

According to the documentation here https://developer-docs.amazon.com/sp-api/docs/fulfillment-inbound-api-v2024-03-20-reference#spdtrackingitem this can have values Can be: VALIDATED, NOT_VALIDATED. As of yesterday, I am now receiving the value "NOT_SUPPORTED" for this enum. This is not in the schema, or any announcements, but will break almost any code doing validation/deserialization on models returned from this endpoint.

puppsupr commented 1 month ago

Hi, Can you please provide the complete request and response ?

ben-pierre commented 1 month ago

Request:

{
        "Version": "1.1",
        "VersionPolicy": 0,
        "Method": {
          "Method": "GET"
        },
        "RequestUri": "https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans/wf8ac33e6f-dcfb-4765-b33c-5b8d75b41e6f/shipments/shfc42f847-8c3a-4869-9be1-badb2cd4f900",
        "Headers": [
          {
            "Key": "X-Amz-Security-Token",
            "Value": ...."
            ]
          },
          {
            "Key": "x-amz-access-token",
            "Value": [
              "...."
            ]
          },
          {
            "Key": "User-Agent",
            "Value": [
              "MtSellingPartnerTestRun/999.999.999.999",
              "(CSharp)"
            ]
          },
          {
            "Key": "X-Amz-Date",
            "Value": [
              "20240730T142325Z"
            ]
          },
          {
            "Key": "Host",
            "Value": [
              "sellingpartnerapi-na.amazon.com"
            ]
          },
          {
            "Key": "Authorization",
            "Value": [
              "...."
            ]
          }
        ],
        "Properties": {},
        "Options": {}
      }

Response:

StatusCode: 200, ReasonPhrase: '', Version: 1.1, Content: System.Net.Http.HttpConnectionResponseContent, Headers:
      {
        Server: Server
        Date: Tue, 30 Jul 2024 14:23:36 GMT
        Connection: keep-alive
        x-amz-rid: 5AC7D7Z5J9EPEZE4MT07
        x-amzn-RateLimit-Limit: 2.0
        x-amzn-RequestId: ce58eabe-25de-4eba-8511-13ee33a6887a
        x-amz-apigw-id: OPFce58eabe25de
        X-Amzn-Trace-Id: Root=1-66a8f768-ce58eabe25de4eba
        Vary: accept-encoding,Content-Type,Accept-Encoding,User-Agent
        Strict-Transport-Security: max-age=47474747; includeSubDomains; preload
        Content-Type: application/json
        Content-Length: 4274
      }

ResponseContent:

{
  "amazonReferenceId": "3F1OIMGA",
  "dates": {},
  "destination": {
    "address": {
      "addressLine1": "5045 PORTSMOUTH BLVD",
      "addressLine2": "",
      "city": "CHESAPEAKE",
      "companyName": "",
      "countryCode": "US",
      "name": "ORF2",
      "postalCode": "23321-1425",
      "stateOrProvinceCode": "VA"
    },
    "destinationType": "AMAZON_WAREHOUSE",
    "warehouseId": "ORF2"
  },
  "name": "FBA STA (07/11/2024 21:07)-2 -ORF2",
  "placementOptionId": "pl82a163a2-90a5-4801-86b3-aa7af8f65185",
  "selectedTransportationOptionId": "toa856351a-cf70-4f61-a610-a6bfcd0ae683",
  "shipmentConfirmationId": "FBA186FWXSQQ",
  "shipmentId": "shfc42f847-8c3a-4869-9be1-badb2cd4f900",
  "source": {
    "address": {.....},
    "sourceType": "SELLER_FACILITY"
  },
  "status": "SHIPPED",
  "trackingDetails": {
    "ltlTrackingDetail": {},
    "spdTrackingDetail": {
      "spdTrackingItems": [
        {
          "boxId": "FBA186FWXSQQU000001",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000002",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000003",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000004",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000005",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000006",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000007",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000008",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000009",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000010",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000011",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000012",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000013",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000014",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000015",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000016",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000017",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000018",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000019",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000020",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000021",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000022",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000023",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000024",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000025",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000026",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000027",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000028",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000029",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        },
        {
          "boxId": "FBA186FWXSQQU000030",
          "trackingId": "996156954",
          "trackingNumberValidationStatus": "NOT_SUPPORTED"
        }
      ]
    }
  }
}
puppsupr commented 1 month ago

Checking with Product Team on this.

wanjj2014 commented 3 weeks ago

@ben-pierre hi,how did you upload the trackingIds? our problems like this request: {{baseUrl}}/inbound/fba/2024-03-20/inboundPlans/:inboundPlanId/shipments/:shipmentId/trackingDetails { "trackingDetails": { "spdTrackingDetail": { "spdTrackingItems": [ { "boxId": "FBA1897xxxxxU000001", "trackingId": "Xxxxxxxxx199O114" }, { "boxId": "FBA1897xxxxxU000002", "trackingId": "Xxxxxxxxx199O114" }, { "boxId": "FBA1897xxxxxU000003", "trackingId": "Xxxxxxxxx199O114" }, { "boxId": "FBA1897xxxxxU000004", "trackingId": "Xxxxxxxxx199O114" }, { "boxId": "FBA1897xxxxxU000005", "trackingId": "Xxxxxxxxx199O114" } ] } } }

response: { "errors": [ { "code": "BadRequest", "message": "ERROR: UpdateShipmentTrackingDetails cannot be processed because the following invalid boxIds were found in the request: [FBA1897xxxxxU000001, FBA1897xxxxxU000002, FBA1897xxxxxU000003, FBA1897xxxxxU000004, FBA1897xxxxxU000005]", "details": "" } ] }

puppsupr commented 2 weeks ago

Hi ben-pierre, When you provided us with some wrong trackingId which can not become valid after a period of time, we will return NOT_SUPPORTED. Can you please provide correct value for the tracking id and check ?

puppsupr commented 2 weeks ago

wanjj2014, Were you able to verify the boxIDs ? Are they specific to the inboundPlanId and shipmentId ?

wanjj2014 commented 2 weeks ago

@puppsupr we got the boxIds form the Operation: listShipmentBoxes; we use non_partnered carrier

ben-pierre commented 2 weeks ago

Hi ben-pierre, When you provided us with some wrong trackingId which can not become valid after a period of time, we will return NOT_SUPPORTED. Can you please provide correct value for the tracking id and check ?

Right @puppsupr , I know why it happened, but surely the documentation should say that this is a possible value for the Enum because, well, obviously, it's a possible value for the Enum?

ben-pierre commented 2 weeks ago

Also, FWIW that is the correct tracking number, it's just not amazon partnered so they can't be verified.

puppsupr commented 2 weeks ago

ben-pierre, yes team is looking into this. Were you able to update other trackingIds or are you seeing same error always ?