---
title: "Listar ordens de compra"
method: GET
path: "/ordem-compra"
tags: ["Ordem de Compra"]
---

# Listar ordens de compra

`GET /ordem-compra`

## Query parameters

- `numero` integer
- `dataInicial` string
- `dataFinal` string
- `marcadores` string[]
- `nomeFornecedor` string
- `codigoFornecedor` string
- `situacao` unknown
- `orderBy` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` ListarOrdemCompraModelResponse[]
    - `id` integer
    - `numero` string, nullable
    - `data` string
    - `situacao` string, nullable — - 0 - Em Aberto - 1 - Atendido - 2 - Cancelado - 3 - Em Andamento
    - `desconto` string
    - `frete` number, float
    - `totalProdutos` number, float
    - `totalPedidoCompra` number, float
    - `dataPrevista` string
    - `contato` ContatoModelResponse — 
      - `nome` string, nullable
      - `codigo` string, nullable
      - `fantasia` string, nullable
      - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable — - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
      - `cpfCnpj` string, nullable
      - `inscricaoEstadual` string, nullable
      - `rg` string, nullable
      - `telefone` string, nullable
      - `celular` string, nullable
      - `email` string, nullable
      - `endereco` EnderecoModel — 
        - `endereco` string, nullable
        - `numero` string, nullable
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `municipio` string, nullable
        - `cep` string, nullable
        - `uf` string, nullable
        - `pais` string, nullable
      - `id` integer
    - `categoria` CategoriaResponseModel — 
      - `id` integer, nullable
      - `nome` string, nullable
      - `caminhoCompleto` string, nullable
    - `notaFiscal` OrdemCompraNotaFiscalModelResponse — 
      - `id` integer
      - `numero` string
      - `dataEmissao` string
      - `valor` string
      - `natureza` string
    - `fretePorConta` 'R' | 'D' | 'T' | '3' | '4' | 'S', nullable — - R - Remetente - D - Destinatario - T - Terceiros - 3 - Proprio Remetente - 4 - Proprio Destinatario - S - Sem Transporte
    - `observacoes` string
    - `observacoesInternas` string, nullable
  - `paginacao` PaginatedResultModel — 
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/olist/apis/olist-erp-api-v3.md) · [All operations](https://skmtc.net/olist/apis/olist-erp-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olist/olist-erp-api-v3/versions/c351400bb11f/schema)