This POST API is used to create new SKUs or update existing SKUs along with their associated data.
catalogKey (catalogId)
The unique internal identifier of a catalog in the system. This parameter ensures that all API operations are performed within the correct catalog associated with a specific customer.
replaceAttributes: would typically control how SKU attributes are handled during an update operation:
- If true:
All existing attributes of the SKU would be fully replaced by the attributes provided in the request payload. Any attributes not included in the request would be removed. - If false (or not provided):
The API would merge/update only the provided attributes, leaving existing attributes unchanged.
Request Parameters
amazeKeySkuIdentifier (Integer)
Internal identifier of the SKU in PCC.
customerSkuId (string)
External ID of SKU.
skuTitle (string)
Title associated with SKU.
type (string)
describes the type of SKU with possible values SKU/Product Family.
Taxonomy Details
residentTaxonomy.taxonomyPath (string)
Path of the taxonomy where the SKU resides.
residentTaxonomy.taxonomyCustomerId (string)
Customer ID of the taxonomy where the SKU resides.
crosslistedToTaxonomies.taxonomyPath (string)
Path of the taxonomy where the SKU is cross-listed.
crosslistedToTaxonomies.taxonomyCustomerId (string)
Customer ID of the taxonomy where the SKU is cross-listed.
mirroredToTaxonomies.taxonomyPath (string)
Path of the taxonomy where the SKU is mirrored.
mirroredToTaxonomies.taxonomyCustomerId (string)
Customer ID of the taxonomy where the SKU is mirrored.
mirroredToTaxonomies.domainName (string)
Name of the domain in which the taxonomy is mirrored.
SKU Attributes
skuAttributes.attributeName (string)
Name of the attribute used in the SKU.
skuAttributes.skuAttributeValues.value (string)
Value of the attribute associated with the SKU.
skuAttributes.customerAttributeId (string)
Customer ID of the attribute used in the SKU.
skuAttributes.locked (string)
Indicates whether the attribute is locked for modification.
skuAttributes.skuAttributeValues.uomName (string)
Unit of measure name for the attribute value.
skuAttributes.skuAttributeValues.uomSymbol (string)
Unit of measure symbol for the attribute value.
Digital Assets
digitalAssets.digitalAssetName (string)
Name of the digital asset associated with the SKU.
digitalAssets.digitalAssetPublicURL (string)
Public URL to access the digital asset.
digitalAssets.digitalAssetThumbnailPublicURL (string)
Public URL for the thumbnail of the digital asset.
digitalAssets.isPrimary (string)
Indicates whether the asset is the primary asset.
Successful response
Response Parameters
responseSummary.Count of SKUs sent in payload
Total number of SKUs included in the request payload.
responseSummary.Count of SKUs successfully loaded into PCC
Number of SKUs that were successfully created or updated in the system.
responseSummary.Count of SKUs which errored entirely
Number of SKUs that failed completely during processing.
responseSummary.Count of SKUs which errored partially
Number of SKUs that encountered partial errors during processing.
responseSummary.Count of SKUs newly added
Number of new SKUs created in the system.
responseSummary.Count of SKUs updated or moved
Number of SKUs that were updated or moved.
responseSummary.Count of new DAs
Number of digital assets created.
responseSummary.Newly added CustomerSkuIds
List of external SKU IDs that were newly created.
responseSummary.Updated CustomerSkuIds
List of external SKU IDs that were updated.
failedSkuReport.skuKey
Internal identifier of the SKU that failed during processing.
failedSkuReport.customerSkuId
External ID of the SKU that failed.
failedSkuReport.partialFail
Indicates whether the failure was partial or complete.
failedSkuReport.failedRecords.location
Location in the payload where the failure occurred.
failedSkuReport.failedRecords.payloadData
The specific data in the payload that caused the failure.
failedSkuReport.failedRecords.reason
Reason for the failure of the SKU operation.