DOCS

Buscar e filtrar pedidos

Checkout•
InícioEcommerce global Integração Integrar Checkout Buscar e filtrar pedidos

Buscando e filtrando pedidos

Recupere listas de pedidos com GraphQL.

Usando a consulta orders no GraphQL, você pode recuperar listas paginadas de pedidos com vários critérios. Isso é útil quando você precisa de uma lista de pedidos por país, entre datas específicas, para construir uma busca, etc.

1

Obtenha sua chave de API

Crie uma conta no Zonos: Para usar a API do Zonos, você precisará de uma chave de API. Para obter sua chave, você precisará preencher nosso formulário de inscrição. O processo de integração começará assim que você tiver um acordo de conta em vigor. Durante a integração, um representante ajudará você a configurar sua conta corretamente para que você receba as respostas de API mais precisas.

Acesse sua chave de API aqui se você tiver uma conta no Zonos. Isso permitirá que você se autentique com a API do Zonos. Se você não tiver uma conta, veja a nota acima.

2

Decida quais detalhes recuperar

Você pode consultar listas de pedidos com base em accountOrderIds semelhantes ou fornecendo um intervalo de datas entre as quais os pedidos foram publicados. Para uma lista completa de campos disponíveis, consulte a referência da API GraphQL.

Em cada pedido individual que você consultar, todos os campos normais de Order estão disponíveis, por exemplo, o país, informações de envio, totais de landed cost etc.. Todos os campos possíveis estão listados na referência da API GraphQL.

Consulta

1
2
3
4
5
6
7
8
9
10
query orders($ordersFilter: OrdersFilter, $first: Int) {
  orders(filter: $ordersFilter, first: $first) {
    edges {
      node {
        id
        # ... field names here
      }
    }
  }
}

Variáveis

1
2
3
4
5
6
7
8
{
  "ordersFilter": {
    "between": {
      "before": "2022-10-01",
      "after": "2022-09-01"
    }
  }
}
3

Enviar as páginas para buscar

Todas as consultas que recuperam listas suportam paginação no estilo Relay. A variável first permite que você especifique quantos objetos são retornados.

Consulta

1
2
3
4
5
query orders($filter: OrderFilter!, $first: Int) {
 orders(orderFilter: $filter, first: $first) {
  # ... field names here
 }
}

Variáveis

1
2
3
{
  "first": 20
}
4

Envie sua solicitação

Agora que você construiu sua solicitação e a configurou, você pode enviar uma solicitação POST para a API da Zonos. Certifique-se de autenticar com sua chave de API e fornecer o cabeçalho de versão correto em sua solicitação.

POST https://api.zonos.com/graphql/

Query

1
2
3
4
5
6
7
8
9
10
11
12
13
14
query orders($ordersFilter: OrdersFilter, $first: Int) {
  orders(filter: $ordersFilter, first: $first) {
    edges {
      node {
        id
        items {
          description
          hsCode
          quantity
        }
      }
    }
  }
}

Variáveis

1
2
3
4
5
6
7
8
9
{
  "ordersFilter": {
    "between": {
      "before": "2022-10-01",
      "after": "2022-09-01"
    }
  },
  "first": 20
}

Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "data": [
    {
      "order": {
        "id": "1000753",
        "items": [
          {
            "description": "Blue Snorkle Set",
            "hsCode": "9506290000",
            "quantity": 2
          }
        ]
      }
    }
  ]
}

Esta página foi útil?

Agendar uma demonstração

Dúvidas?

Obter suporte
© 2025 Zonoszonos.com
Nesta página:
  • Buscando e filtrando pedidos
  • Obtenha sua chave de API
  • Decida quais detalhes recuperar
  • Enviar as páginas para buscar
  • Envie sua solicitação