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

Amazon SP API : I need some clarification regarding "putTransportDetails" request #566

Closed zaki-siddiqui closed 5 months ago

zaki-siddiqui commented 5 months ago

I'm using the Amazon SP API for Fulfillment Inbound API, which includes a sequence of required APIs:

1- Create Shipment Plan 2- Create Shipment 3- Put Transport Details 4- Get Transport Details 5- Get Estimate 6- Confirm Transport 7- Get Label

I've tested nearly all of these APIs using Postman to ensure they're working correctly, and I've received appropriate responses for each request. My goal is to create a user interface (UI) similar to Amazon's shipment form, with some modifications. Here's what I'm doing:

First, I load SKUs from Amazon using the 'Item Listing API.' For each SKU, I allow the user to choose between 'Individual Unit' or 'Box Packed.' If 'Box Packed' is selected, a popup appears for the user to input box dimensions, weight, and quantity per box. If 'Individual Unit' is selected, the user inputs the number of items.

If all SKUs are 'Box Packed,' the submit button text becomes 'Confirm & Continue.' If any SKU is 'Individual Unit,' the submit button text becomes 'Pack Individual Unit.' In the backend, if the button says 'Pack Individual Unit,' I run 'Create Shipment Plan' and then 'Create Shipment' against each shipment returned by the plan. The user can provide pack group information by selecting single or multiple boxes via a web form, similar to Amazon's UI. If the user chooses the web form option, I generate as many boxes as the number of shipments returned by the plan. The quantity of SKUs in each box is pre-filled based on the shipment plan response, and the user can input the dimensions and weight for each box.

Now, I'm facing difficulties in making requests to 'putTransportDetail' because:

1- I'm uncertain how to determine if a transport should be 'Small Parcel' (SP) or 'Less Than Truckload' (LTL). Amazon states that small parcel packages cannot exceed certain weight and size limits. I'm considering using these limits to decide if a shipment falls within the SP category; otherwise, it would be LTL.

2- Some shipments may contain multiple SKUs, requiring multiple dimension and weight inputs (one for each SKU). I'm unsure how to calculate the TransportDetails, whether it should be SP or LTL, as the 'putTransportDetail' request includes multiple dimensions and weight information.

I've tried my best to explain my issue. Any guidance would be greatly appreciated, and please let me know if anything is unclear so I can provide further clarification.

Thank you

shreeharsh-a commented 5 months ago

Hi @zaki-siddiqui

Thank you for detailing out the issues you are facing. Please open a developer support ticket so that we can better help you on this given the nature / scope / complexity of the ask.

supoman-service commented 5 months ago

I also look forward to this result