setProducts

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.

Parâmetros do Corpo da Requisição

plataforma char(20) required
Identificador da plataforma (ERP, App, etc...) que está efetuando a alteração.
produtos array required
Lista de produtos a serem alterados. É obrigatório haver pelo menos 1 item na listagem, e, para cada item, é obrigatório haver pelo menos 1 campo a ser alterado (os campos id e ref servem apenas para identificar qual o produto a ser alterado).

array
object
- id int required Campo de Identificação (inalterável)
  ID do produto a ser alterado. Pode-se usar o campo ref 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 campo id 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 com fimPromo.
- fimPromo date(Y-m-d)
  Data final da promoção. Deve ser informada junto com iniPromo.
- nome char(100)
  Nome do produto.
- gtin char(50)
  Código GTIN (EAN) do produto.
- ativo boolean
  true para ativo e false 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.

Parâmetros do Corpo da Requisição

Exemplos de Requisição