API Shopping de Preços
  1. Pedidos
API Shopping de Preços
  • Introdução à API
  • Plataformas e Integrações
    • Lista Plataformas
    • Lista Integrações
  • Produtos
    • Envio de Produtos Simples - API V1
      POST
    • Envio de Produtos com Variações - API V1
      POST
    • Atualização de Estoque do Produto - API V1
      POST
    • Atualização de Preço do Produto - API V1
      POST
  • Anuncios nos Marketplaces
    • Listagem de Categorias - API V1
    • Listagem de Marcas por Plataforma - API V1
    • Listagem de Atributos por Plataforma - API V1
    • Envio de produtos para a Plataforma - API V1
    • Atualização de Estoque por Integração
    • Atualização de Preços por Integração
    • Consulta de estoques por integração
    • Consulta de preços por integração
  • Pedidos
    • Fluxo de Integração dos Pedidos
    • Criação de Pedidos Teste
    • Atualizar Status
      POST
    • Atualizar Situação Personalizada
      POST
    • Etiqueta nos Marketplaces - API V1
      POST
    • Listagem de Pedidos
      GET
    • Dados de um Pedido
      GET
    • Listar Situações Personalizadas
      GET
    • Etiquetas do Mercado Livre
      GET
  • Schemas
    • Modelo de envio de Produto Simples
    • Modelo de envio - Produto com Variações
    • Modelo de envio - Produto Kit
    • Modelo de envio - Atualização de estoque por produto
    • Modelo de envio - Atualização de preço por produto
    • Modelo de envio - Categoria no envio de produtos para as plataformas
    • Modelo de envio - Atributos no envio de produtos para as plataformas
    • Modelo de envio - Variações no envio de produtos para as plataformas
  1. Pedidos

Listagem de Pedidos

GET
https://apiv2.shoppingdeprecos.com.br/pedidos/lista
Última modificação:2025-06-03 23:29:41

Listagem dos pedidos atualizados em um período#

Esse método é responsável por buscar os pedidos que sofreram atualização entre as datas enviadas nos parâmetros de busca.#

💡
OBSERVAÇÃO IMPORTANTE:
Esse método considera exclusivamente a data de atualização do pedido, e não a data de venda ou entrega. Sempre que houver uma alteração relevante no pedido (como mudança de status, cancelamento ou envio), essa data será atualizada.
Portanto, ao realizar uma busca, lembre-se de que o período máximo permitido é 3 dias entre a data Inicial e a Data Final. Qualquer pesquisa fora desse intervalo será redefinida automaticamente.

Requisição

Authorization
Envie suas requisições HTTP com um cabeçalho
Authorization
que contenha a palavra Basic seguida por um espaço e uma string codificada em base64 username:password
Exemplo:
Authorization: Basic *****************
Parâmetros Query
dataIni
string 
requerido
Data inicial de atualização do pedido.
Exemplo:
2025-01-01 00:00:00
dataFim
string 
requerido
Data final de atualização do pedido.
Exemplo:
2025-04-02 20:00:00
integracaoID
integer 
requerido
Código da integração no Shopping de Preços. Saiba mais clicando aqui
Exemplo:
444335
Parâmetros Header
X-Client
string 
requerido
Token fornecido pelo Shopping de Preços - Saiba mais clicando aqui
Exemplo:
xxxxxxx
Accept
string 
requerido
Exemplo:
application/json
Content-Type
string 
requerido
Exemplo:
application/json
Accept-Encoding
string 
requerido
Exemplo:
br
Authorization
string 
requerido
Padrão:
Basic *****************

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://apiv2.shoppingdeprecos.com.br/pedidos/lista?dataIni=2025-01-01 00:00:00&dataFim=2025-04-02 20:00:00&integracaoID=444335' \
--header 'X-Client: xxxxxxx' \
--header 'Accept: application/json' \
--header 'Accept-Encoding: br' \
--header 'Authorization: Basic Og=='

Respostas

🟢200OK
application/json
Body
status
boolean 
requerido
Status da Solicitação
quantidade
integer 
requerido
Quantidade de Pedidos
registros
array [object {10}] 
requerido
Array de Pedidos
plataforma_id
integer 
requerido
Código/ID da plataforma no Shopping de Preços.
plataforma_nome
string 
requerido
Nome/Identificação da plataforma no Shopping de Preços.
integracao_id
integer 
requerido
ID da Integração no Shopping de Preços.
pedido_id
string 
requerido
ID do pedido no Shopping de Preços.
ultima_atualizacao
string 
requerido
Data da última atualização.
status
string 
requerido
Status do pedido no Shopping de Preços.
programa_envio
string 
requerido
Programa de envio do pedido retornado da plataforma.
situacao_personalizada_id
integer 
requerido
ID da situação personalizada no Shopping de Preços.
situacao_personalizada_nome
string 
requerido
Nome da situação personalizada no Shopping de Preços.
tem_nf
boolean 
requerido
Caso true o pedido possui NFe, e caso false, não possui.
Exemplo
{
    "status": true,
    "quantidade": 2,
    "registros": [
        {
            "plataforma_id": 1,
            "plataforma_nome": "Mercado Livre",
            "integracao_id": 65629,
            "pedido_id": "2000011073291866",
            "ultima_atualizacao": "2025-03-30 20:26:15",
            "status": "Entregue",
            "programa_envio": "fulfillment",
            "situacao_personalizada_id": 1,
            "situacao_personalizada_nome": "Pedido Ativo",
            "tem_nf": false
        },
        {
            "plataforma_id": 1,
            "plataforma_nome": "Mercado Livre",
            "integracao_id": 65629,
            "pedido_id": "2000010875519116",
            "ultima_atualizacao": "2025-03-30 20:59:25",
            "status": "Entregue",
            "programa_envio": "cross_docking",
            "situacao_personalizada_id": 1,
            "situacao_personalizada_nome": "Pedido Ativo",
            "tem_nf": true
        }
    ]
}
Página anterior
Etiqueta nos Marketplaces - API V1
Próxima página
Dados de um Pedido