Add or replace bundles
Add or replace bundles, identified by parent SKU.
A bundle groups several products under one product that shoppers buy. When a bundle is returned, Redo uses this definition to break it back into the products it contains.
Send the same payload whether a bundle is new or already exists. A bundle
whose parent SKU is already stored is replaced; bundles you do not send are
left alone. To remove a bundle, call
DELETE /stores/{storeId}/bundles/{parentSku}.
If your store reuses SKUs
Your store does not require SKUs to be unique. If the same SKU can be on
more than one variant, always send parent_variant_id and
children_skus[].variant_id so Redo knows which variant you mean. Without
them, a bundle containing a shared SKU is not stored and its result is
ambiguous, listing the variant_ids to choose from. Stores with unique
SKUs can leave these fields out.
Quantities
quantity is how many units of a child the bundle contains, and it affects
how a refund is split across the bundle. Maximum 100 per child. Listing the
same child twice adds the quantities together.
Return types
return_types limits the bundle to specific return types. Omit it to apply
the bundle to all of them. It replaces whatever was previously set, so
include it on every request if you rely on it.
Reading the response
A 200 means the request was processed, not that every bundle was stored.
Check each entry in results:
applied— stored as requested.failed— a SKU matched no product.unresolved_skusnames each one. Common causes are a typo, a deleted product, or a variant with no SKU set.ambiguous— a SKU is on more than one variant and no variant was given. See above.
A single bad child is enough to skip the whole bundle. SKUs are matched exactly and are case-sensitive.
Limits
Send at most 100 bundles per request; split larger sets into batches.
Entries that share a parent_sku are merged into one bundle. Only one
upload can run per store at a time, shared with the CSV upload in Redo; a
request that arrives during another returns 409 and can be retried.
Requires the returns_write scope.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Store ID
"64e5a8a1af49a89df37e4ee7"
Body
1 - 100 elementsSKU of the product shoppers buy. Identifies the bundle. Case-sensitive.
"BUNDLE-STARTER-KIT"
The products contained in the bundle.
1The parent variant. Send it if parent_sku may be on more than one variant in your catalog.
"55518673568035"
Return types this bundle applies to. Omit to apply to all.
claim, return, warranty, recycle, withdrawal Response
Request processed. Check results to see which bundles were stored.
Outcome of a bundle upsert, reported for each bundle in the request.
Number of bundles processed, after merging entries that share a parent_sku.
Number of bundles now stored as requested.
Number of bundles skipped because a SKU was not found.
Number of bundles skipped because a SKU is on more than one variant and no variant was given.
One entry per bundle, in the order they were submitted.