Updating Product Specifications Unviable due to Lacking Property on GET Resp. JSON

Known issues

ID: 301725

No Fix

Published on 6/28/2022

•

Last update on 2/16/2024

Summary

The GET Product Specification response JSON lacks an essential property to update preexisting specifications if so needed by the user.

Simulation

Use a GET product specification such as the one we currently have documented in our devdocs: https://merch.vtexcommercestable.com.br/api/catalog/pvt/product/17/specification?an=merch

In this example, we have the following response:

${"base64":" ","img":{"width":892,"height":551,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":45713,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/known-issues/Catalog/updating-product-specifications-unviable-due-to-lacking-property-on-get-resp-json_1.png"}}$

Notice that I can get the "Value", "Id" and "name" with this req. This is currently the only way to get this kind of data via REST API.

I've used the following request to update this (after getting which is the fielded and fieldvalueid by consulting the category APIs): https://merch.vtexcommercestable.com.br/api/catalog/pvt/product/17/specification?an=merch

${"base64":" ","img":{"width":1193,"height":373,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":37089,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/known-issues/Catalog/updating-product-specifications-unviable-due-to-lacking-property-on-get-resp-json_2.png"}}$

Notice that an unique ID is returned in the response, this is the association ID of the specification with the product.

However, for an user to update any preexisting value, it will be needed to inform this ID and it's only returned in the response of the first insertion and nowhere else (via API).

This issue is the opening of the acknowledgement of this problem and tracking of a future possible adjustment, even if it's not a product bug per see but a faulty/incomplete usability.

Workaround

Use the catalog specification export (https://merch.myvtex.com/admin/Site/ProdutoExportacaoImportacaoEspecificacaoV2.aspx) to get the desired ID association ID:

${"base64":" ","img":{"width":1454,"height":422,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":74948,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/known-issues/Catalog/updating-product-specifications-unviable-due-to-lacking-property-on-get-resp-json_3.png"}}$

Use a delete specification for the old specification and send a new one, in which the response will come with a new ID to be saved.