Skip to main content

Bulk Link (to single product)

POST 
/api/amazon/unified/fnsku-products/bulk-link

Link the given FNSKU products to a single product (or all filtered IDs when apply_to_all=true). Dispatches a tracked reconciliation job.

Remap options (all optional; omit them and the mapping is applied with the inferred intent):

  • intent — correction (the FNSKU was always this product; its whole history is rebuilt) or change (from effective_from onward it is this product; earlier movement stays on the previous one). Inferred when omitted: change when the target product was created after the FNSKU's earliest inventory event, else correction.
  • effective_from — YYYY-MM-DD, required in spirit for change; defaults to the target product's creation date. Must not be in the future, nor earlier than the start of the period it closes.
  • carry_cost — default true. When the target has no cost of its own, seed the FNSKU's initial unit cost from the product it is leaving so its first cost layer is not created at $0.00.
  • reason — free text stored on the mapping period and the activity log.
  • include_sibling_dispositions — also remap the same FNSKU's other dispositions/locations.

Returns 422 with reason_code (locked_period, effective_from_before_period, effective_from_in_future) when the change cannot be applied.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Request​

Responses​

OK

Response Headers
    Content-Type