Skip to main content

​
Endpoint

POST https://api.tiny.com.br/api2/produto.atualizar.precos.php?token={token}

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
precosobject[]obrigatórioDados dos preços conforme layout

​
Estrutura do parâmetro “precos”

CampoTipoTamanhoOcorrênciaDescrição
precos[]object[]-obrigatórioElemento para representar conjunto de preços
precos[].idint-obrigatórioNúmero de identificação do Produto na Olist
precos[].precodecimal-opcionalPreço do produto
precos[].preco_promocionaldecimal-opcionalPreço promocional do produto
Campos preco e preco_promocional utilizam ”.” (ponto) como separador decimal, exemplo “5.25”.
Campo preco_promocional só será atualizado se empresa tiver a extensão “Preço promocional” instalada.

​
Retorno

CampoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela “Status de Processamento”
retorno.statusstring-obrigatórioStatus: “OK”, “Erro” ou “Parcial”
retorno.registros[]list-condicionalLista de resultados
retorno.registros[].registroobject-condicionalRegistro de atualização de preços
retorno.registros[].registro.sequenciaint-condicionalNúmero sequencial do registro
retorno.registros[].registro.statusstring-condicionalStatus: “OK” ou “Erro”
retorno.registros[].registro.codigo_erroint-condicionalCódigo do erro conforme tabela
retorno.registros[].registro.erros[]object[]-condicionalLista de erros encontrados
retorno.registros[].registro.erros[].campostring-condicionalCampo contendo erro
retorno.registros[].registro.erros[].errostring-condicionalMensagem de erro
retorno.registros[].registro.idint-obrigatórioNúmero de identificação do Produto
retorno.registros[].registro.precodecimal-obrigatórioPreço do produto
retorno.registros[].registro.preco_promocionaldecimal-condicionalPreço promocional do produto

​
Exemplo de chamada

$precos = { "precos" : [{...}, {...}, ...] };
$token = "coloque aqui a sua chave da api";
$url = "https://api.tiny.com.br/api2/produto.atualizar.precos.php?token={$token}";
$data = $precos;

enviarREST($url, $data);

​
Exemplos de retorno

​
Sucesso completo

{
  "retorno": {
    "status_processamento": "3",
    "status": "OK",
    "registros": [
      {
        "registro": {
          "id": "123",
          "sequencia": 1,
          "status": "OK",
          "preco": 15,
          "preco_promocional": 10
        }
      }
    ]
  }
}

​
Sucesso parcial

{
  "retorno": {
    "status_processamento": "4",
    "status": "Parcial",
    "registros": [
      {
        "registro": {
          "id": "123",
          "sequencia": 1,
          "status": "OK",
          "preco": 15,
          "preco_promocional": 10
        }
      },
      {
        "registro": {
          "id": "456",
          "sequencia": 2,
          "status": "Erro",
          "codigo_erro": "31",
          "erros": {
            "campo": "preco",
            "erro": "O valor de 'preco' não é um número válido."
          }
        }
      }
    ]
  }
}

​
Erro - Token inválido

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": "1",
    "erros": [
      {
        "erro": "token inválido"
      }
    ]
  }
}

​
Erro - Validação

{
  "retorno": {
    "status_processamento": "2",
    "status": "Erro",
    "registros": [
      {
        "registro": {
          "id": "123",
          "sequencia": 1,
          "status": "Erro",
          "codigo_erro": "31",
          "erros": {
            "campo": "preco",
            "erro": "O valor de 'preco' não é um número válido."
          }
        }
      }
    ]
  }
}