Confirm Inbound Method

POST

/fbt/202603/confirm_inbound_method

Confirm a currently available warehouse placement option for an FBT inbound plan. First call the List Available Inbound Methods API and select an inbound_method with one exact estimate_arrival_time window. Then call the Get Inbound Method Detail API with that selection and choose a returned placement_option_id. Confirm using the placement_option_id, inbound_method, and estimate_arrival_time from the same selection. If the option has expired, repeat both prerequisite calls to obtain a current selection and a new placement_option_id, then retry. The response contains the child inbound order IDs generated for the plan.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body^required

Media typeapplication/json

object

plan_id

required

Identifier of the FBT inbound plan whose warehouse placement option is being confirmed.

string

placement_option_id

required

Placement option id. A placement option represents the shipment splits and destinations.

string

inbound_method

required

Possible values:

• D2FC (Direct to fulfillment center, may be split into multiple shipments)
• ONE_HUB (Single destination, includes fee)

string

Allowed values: D2FC ONE_HUB

estimate_arrival_time

required

Estimated arrival time. Value should be retrieved from the available_time_window_list from ListAvailableInboundMethod API response

object

start_timestamp

required

Start of the estimated arrival time window as a Unix timestamp in seconds. For example, 1774162800 corresponds to Sunday, 2026-03-22 at 00:00 PDT (2026-03-22T07:00:00Z). Use the exact start_timestamp returned in available_time_window_list by the ListAvailableInboundMethod API.

string

end_timestamp

required

End of the estimated arrival time window as a Unix timestamp in seconds. For example, 1774767600 corresponds to Sunday, 2026-03-29 at 00:00 PDT (2026-03-29T07:00:00Z). Use the exact end_timestamp returned in available_time_window_list by the ListAvailableInboundMethod API.

string

Example

{
  "plan_id": "5766071177167344427",
  "placement_option_id": "5766071177167344420",
  "inbound_method": "D2FC",
  "estimate_arrival_time": {
    "start_timestamp": "1774162800",
    "end_timestamp": "1774767600"
  }
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

inbound_order_ids

List of child inbound order IDs generated for the confirmed FBT inbound plan.

Array<string>

Example

{
  "code": 0,
  "data": {
    "inbound_order_ids": [
      "5766071177167344427",
      "5766071177167344428"
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}