Get Placement Preview
GET/api/walmart/:integrationInstance/wfs/inbound-shipments/:shipment/placement-preview
Estimate the destination-FC placement + transfer charges for an existing shipment by re-running Walmart's inbound preview from its current items + source. This is an estimate — Walmart exposes no billed charges per existing order; actual charges live in Walmart Seller Center.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token.
Response: { data: { total_charge (number), currency (string), placements: [ ... ] } }.
Each placement: fc_name (string|null), ship_node (string|null), node_type (string|null), charge (number), currency (string), items: [ { sku (string|null), quantity (number), charge (number) } ].
Errors: 422 with { message } — e.g. when Walmart hasn't reported items for the shipment yet, or the preview call fails.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.