Skip to main content

​
Endpoint

POST https://api.tiny.com.br/api2/listas.precos.pesquisa.php

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
formatostringobrigatórioFormato do retorno (json)
pesquisastringopcionalDescrição ou parte da descrição da lista
paginaintopcionalNúmero da página (padrão: 1, 100 registros por página)

​
Retorno

CampoTipoOcorrênciaDescrição
retorno.status_processamentointobrigatórioStatus conforme tabela de processamento
retorno.statusstringobrigatório”OK” ou “Erro”
retorno.codigo_errointcondicionalConforme tabela de códigos
retorno.paginaintobrigatórioNúmero da página retornada
retorno.numero_paginasintobrigatórioTotal de páginas
retorno.registros[].registro.idintcondicionalID da lista de preços
retorno.registros[].registro.descricaostringcondicionalDescrição (até 30 caracteres)
retorno.registros[].registro.acrescimo_descontodecimalcondicionalPorcentagem (usa ”.” como separador)
Campo acrescimo_desconto utiliza ”.” (ponto) como separador decimal.

​
Exemplo de chamada

$url = 'https://api.tiny.com.br/api2/listas.precos.pesquisa.php';
$token = 'sua_chave_api';
$pesquisa = 'xxxxx';
$data = "token=$token&pesquisa=$pesquisa&formato=JSON";

​
Exemplos de retorno

​
Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "pagina": "1",
    "numero_paginas": "1",
    "registros": [
      {
        "registro": {
          "id": 117991558,
          "descricao": "Amigos",
          "acrescimo_desconto": -5
        }
      },
      {
        "registro": {
          "id": 303755803,
          "descricao": "Atacado",
          "acrescimo_desconto": -10
        }
      }
    ]
  }
}

​
Erro

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