Update Catalog Mapping

Changed on

Updates existing catalog rows of one saved branch (vendor_uid), identified by vendor_catalog_uid: you can change the linked Zuper or supplier option, SKU, unit of measure, cost and remarks. Each row's cost is refreshed from the supplier's price for that branch when one is returned (not for a branch that does not stock the item); otherwise the vendor_cost you send is stored. Zuper may reuse a supplier price answer for up to 15 minutes, so a price can be that old. When a row's option mapping changes, rows at the provider's other branches that used the old supplier option are re-linked in the same request (mapping_changes, affected_vendors); when its unit changes, the product's rows at other branches are re-priced in the new unit in the background (uom_propagation). All rows are saved together or not at all, and only one update per branch can run at a time (429 otherwise). Instead of an option UID, an entry can name the Zuper option in zuper_product_option_name: Zuper reuses the product option with that name or creates it, and reports the outcome in data.zuper_option_resolutions. Options created this way are kept even if the rest of the update then fails. Admin only: the API key must belong to an admin user; other roles receive 405 Access Denied.

put/supplier_provider/{supplier_provider_uid}/catalog_map

Request

  • Base URL
    https://dc-region.zuperpro.com/api
  • URL
    https://dc-region.zuperpro.com/api/supplier_provider/{supplier_provider_uid}/catalog_map
  • Auth
    API key in header x-api-key

Path parameters

supplier_provider_uidstring required

UID of the supplier provider. It must be connected (connection_status is CONNECTED).

Request body

vendor_uidstring required

Required. UID of the saved branch (Zuper vendor) of this supplier provider whose rows are being updated.

Response

200

type'success'
titlestring
messagestring
countinteger

Rows updated for the branch in vendor_uid.

mapping_changesinteger

Number of entries whose new option mapping was also applied to rows at other branches.

Changes