> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Exceções das Listas de Preços

> Serviço destinado a consultar exceções de listas de preços.

## Endpoint

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

## Parâmetros

| Parâmetro    | Tipo   | Ocorrência  | Descrição                                              |
| ------------ | ------ | ----------- | ------------------------------------------------------ |
| token        | string | obrigatório | Chave de identificação da empresa                      |
| formato      | string | obrigatório | Formato de retorno (json)                              |
| idListaPreco | int    | obrigatório | ID da lista de preços                                  |
| idProduto    | int    | opcional    | Filtra por produto específico                          |
| pagina       | int    | opcional    | Página desejada (padrão: 1, máx. 100 registros/página) |

## Retorno

| Campo                                            | Tipo    | Ocorrência  | Descrição               |
| ------------------------------------------------ | ------- | ----------- | ----------------------- |
| retorno.status\_processamento                    | int     | obrigatório | Código do processamento |
| retorno.status                                   | string  | obrigatório | "OK" ou "Erro"          |
| retorno.pagina                                   | int     | obrigatório | Número da página        |
| retorno.numero\_paginas                          | int     | obrigatório | Total de páginas        |
| retorno.registros\[].registro.id                 | int     | condicional | ID da exceção           |
| retorno.registros\[].registro.id\_lista\_preco   | int     | condicional | ID da lista             |
| retorno.registros\[].registro.id\_produto        | int     | condicional | ID do produto           |
| retorno.registros\[].registro.preco              | decimal | condicional | Preço de venda          |
| retorno.registros\[].registro.preco\_promocional | decimal | condicional | Preço promocional       |

> Valores decimais utilizam "." (ponto) como separador.

## Exemplo de chamada

```php theme={null}
$url = 'https://api.tiny.com.br/api2/listas.precos.excecoes.php';
$data = "token=SUA_CHAVE&idListaPreco=160107407&formato=JSON";
```

## Exemplos de retorno

### Sucesso

```json theme={null}
{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "registros": [
      {
        "registro": {
          "id": 439592059,
          "id_lista_preco": 160107407,
          "preco": 27.90
        }
      }
    ]
  }
}
```

### Erro

```json theme={null}
{
  "retorno": {
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [{"erro": "token invalido"}]
  }
}
```