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.

  • 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.