Resolving duplicate items
When identical products appear under different identifiers (for example, GTIN, UPC, or WPID), they’re treated as duplicates. After you review the item details, choose one of two paths:
- Confirm duplicates and merge your offer into the existing catalog item.
- Contest duplicates if you believe the items are unique.
How it works (decision flow)
- Review duplicates identified in your catalog (you can use GET All items API with
showDuplicateItemInfo=true). - If they are duplicates, submit a Bulk Item Setup feed with feed type
SPLIT_MERGEto confirm the items are duplicates so your offer merges into the correct catalog item. - If the items are not duplicates, use the Dispute submission API to contest the decision.
- Check the dispute status using the Dispute status API.
Track outcomes:
- For merges, monitor your feed processing result.
- For contests, poll the duplicate Dispute status API endpoint until items reach the COMPLETED status.
Updated 11 days ago
