---
title: "Consultar todos os pedidos"
method: GET
path: "/orders"
---

# Consultar todos os pedidos

`GET /orders`

Obtenha a lista e as informações de todos os pedidos cadastrados.

## Query parameters

- `merchant_id` string
- `number` string
- `reference` string
- `status` 'DRAFT' | 'ENTERED' | 'CANCELED' | 'PAID' | 'RE-ENTERED'
- `terminal_number` string
- `page` string
- `page_size` string
- `last_query_date` string

## Headers

- `client-id` string, required
- `access-token` string, required
- `merchant-id` string, required

## Response `200`

Consulta efetuada com sucesso

- object
  - `id` string — UUID que identifica unicamente o pedido
  - `number` string — Número do pedido. Geralmente, esse número representa o identificador do pedido em um sistema externo através da integração com parceiros.
  - `reference` string — Referência do pedido. Utilizada para facilitar seu acesso ou localização.
  - `status` 'ENTERED' | 'RE-ENTERED' | 'PAID' | 'CLOSED' | 'DRAFT' — Status do pedido.
  - `created_at` string — Data de criação do pedido. A data deve estar no formato: YYYY-MM-DDThh:mm:ssZ.
  - `updated_at` string — Data da última atualização do pedido. A data deve estar no formato: YYYY-MM-DDThh:mm:ssZ
  - `items` object
    - `sku` string — SKU do produto
    - `name` string — Nome do produto
    - `unit_price` string — Valor unitário do produto em centavos. Exemplo: O valor R$ 10,00 é representado como 1000
    - `quantity` string — Quantidade de itens. Caso não seja informado, será considerado o valor 1
    - `unit_of_measure` 'EACH' | 'HOURS' | 'DAYS' | 'SECONDS' | 'CRATE_OF_12' | 'SIX_PACK' | 'GALOON' | 'LITRE' — Unidade de medida.
  - `transactions` object — Lista de transações de pagamento (ou outros tipos) efetuadas no pedido
    - `id` string — UUID que identifica unicamente a transação
    - `external_id` string — Identificador único ordem
    - `status` 'CONFIRMED' | 'PENDING' | 'CANCELLED' — Status da transação.
    - `terminal_number` string — Número do terminal da Cielo Smart em que o pagamento foi realizado
    - `authorization_code` string — Código de autorização da transação
    - `number` string — Número Sequencial Único (NSU) da transação
    - `amount` string — Valor da transação em centavos. Exemplo: O valor de R$ 10,00 é representado como 1000
    - `transaction_type` 'PAYMENT' | 'CANCELLATION' — Tipo da transação.
  - `price` string — Valor total do pedido em centavos. Exemplo: O valor R$ 10,00 é representado como 1000
  - `remaining` string — Valor restante do pagamento do pedido em centavos. Exemplo: O valor R$ 10,00 é representado como 1000
  - `payment_code` string — Forma de pagamento estabelecida na criação do pedido. Caso não seja informado, será necessário escolher a forma no POS. Funcionalidade indisponível para LIO.

## Other responses

- `401` — Não autorizado
- `403` — Proibido
- `404` — Pedido não encontrado

---

[API](https://skmtc.net/cielo/apis/cielo-smart-order-manager.md) · [All operations](https://skmtc.net/cielo/apis/cielo-smart-order-manager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cielo/cielo-smart-order-manager/versions/8251a6af3b00/schema)