---
title: "Criar um pedido"
method: POST
path: "/orders"
---

# Criar um pedido

`POST /orders`

Cria um pedido no servidor do Order Manager.

## Headers

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

## Request body

- object
  - `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', required — Status do pedido.
  - `items` object[], required — Lista de itens contidos no pedido.
    - `sku` string, required — SKU do produto
    - `name` string — Nome do produto
    - `description` string — Descrição do produto
    - `unit_price` string, required — 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', required — Unidade de medida.
  - `transactions` object[], required — Lista de transações de pagamento (ou outros tipos) efetuadas no pedido.
    - `id` string, required — UUID que identifica unicamente a transação
    - `external_id` string, required — Identificador único da ordem
    - `status` 'CONFIRMED' | 'PENDING' | 'CANCELLED', required — Status da transação.
    - `terminal_number` string, required — Número do terminal da Cielo Smart em que o pagamento foi realizado
    - `authorization_code` string, required — Código de autorização da transação
    - `number` string, required — Número Sequencial Único (NSU) da transação
    - `amount` string, required — Valor da transação em centavos. Exemplo: O valor de R$ 10,00 é representado como 1000
    - `transaction_type` 'PAYMENT' | 'CANCELLATION', required — Tipo da transação.
  - `price` string, required — 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.
  - `installments` string — Número de parcelas. Use 0 para pagamento à vista.

## Response `201`

Pedido criado com sucesso

- object
  - `id` string, required

## Other responses

- `401` — Não autorizado
- `403` — Proibido
- `422` — Requisição inválida

---

[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)