Skip to main content
GET
/
pedidos
Listar pedidos
curl --request GET \
  --url https://api.tiny.com.br/public-api/v3/pedidos \
  --header 'Authorization: Bearer <token>'
{
  "itens": [
    {
      "id": 123,
      "situacao": 123,
      "numeroPedido": 123,
      "ecommerce": {
        "id": 123,
        "nome": "<string>",
        "numeroPedidoEcommerce": "<string>",
        "numeroPedidoCanalVenda": "<string>",
        "canalVenda": "<string>"
      },
      "dataCriacao": "<string>",
      "dataPrevista": "<string>",
      "cliente": {
        "nome": "<string>",
        "codigo": "<string>",
        "fantasia": "<string>",
        "tipoPessoa": "J",
        "cpfCnpj": "<string>",
        "inscricaoEstadual": "<string>",
        "rg": "<string>",
        "telefone": "<string>",
        "celular": "<string>",
        "email": "<string>",
        "endereco": {
          "endereco": "<string>",
          "numero": "<string>",
          "complemento": "<string>",
          "bairro": "<string>",
          "municipio": "<string>",
          "cep": "<string>",
          "uf": "<string>",
          "pais": "<string>"
        },
        "id": 123
      },
      "valor": "<string>",
      "vendedor": {
        "id": 123,
        "nome": "<string>"
      },
      "transportador": {
        "id": 123,
        "nome": "<string>",
        "fretePorConta": "R",
        "formaEnvio": {
          "id": 123,
          "nome": "<string>"
        },
        "formaFrete": {
          "id": 123,
          "nome": "<string>"
        },
        "codigoRastreamento": "<string>",
        "urlRastreamento": "<string>"
      },
      "origemPedido": 0
    }
  ],
  "paginacao": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Query Parameters

numero
integer

Pesquisa por número do pedido

nomeCliente
string

Pesquisa por nome do cliente

codigoCliente
string

Pesquisa por código do cliente

cpfCnpj
string

Pesquisa por CPF/CNPJ do cliente

dataInicial
string

Pesquisa através da data de criação do pedido

dataFinal
string

Pesquisa através da data de criação do pedido

dataAtualizacao
string

Pesquisa através da data de atualização do pedido

situacao
enum<number>

Pesquisa com base na situação informada

  • 8 - Dados Incompletos
  • 0 - Aberta
  • 3 - Aprovada
  • 4 - Preparando Envio
  • 1 - Faturada
  • 7 - Pronto Envio
  • 5 - Enviada
  • 6 - Entregue
  • 2 - Cancelada
  • 9 - Nao Entregue
Available options:
8,
0,
3,
4,
1,
7,
5,
6,
2,
9
numeroPedidoEcommerce
string

Pesquisa por número do pedido no e-commerce

idVendedor
integer

Pesquisa por id do vendedor

marcadores
string[]

Pesquisa por marcadores

origemPedido
enum<integer>

Pesquise através da origem do pedido (0 = Pedido de Venda, 1 = PDV)

Available options:
0,
1
orderBy
enum<string>

Define a ordenação da listagem por ordem crescente ou decrescente

  • asc - Crescente
  • desc - Descrescente
Available options:
asc,
desc
limit
integer
default:100

Limite da paginação

offset
integer
default:0

Offset da paginação

Response

OK

itens
· object[]
paginacao
· object