Fala @dgpgean tudo certo? Qual escopo de API você está usando?
Para capturar essas informações, você pode utilizar a API de Produtos e SKUs da VTEX, especificamente o endpoint que retorna os detalhes do SKU. Esse endpoint fornece todos os dados necessários sobre o SKU, incluindo atributos como peso, dimensões e outras características de envio.
Exemplo de como utilizar:
- Chamada à API: Use o seguinte endpoint para buscar os dados do SKU:
GET /api/catalog_system/pvt/sku/stockkeepingunitbyid/{skuId}
Esse endpoint retorna informações detalhadas do SKU, como as dimensões (altura, largura, comprimento) e peso, que são usados para cálculo de frete.
3. Uso no Frontend: Se você está construindo a página PDP (Product Detail Page) e deseja exibir essas informações, você pode fazer uma chamada a essa API no frontend para recuperar e exibir os dados obrigatórios do SKU diretamente na PDP.
4. Alternativa: Se você estiver lidando com as especificações do produto, pode ser possível criar um campo customizado para inserir essas informações como especificações e acessá-las via useProduct
, mas isso não garantirá a mesma precisão dos dados do SKU.
Essa abordagem permite que você acesse diretamente as informações do SKU cadastradas.
Outro exemplo:
Utilizando os IDs dos SKUs obtidos na requisição anterior, você deve fazer um GET na rota http://{{accountName}}.vtexcommercestable.com.br/api/catalog_system/pvt/sku/stockkeepingunitbyid/{{skuId}} para obter as informações sobre as propriedades dos SKUs. A resposta deste request irá retornar as informações que caracterizam o SKU, como Nome, Marca, Categoria, Coleções, Imagem, se o SKU está Ativo ou Inativo e Políticas Comerciais, por exemplo. As informações de preço e estoque ainda não são obtidas nesta etapa.
Parâmetros da API:
{accountName}: Nome da conta da sua loja na VTEX.
{{skuId}}: ID do SKU a ser consultado.
Exemplo de resposta:
{
"Id": 20,
"ProductId": 18,
"NameComplete": "Newest Iron 220",
"ProductName": "Newest Iron",
"ProductDescription": "Newest iron",
"TaxCode": "",
"SkuName": "220",
"IsActive": true,
"IsTransported": true,
"IsInventoried": true,
"IsGiftCardRecharge": false,
"ImageUrl": "http://worldshopping.vteximg.com.br/arquivos/ids/155438-55-55/image-5a949c715cf84a7e9cac11cb745bfba9.jpg?v=636633199310730000",
"DetailUrl": "/newest-iron-18/p",
"CSCIdentification": null,
"BrandId": "2000000",
"BrandName": "Brand name",
"Dimension": {
"cubicweight": 0.0002,
"height": 1,
"length": 1,
"weight": 1,
"width": 1
},
"RealDimension": {
"realCubicWeight": 0,
"realHeight": 0,
"realLength": 0,
"realWeight": 0,
"realWidth": 0
},
"ManufacturerCode": null,
"IsKit": false,
"KitItems": [],
"Services": [],
"Categories": [],
"Attachments": [],
"Collections": [],
"SkuSellers": [
{
"SellerId": "1",
"StockKeepingUnitId": 20,
"SellerStockKeepingUnitId": "20",
"IsActive": true,
"FreightCommissionPercentage": 0,
"ProductCommissionPercentage": 0
},
{
"SellerId": "jbsusaqa",
"StockKeepingUnitId": 20,
"SellerStockKeepingUnitId": "888898",
"IsActive": true,
"FreightCommissionPercentage": 0,
"ProductCommissionPercentage": 10
}
],
"SalesChannels": [
1,
2,
3,
4,
5,
6
],
"Images": [
{
"ImageUrl": "http://worldshopping.vteximg.com.br/arquivos/ids/155438/image-5a949c715cf84a7e9cac11cb745bfba9.jpg?v=636633199310730000",
"ImageName": null,
"FileId": 155438
}
],
"SkuSpecifications": [],
"ProductSpecifications": [],
"ProductClustersIds": "137,139",
"ProductCategoryIds": "/1/2/",
"ProductGlobalCategoryId": 783,
"ProductCategories": {
"1": "Choir & Voice",
"2": "For Men"
},
"CommercialConditionId": 1,
"RewardValue": 0,
"AlternateIds": {
"RefId": "888898"
},
"AlternateIdValues": [
"888898"
],
"EstimatedDateArrival": null,
"MeasurementUnit": "un",
"UnitMultiplier": 1,
"InformationSource": "Indexer",
"ModalType": null
}
Veja mais informações no documento: 2 - Obter os dados sobre as propriedades dos SKUs
Espero que estas informações te ajude e se sim, marque-a como solução.
Abs,
Estevão.