VTEX · Schema

GetSKUAltID

CommerceE-CommerceRetailMarketplacePayments

Properties

Name Type Description
Id integer SKU ID.
ProductId integer Product ID.
NameComplete string Product name and SKU name combined.
ComplementName string Product complement name.
ProductName string Product name.
ProductDescription string Product description. HTML is allowed.
ProductRefId string Product reference ID.
TaxCode string SKU tax code.
SkuName string SKU name.
IsActive boolean Defines if the SKU is active or not.
IsTransported boolean Deprecated field.
IsInventoried boolean Deprecated field.
IsGiftCardRecharge boolean Defines if the purchase of the SKU will generate reward value for the customer.
ImageUrl string SKU image URL.
DetailUrl string Product slug.
CSCIdentification string SKU seller identification.
BrandId string Brand ID.
BrandName string Brand name.
Dimension object
RealDimension object
ManufacturerCode string Identifier provided by the manufacturers to identify their product. This field should be filled in if the product has a specific manufacturer's code.
IsKit boolean Defines whether the SKU is made up of one or more SKUs (part of a kit) (`true`) or not (`false`). Must be enabled if you are adding a kit. Once activated, this definition cannot be reverted.
KitItems array Array with SKU IDs of bundle components.
Services array Array with service IDs that are related to the SKU.
Categories array Categories of the related product.
CategoriesFullPath array Path of categories of the related product.
Attachments array Array with attachment IDs that are related to the product.
Collections array Array with collections IDs that are related to the product.
SkuSellers array Array with related sellers data.
SalesChannels array Array of trade policy IDs.
Images array Array of objects with SKU image details.
SkuSpecifications array Array with related SKU specifications.
ProductSpecifications array Array with related product specifications.
ProductClustersIds string Product cluster IDs separated by comma (`,`).
PositionsInClusters object Product clusters position in each cluster. Structure: "{Product cluster ID}": {Position}. `{Product cluster ID}` is a string, while `{Position}` is an integer.
ProductClusterNames object Product clusters names. Structure: "{Product cluster ID}": "{Product cluster name}". Both the key and the value are strings.
ProductClusterHighlights object Product clusters highlights. Structure: "{Product cluster ID}": "{Product cluster name}". Both the key and the value are strings.
ProductCategoryIds string Category path composed by category IDs separated by `/`.
IsDirectCategoryActive boolean Indicates if the direct product category is active or not.
ProductGlobalCategoryId integer Product global category ID.
ProductCategories object Object containing product categories. Structure: "{CategoryID}": "{CategoryName}". Both the key and the value are strings.
CommercialConditionId integer Commercial condition ID, used to define SKU specific promotions or installment rules. In case of no specific condition, use `1` (default value). This field does not accept `0`. Learn more at [Register
RewardValue number Credit that the customer receives when finalizing an order that includes the SKU. By filling this field out with `1`, the customer receives credit on the site in the selected currency, e.g. U$ 1.
AlternateIds object
AlternateIdValues array Array with values of alternative SKU IDs.
EstimatedDateArrival string SKU estimated arrival date in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format, when the product is on pre-sale. You must take into consideration both the launch date and the freight calculat
MeasurementUnit string Measurement unit. This field should only be used when it is necessary to convert the unit of measure for sale. For example, if a product is sold in boxes, but customers want to buy per square meter (m
UnitMultiplier number Multiple number of SKU. If the multiplier is 5.0000, the product can be added in multiple quantities of 5, 10, 15, 20, onward.
InformationSource string Information source.
ModalType string Links an unusual type of SKU that needs special transportation, such as meat, glass, or a mattress, to a carrier specialized in delivering it. This field should be filled in with the name of the modal
KeyWords string Keywords related to the product.
ReleaseDate string Release date of the product.
ProductIsVisible boolean Defines if the product is visible or not.
ShowIfNotAvailable boolean Defines if the product will be shown if it is not available.
IsProductActive boolean Defines if the product is active or not.
ProductFinalScore integer Product final score.
View JSON Schema on GitHub

JSON Schema

vtex-getskualtid-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/GetSKUAltID",
  "title": "GetSKUAltID",
  "required": [
    "Id",
    "ProductId",
    "NameComplete",
    "ProductName",
    "ProductDescription",
    "SkuName",
    "IsActive",
    "IsTransported",
    "IsInventoried",
    "IsGiftCardRecharge",
    "ImageUrl",
    "DetailUrl",
    "CSCIdentification",
    "BrandId",
    "BrandName",
    "Dimension",
    "RealDimension",
    "ManufacturerCode",
    "IsKit",
    "KitItems",
    "Services",
    "Categories",
    "Attachments",
    "Collections",
    "SkuSellers",
    "SalesChannels",
    "Images",
    "SkuSpecifications",
    "ProductSpecifications",
    "ProductClustersIds",
    "ProductCategoryIds",
    "ProductGlobalCategoryId",
    "ProductCategories",
    "CommercialConditionId",
    "RewardValue",
    "AlternateIds",
    "AlternateIdValues",
    "EstimatedDateArrival",
    "MeasurementUnit",
    "UnitMultiplier",
    "InformationSource",
    "ModalType"
  ],
  "type": "object",
  "properties": {
    "Id": {
      "type": "integer",
      "format": "int32",
      "description": "SKU ID."
    },
    "ProductId": {
      "type": "integer",
      "format": "int32",
      "description": "Product ID."
    },
    "NameComplete": {
      "type": "string",
      "description": "Product name and SKU name combined."
    },
    "ComplementName": {
      "type": "string",
      "description": "Product complement name."
    },
    "ProductName": {
      "type": "string",
      "description": "Product name."
    },
    "ProductDescription": {
      "type": "string",
      "description": "Product description. HTML is allowed."
    },
    "ProductRefId": {
      "type": "string",
      "description": "Product reference ID."
    },
    "TaxCode": {
      "type": "string",
      "description": "SKU tax code."
    },
    "SkuName": {
      "type": "string",
      "description": "SKU name."
    },
    "IsActive": {
      "type": "boolean",
      "description": "Defines if the SKU is active or not."
    },
    "IsTransported": {
      "type": "boolean",
      "deprecated": true,
      "description": "Deprecated field."
    },
    "IsInventoried": {
      "type": "boolean",
      "deprecated": true,
      "description": "Deprecated field."
    },
    "IsGiftCardRecharge": {
      "type": "boolean",
      "description": "Defines if the purchase of the SKU will generate reward value for the customer."
    },
    "ImageUrl": {
      "type": "string",
      "description": "SKU image URL."
    },
    "DetailUrl": {
      "type": "string",
      "description": "Product slug."
    },
    "CSCIdentification": {
      "type": "string",
      "nullable": true,
      "description": "SKU seller identification."
    },
    "BrandId": {
      "type": "string",
      "description": "Brand ID."
    },
    "BrandName": {
      "type": "string",
      "description": "Brand name."
    },
    "Dimension": {
      "$ref": "#/components/schemas/Dimension"
    },
    "RealDimension": {
      "$ref": "#/components/schemas/RealDimension"
    },
    "ManufacturerCode": {
      "type": "string",
      "description": "Identifier provided by the manufacturers to identify their product. This field should be filled in if the product has a specific manufacturer's code."
    },
    "IsKit": {
      "type": "boolean",
      "description": "Defines whether the SKU is made up of one or more SKUs (part of a kit) (`true`) or not (`false`). Must be enabled if you are adding a kit. Once activated, this definition cannot be reverted."
    },
    "KitItems": {
      "type": "array",
      "description": "Array with SKU IDs of bundle components.",
      "items": {
        "type": "string",
        "description": "SKU ID of each bundle component."
      }
    },
    "Services": {
      "type": "array",
      "description": "Array with service IDs that are related to the SKU.",
      "items": {
        "type": "string",
        "description": "Service IDs of each service related to the SKU."
      }
    },
    "Categories": {
      "type": "array",
      "description": "Categories of the related product.",
      "items": {
        "type": "string",
        "description": "Category ID."
      }
    },
    "CategoriesFullPath": {
      "type": "array",
      "description": "Path of categories of the related product.",
      "items": {
        "type": "string",
        "description": "Path composed by category IDs separated by `/`."
      }
    },
    "Attachments": {
      "type": "array",
      "description": "Array with attachment IDs that are related to the product.",
      "items": {
        "$ref": "#/components/schemas/Attachment"
      }
    },
    "Collections": {
      "type": "array",
      "description": "Array with collections IDs that are related to the product.",
      "items": {
        "type": "string",
        "description": "Collection ID."
      }
    },
    "SkuSellers": {
      "type": "array",
      "description": "Array with related sellers data.",
      "items": {
        "$ref": "#/components/schemas/SkuSeller"
      }
    },
    "SalesChannels": {
      "type": "array",
      "description": "Array of trade policy IDs.",
      "items": {
        "type": "integer",
        "format": "int32",
        "description": "Trade policy ID."
      }
    },
    "Images": {
      "type": "array",
      "description": "Array of objects with SKU image details.",
      "items": {
        "$ref": "#/components/schemas/Image"
      }
    },
    "SkuSpecifications": {
      "type": "array",
      "description": "Array with related SKU specifications.",
      "items": {
        "$ref": "#/components/schemas/SkuSpecification"
      }
    },
    "ProductSpecifications": {
      "type": "array",
      "description": "Array with related product specifications.",
      "items": {
        "$ref": "#/components/schemas/ProductSpecification"
      }
    },
    "ProductClustersIds": {
      "type": "string",
      "description": "Product cluster IDs separated by comma (`,`)."
    },
    "PositionsInClusters": {
      "type": "object",
      "description": "Product clusters position in each cluster. Structure: \"{Product cluster ID}\": {Position}.\n\n`{Product cluster ID}` is a string, while `{Position}` is an integer.",
      "additionalProperties": {
        "type": "integer",
        "description": "Product cluster ID.",
        "additionalProperties": {
          "type": "integer",
          "description": "Position."
        }
      }
    },
    "ProductClusterNames": {
      "type": "object",
      "description": "Product clusters names. Structure: \"{Product cluster ID}\": \"{Product cluster name}\". Both the key and the value are strings.",
      "additionalProperties": {
        "type": "string",
        "description": "Product cluster ID.",
        "additionalProperties": {
          "type": "string",
          "description": "Product cluster name."
        }
      }
    },
    "ProductClusterHighlights": {
      "type": "object",
      "description": "Product clusters highlights. Structure: \"{Product cluster ID}\": \"{Product cluster name}\". Both the key and the value are strings.",
      "additionalProperties": {
        "type": "string",
        "description": "Product cluster ID.",
        "additionalProperties": {
          "type": "string",
          "description": "Product cluster highlight."
        }
      }
    },
    "ProductCategoryIds": {
      "type": "string",
      "description": "Category path composed by category IDs separated by `/`."
    },
    "IsDirectCategoryActive": {
      "type": "boolean",
      "description": "Indicates if the direct product category is active or not."
    },
    "ProductGlobalCategoryId": {
      "type": "integer",
      "nullable": true,
      "description": "Product global category ID."
    },
    "ProductCategories": {
      "type": "object",
      "description": "Object containing product categories. Structure: \"{CategoryID}\": \"{CategoryName}\". Both the key and the value are strings.",
      "additionalProperties": {
        "type": "string",
        "description": "Category ID.",
        "additionalProperties": {
          "type": "string",
          "description": "Category name."
        }
      }
    },
    "CommercialConditionId": {
      "type": "integer",
      "format": "int32",
      "description": "Commercial condition ID, used to define SKU specific promotions or installment rules. In case of no specific condition, use `1` (default value). This field does not accept `0`. Learn more at [Registering a commercial condition](https://help.vtex.com/tutorial/registering-a-commercial-condition--tutorials_445).",
      "default": 1
    },
    "RewardValue": {
      "type": "number",
      "description": "Credit that the customer receives when finalizing an order that includes the SKU. By filling this field out with `1`, the customer receives credit on the site in the selected currency, e.g. U$ 1."
    },
    "AlternateIds": {
      "$ref": "#/components/schemas/AlternateIds"
    },
    "AlternateIdValues": {
      "type": "array",
      "description": "Array with values of alternative SKU IDs.",
      "items": {
        "type": "string",
        "description": "Alternative SKU ID."
      }
    },
    "EstimatedDateArrival": {
      "type": "string",
      "nullable": true,
      "description": "SKU estimated arrival date in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format, when the product is on pre-sale. You must take into consideration both the launch date and the freight calculation for the arrival date."
    },
    "MeasurementUnit": {
      "type": "string",
      "description": "Measurement unit. This field should only be used when it is necessary to convert the unit of measure for sale. For example, if a product is sold in boxes, but customers want to buy per square meter (m\u00b2). In common cases, use `\"un\"`."
    },
    "UnitMultiplier": {
      "type": "number",
      "description": "Multiple number of SKU. If the multiplier is 5.0000, the product can be added in multiple quantities of 5, 10, 15, 20, onward."
    },
    "InformationSource": {
      "type": "string",
      "nullable": true,
      "description": "Information source."
    },
    "ModalType": {
      "type": "string",
      "nullable": true,
      "description": "Links an unusual type of SKU that needs special transportation, such as meat, glass, or a mattress, to a carrier specialized in delivering it. This field should be filled in with the name of the modal (e.g. \"Chemicals\" or \"Refrigerated products\"). To learn more about this feature, read our articles [How the modal works](https://help.vtex.com/en/tutorial/how-does-the-modal-work--tutorials_125) and [Setting up modal for carriers](https://help.vtex.com/en/tutorial/configure-modal--3jhLqxuPhuiq24UoykCcqy)."
    },
    "KeyWords": {
      "type": "string",
      "nullable": true,
      "description": "Keywords related to the product."
    },
    "ReleaseDate": {
      "type": "string",
      "nullable": true,
      "description": "Release date of the product."
    },
    "ProductIsVisible": {
      "type": "boolean",
      "description": "Defines if the product is visible or not."
    },
    "ShowIfNotAvailable": {
      "type": "boolean",
      "description": "Defines if the product will be shown if it is not available."
    },
    "IsProductActive": {
      "type": "boolean",
      "description": "Defines if the product is active or not."
    },
    "ProductFinalScore": {
      "type": "integer",
      "description": "Product final score."
    }
  },
  "example": {
    "Id": 310118450,
    "ProductId": 2,
    "NameComplete": "Caixa de Areia Azul Petmate sku test",
    "ComplementName": "",
    "ProductName": "Caixa de Areia Azul Petmate",
    "ProductDescription": "",
    "ProductRefId": "",
    "TaxCode": "",
    "SkuName": "sku test",
    "IsActive": true,
    "IsTransported": true,
    "IsInventoried": true,
    "IsGiftCardRecharge": false,
    "ImageUrl": "https://lojadobreno.vteximg.com.br/arquivos/ids/155451-55-55/caixa-areia-azul-petmate.jpg?v=637139451191670000",
    "DetailUrl": "/caixa-de-areia-azul-petmate/p",
    "CSCIdentification": null,
    "BrandId": "2000005",
    "BrandName": "Petmate",
    "IsBrandActive": true,
    "Dimension": {
      "cubicweight": 0.2083,
      "height": 10.0,
      "length": 10.0,
      "weight": 10.0,
      "width": 10.0
    },
    "RealDimension": {
      "realCubicWeight": 0.0,
      "realHeight": 0.0,
      "realLength": 0.0,
      "realWeight": 0.0,
      "realWidth": 0.0
    },
    "ManufacturerCode": "123",
    "IsKit": false,
    "KitItems": [],
    "Services": [],
    "Categories": [],
    "CategoriesFullPath": [
      "/3/15/",
      "/3/",
      "/1/"
    ],
    "Attachments": [],
    "Collections": [],
    "SkuSellers": [
      {
        "SellerId": "1",
        "StockKeepingUnitId": 310118450,
        "SellerStockKeepingUnitId": "310118450",
        "IsActive": true,
        "FreightCommissionPercentage": 0.0,
        "ProductCommissionPercentage": 0.0
      }
    ],
    "SalesChannels": [
      1,
      3
    ],
    "Images": [
      {
        "ImageUrl": "https://lojadobreno.vteximg.com.br/arquivos/ids/155451/caixa-areia-azul-petmate.jpg?v=637139451191670000",
        "ImageName": null,
        "FileId": 155451
      }
    ],
    "Videos": [],
    "SkuSpecifications": [],
    "ProductSpecifications": [],
    "ProductClustersIds": "151,158",
    "PositionsInClusters": {
      "151": 1,
      "158": 2
    },
    "ProductClusterNames": {
      "151": "asdfghj",
      "158": "Cole\u00e7\u00e3o halloween"
    },
    "ProductClusterHighlights": {
      "151": "asdfghj"
    },
    "ProductCategoryIds": "/3/15/",
    "IsDirectCategoryActive": true,
    "ProductGlobalCategoryId": 5000,
    "ProductCategories": {
      "15": "Caixa de Areia",
      "3": "Higiene",
      "1": "Alimenta\u00e7\u00e3o"
    },
    "CommercialConditionId": 1,
    "RewardValue": 0.0,
    "AlternateIds": {
      "RefId": "1"
    },
    "AlternateIdValues": [
      "1"
    ],
    "EstimatedDateArrival": null,
    "MeasurementUnit": "un",
    "UnitMultiplier": 1.0,
    "InformationSource": null,
    "ModalType": null,
    "KeyWords": "",
    "ReleaseDate": "2020-01-06T00:00:00Z",
    "ProductIsVisible": true,
    "ShowIfNotAvailable": true,
    "IsProductActive": true,
    "ProductFinalScore": 0
  }
}