> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/informacoes/informacoes.md).

# Informações

O módulo **Informações** reúne endpoints de **consulta** que retornam listas de apoio da sua loja: os **status de pedidos** disponíveis na plataforma, as **formas de entrega** ativas e as **formas de pagamento** ativas.

Esses códigos são úteis, por exemplo, para saber qual `Codigo` de status usar ao **alterar o status de um pedido**, ou para identificar as formas de entrega e pagamento que aparecem nos pedidos.

{% hint style="info" %}
Todos os endpoints deste módulo são **GET** e retornam **listas simples** — **não** são paginados.

A referência completa de cada campo está no simulador online:

{% embed url="<https://api.toplojas.com.br/doc/#/Informa%C3%A7%C3%B5es>" %}
{% endhint %}

## 📋 Status de Pedidos

Retorna a lista de **status de pedidos** disponíveis na plataforma, com o `Codigo` de cada status.

```
GET /informacoes/status/
```

Use o `Codigo` retornado aqui para saber qual valor informar ao **alterar o status** de um pedido:

{% content-ref url="/pages/Z9rIbMa20RTCqjphukbt" %}
[Alterar Status](/pedidos/alterar-status.md)
{% endcontent-ref %}

### 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/informacoes/status/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

### 📤 Exemplo de resposta

```json
[
  {
    "Codigo": 3,
    "NomeStaff": "Aguardando Pagamento"
  }
]
```

## 🚚 Formas de Entrega

Retorna a lista de **formas de entrega ativas** na loja, com o `Codigo` e o `Nome` de cada uma.

```
GET /informacoes/formas-entrega/
```

### 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/informacoes/formas-entrega/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

### 📤 Exemplo de resposta

```json
[
  {
    "Codigo": 1747,
    "Nome": "Sedex"
  }
]
```

## 💳 Formas de Pagamento

Retorna a lista de **formas de pagamento ativas** na loja. Cada item traz o `Codigo`, o `Grupo` (tipo de pagamento, ex.: Cartão de Crédito, Boleto Bancário), o `Gateway` atrelado (ex.: Cielo, Stone, Rede) e o `Nome` exibido na loja.

```
GET /informacoes/formas-pagamento/
```

### 📥 Exemplo de requisição

```bash
curl -X GET "https://api.toplojas.com.br/informacoes/formas-pagamento/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

### 📤 Exemplo de resposta

```json
[
  {
    "Codigo": 35876,
    "Grupo": "Cartão de Crédito",
    "Gateway": "CIELO - Webservice 3.0",
    "Nome": "Visa"
  }
]
```