POST /tmwxdapi/setProducts
Altera alguns campos dos produtos cadastrados
Para que os logs de alteração sejam precisos, é obrigatório informar a plataforma (isto é, o sistema) que está fazendo a alteração.
id
e
ref
servem apenas para identificar qual o produto a ser alterado).
object
- id int required Campo de Identificação (inalterável)
ID do produto a ser alterado. Pode-se usar o camporef
no lugar deste. Mas nunca use ambos.- ref char(40) required Campo de Identificação (inalterável)
Referência (SKU) do produto a ser alterado. Pode-se usar o campoid
no lugar deste. Mas nunca use ambos.
Obs: Se precisar alterar uma variação (característica), informe neste campo a referência (SKU) da variação a ser alterada.- estoque int
Estoque local do produto.- estoqueFornecedor int
Estoque no Fornecedor do produto.- valor decimal(10,2)
Valor do produto.- valorAtacado decimal(10,2)
Valor de Atacado do produto.- valorPromo decimal(10,2)
Valor Promocional do produto. Deixe 0 (zero) para não ter promoção.- iniPromo date(Y-m-d)
Data inicial da promoção. Deve ser informada junto comfimPromo
.- fimPromo date(Y-m-d)
Data final da promoção. Deve ser informada junto cominiPromo
.- nome char(100)
Nome do produto.- gtin char(50)
Código GTIN (EAN) do produto.- ativo boolean
true
para ativo efalse
para inativo- peso int
Peso do produto em gramas.- altura int
Altura do produto em centímetros.- largura int
Largura do produto em centímetros.- comprimento int
Comprimento do produto em centímetros.- diasPrazo int
Acréscimo (em dias) ao prazo do frete.- diasPrazoFornecedor int
Acréscimo (em dias) ao prazo do frete quando é usado o estoque do fornecedor.- descricao text
Descrição do produto. Aceita código HTML.- descCurta char(250)
Descrição curta do produto.- keyWords char(250)
Palavras-chave para o produto.
Se o produto informado possuir variações (características), não será possível alterar os estoques
do produto, pois são controlados por cada conjunto de características. Para alterar os estoques neste caso,
utilize o recurso setProperties.
Para isso você deve informar a referência (SKU) final, ou seja, a
referência da variação.
POST /tmwxdapi/setProducts Dados vindos da API na Loja Modelo Acesse o Teste: Runscope Request (JSON): { "plataforma": "tmwecommerce", "produtos": [ { "ref": "TESTE03", "estoque": 99, "valor": 9999.99, "valorPromo": 8888.88, "iniPromo": "2017-03-24", "fimPromo": "2017-12-31" }, { "ref": "TESTE10", "estoqueFornecedor": 10, "diasPrazoFornecedor": 2, "valor": 9999.99 } ] }
Response (JSON): { "status": true, "registrosAlterados": 2, "erros": [] }
POST /tmwxdapi/setProducts Dados vindos da API na Loja Modelo Acesse o Teste: Runscope Request (JSON): { "plataforma": "tmwecommerce", "produtos": [ { "ref": "TESTE10", "valor": "R$ 80,00", "estoque": "30 peças" } ] }
Response (JSON): { "status": false, "registrosAlterados": 0, "erros": [ { "ref": "TESTE10", "msg": [ "Estoque informado é invalido", "Valor informado é invalido" ], "errorCode": null } ] }
Quando errorCode
não for nulo, trata-se de um erro interno. Favor nos enviar o conteúdo para análise.