Skip to main content

Get Placement Transport Estimates

GET 
/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/placement-transport-estimates

Own-carrier small-parcel (SPD) transport cost estimates for every OFFERED placement option of the draft plan, so the operator can compare "placement fee + transport" totals in real dollars before confirming an option.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

For each offered option, every preview shipment's physical load (derived from the plan items' product weights/dimensions) is approximated into SPD parcels (max 50 lb / 25" per box), rated from the plan's source-warehouse zip to the shipment's destination FC via EasyPost, and the cheapest carrier service per shipment is summed into the option total.

Response fields per estimate:

  • placement_option_id — the local placement option id
  • total — summed cheapest-rate transport cost for the option (null when incomplete)
  • currency — quote currency (USD)
  • incomplete — true when at least one shipment could not be estimated (missing product weight/dims, missing zips, or rating failure)
  • shipments[] — per-shipment breakdown: shipment_id, destination_fc, quote (carrier, service, amount, currency, parcels) or null when inestimable, skipped_reason (null when quoted; otherwise why the shipment could not be rated, e.g. missing_product_dimensions), and missing_dims_mskus (MSKUs lacking weight/dimensions when skipped_reason is missing_product_dimensions; empty otherwise)

origin_zip is the source warehouse zip used as the rating origin.

Each shipment also carries an assumptions object describing the physical load the rate is built on: source, units, weight_lb, volume_cuft, estimated_pallets, parcel_count, parcel_weight_lb, parcel_side_in, items_missing_data, missing_data_mskus. assumptions.source is box_config when the shipment has real packed cartons (amazon_fba_inbound_boxes with complete dims + weight) — then weight_lb / volume_cuft / estimated_pallets / parcel_count reflect those actual boxes — or estimated when the load is inferred from the plan items' product unit dimensions.

estimated_at (top level) is the ISO-8601 time the persisted estimates were last computed (null when none stored). The estimate is a ROUGH approximation whenever source is estimated; once real box configurations exist for a shipment its rate uses them. Confirmed/expired options are skipped. Requires placement options to have been generated first.

Request​

Responses​

OK

Response Headers
    Content-Type