API Shopping de Preços

Listagem de Pedidos

GET
https://apiv2.shoppingdeprecos.com.br/pedidos/lista
Última modificação:há aproximadamente 1 mês

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.
Para buscar através do campo status, você tem as seguintes opções disponíveis:
Aguardando Pagamento
Aprovado
Faturado
Enviado
Entregue
Cancelado

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 de Consulta
Nome
Tipo
Obrigatório
Descrição
dataIni
string 
Data inicial de atualização do pedido.
Exemplo:
2025-01-01 00:00:00
dataFim
string 
Data final de atualização do pedido.
Exemplo:
2025-04-02 20:00:00
integracao
integer 
Código da integração no Shopping de Preços. Saiba mais clicando aqui
Exemplo:
444335
status
string 
Status do pedido.
Exemplo:
Aprovado
Parâmetros Header
Nome
Tipo
Obrigatório
Descrição
X-Client
string 
Token fornecido pelo Shopping de Preços - Saiba mais clicando aqui
Exemplo:
xxxxxxx
Accept
string 
Exemplo:
application/json
Content-Type
string 
Exemplo:
application/json
Accept-Encoding
string 
Exemplo:
br
Authorization
string 
Predefinição:
Basic *****************

Códigos de solicitação

Respostas

application/json
Bodyapplication/json
status
boolean 
Obrigatório
Status da Solicitação
quantidade
integer 
Obrigatório
Quantidade de Pedidos
registros
array [object] 
Obrigatório
Array de Pedidos
plataforma_id
integer 
Obrigatório
Código/ID da plataforma no Shopping de Preços.
plataforma_nome
string 
Obrigatório
Nome/Identificação da plataforma no Shopping de Preços.
integracao_id
integer 
Obrigatório
ID da Integração no Shopping de Preços.
pedido_id
string 
Obrigatório
ID do pedido no Shopping de Preços.
ultima_atualizacao
string 
Obrigatório
Data da última atualização.
status
string 
Obrigatório
Status do pedido no Shopping de Preços.
programa_envio
string 
Obrigatório
Programa de envio do pedido retornado da plataforma.
situacao_personalizada_id
integer 
Obrigatório
ID da situação personalizada no Shopping de Preços.
situacao_personalizada_nome
string 
Obrigatório
Nome da situação personalizada no Shopping de Preços.
tem_nf
boolean 
Obrigatório
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