Skip to main content
Requer instalação do módulo “API para estoque em tempo real” via página de Extensões da Olist.

​
Endpoint

POST https://api.tiny.com.br/api2/lista.atualizacoes.produtos

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
dataAlteracaostringobrigatórioData de alteração no formato dd/mm/yyyy hh:mm:ss (pode informar apenas data: 01/01/2011 ou com hora: 01/01/2012 15:30:00)
formatostringobrigatórioFormato do retorno (json)
paginaintopcionalNúmero da página (padrão: 1; são listados 100 registros por página)

​
Retorno

CampoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela “Status de Processamento”
retorno.statusstring-obrigatório”OK” ou “Erro”
retorno.codigo_erroint-condicionalCódigos de erro (somente se status=“Erro”)
retorno.erros[]list-condicionalLista dos erros encontrados
retorno.erros[].errostring-condicionalDescrição do erro
retorno.produtos[]list-condicionalLista de resultados da pesquisa
retorno.produtos[].produtoobject-condicionalElemento representando um produto
retorno.produtos[].produto.idint-condicionalNúmero de identificação do produto
retorno.produtos[].produto.nomestring120condicionalNome do produto
retorno.produtos[].produto.codigostring30condicionalCódigo do produto
retorno.produtos[].produto.unidadestring3condicionalUnidade do produto
retorno.produtos[].produto.localizacaostring50condicionalLocalização física no estoque
retorno.produtos[].produto.precodecimal-condicionalPreço de venda
retorno.produtos[].produto.preco_promocionaldecimal-condicionalPreço promocional
retorno.produtos[].produto.descricao_complementarstring-condicionalDescrição complementar
retorno.produtos[].produto.ncmstring-condicionalNCM do produto
retorno.produtos[].produto.origemint-condicionalOrigem do produto
retorno.produtos[].produto.gtinstring-condicionalGTIN do produto
retorno.produtos[].produto.gtin_embalagemstring-condicionalGTIN da embalagem
retorno.produtos[].produto.peso_liquidodecimal-condicionalPeso líquido
retorno.produtos[].produto.peso_brutodecimal-condicionalPeso bruto
retorno.produtos[].produto.estoque_minimodecimal-condicionalQuantidade mínima em estoque
retorno.produtos[].produto.estoque_maximodecimal-condicionalQuantidade máxima em estoque
retorno.produtos[].produto.id_fornecedorint-condicionalID do fornecedor
retorno.produtos[].produto.codigo_fornecedorstring-condicionalCódigo do fornecedor
retorno.produtos[].produto.codigo_pelo_fornecedorstring30condicionalCódigo do produto pelo fornecedor
retorno.produtos[].produto.unidade_por_caixaint-condicionalUnidades por caixa
retorno.produtos[].produto.preco_custodecimal-condicionalPreço de custo
retorno.produtos[].produto.situacaostring-condicionalSituação do produto
retorno.produtos[].produto.tipostring-condicionalTipo do produto
retorno.produtos[].produto.classe_ipistring-condicionalClasse de IPI
retorno.produtos[].produto.valor_ipi_fixodecimal-condicionalValor do IPI
retorno.produtos[].produto.cod_lista_servicosstring-condicionalCódigo de lista de serviços
retorno.produtos[].produto.tipo_variacaostring1condicionalTipo de variação (N=Normal, P=Pai, V=Variação)
retorno.produtos[].produto.obsstring-condicionalObservações do produto
retorno.produtos[].produto.data_alteracaodatetime-condicionalData de alteração (formato: dd/mm/yyyy hh:mm:ss)
retorno.pagina--condicionalNúmero da página (presente em sucesso)
retorno.numero_paginas--condicionalTotal de páginas (presente em sucesso)
Valores decimais utilizam ”.” (ponto) como separador de decimais (exemplo: “5.25”).
Data de alteração utiliza formato “dd/mm/yyyy hh:mm:ss”.

​
Exemplo de chamada

curl -X POST https://api.tiny.com.br/api2/lista.atualizacoes.produtos \
  -d "token=CHAVE_API&dataAlteracao=01/01/2012%2015:30:00&formato=JSON"

​
Exemplos de retorno

​
Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "pagina": "1",
    "numero_paginas": "1",
    "produtos": [
      {
        "produto": {
          "id": 46829062,
          "codigo": "123",
          "nome": "produto teste",
          "unidade": "UN",
          "preco": "1.20",
          "data_alteracao": "01/01/2012 15:25:55"
        }
      },
      {
        "produto": {
          "id": 46829066,
          "codigo": "1234",
          "nome": "produto teste 2",
          "unidade": "PC",
          "preco": "15.25",
          "data_alteracao": "01/01/2012 15:25:55"
        }
      }
    ]
  }
}

​
Erro - Token inválido

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [
      {
        "erro": "token invalido"
      }
    ]
  }
}

​
Erro - Consulta sem registros

{
  "retorno": {
    "status_processamento": 2,
    "status": "Erro",
    "codigo_erro": 20,
    "erros": [
      {
        "erro": "A Consulta não retornou registros"
      }
    ]
  }
}