API Shopping de Preços

Dados de um Pedido

GET
https://apiv2.shoppingdeprecos.com.br/pedidos/{pedidoID}/integracao/{IntegracaoID}/dados
Última modificação:há 9 meses
💡

Para consultar a listagem dos seus pedidos atualizados em um período, consulte o método Lista de Pedidos clicando aqui.

Este método realiza a busca dos dados de um pedido específico.

Status que podem retornar no pedido:

Aguardando Pagamento
Aprovado
Faturado
Enviado
Entregue
Cancelado
Devolvido

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 Caminho
Nome
Tipo
Obrigatório
Descrição
pedidoID
string 
Exemplo:
123
IntegracaoID
string 
Código da integração no Shopping de Preços. Saiba mais clicando aqui
Exemplo:
1111
Parâmetros Header
Nome
Tipo
Obrigatório
Descrição
X-Client
string 
Token fornecido pelo Shopping de Preços - Saiba mais clicando aqui
Exemplo:
xxxxxxxxxxxxx
Accept
string 
Exemplo:
application/json
Accept-Encoding
string 
Exemplo:
application/gzip
Authorization
string 
Predefinição:
Basic *****************

Códigos de solicitação

Respostas

application/json
Bodyapplication/json
status
boolean 
Obrigatório
Para caso de sucesso, retornará true, e para caso de erros, retornará false.
quantidade
integer 
Obrigatório
Quantidade de registros retornados.
registros
array [object] 
Obrigatório
Array/Lista com os registros retornados.
integracao_id
integer 
Obrigatório
Código da integração no Shopping de Preços.
observacoes
string  | null 
Opcional
Observações do pedido no Shopping de Preços.
pedido_id
string 
Obrigatório
ID do pedido no Shopping de Preços.
tipo_me
string  | null 
Opcional
Para casos de pedidos Mercado Livre, retornará se o mesmo é ME1 ou ME2.
carrinho_ml
null 
Opcional
Para casos de pedidos Mercado Livre, retornará o carrinho atrelado ao pedido.
data_pedido
string 
Obrigatório
Data em que o pedido foi gerado na plataforma.
ultima_atualizacao
string 
Obrigatório
Data da última atualização do pedido na plataforma.
status
string 
Obrigatório
Status do pedido no Shopping de Preços. (Possíveis valores: Aguardando Pagamento, Aprovado, Faturado, Enviado, Entregue, Cancelado e Devolvido.
situacao_personalizada_id
integer  | null 
Opcional
ID da situação personalizada deste pedido no Shoppping de Preços.
situacao_personalizada_nome
string  | null 
Opcional
Nome da situação personalizada deste pedido no Shoppping de Preços.
vendedor_id
integer 
Obrigatório
Seu ID (Identificador de cliente) no Shopping de Preços.
token
string 
Opcional
pais_origem_pedido
string 
Obrigatório
Pais em que o pedido foi gerado.
moeda
string  | null 
Opcional
Moeda em que o pedido foi gerado (Ex: R$, US).
moeda_cotacao_reais
null 
Opcional
entrega_cotacao
null 
Opcional
faturamento_horario
string  | null 
Opcional
Horário em que o pedido foi faturado.
nf_plataforma
string  | null 
Obrigatório
NFe do pedido na integração/plataforma.
total_sem_frete
number 
Opcional
Total do pedido sem frete no Shopping de Preços.
total_frete
integer 
Opcional
Total do frete do pedido no Shopping de Preços.
total_desconto
integer 
Opcional
Total de desconto do pedido no Shopping de Preços.
total_cupom
integer 
Opcional
Total de desconto via cupom do pedido no Shopping de Preços.
total_acrescimo
integer 
Opcional
Total de acréscimo do pedido no Shopping de Preços.
total_pedido
number 
Opcional
Total do pedido no Shopping de Preços.
produtos
array [object] 
Obrigatório
Array/Lista com os registros retornados.
pagamentos
array [object] 
Obrigatório
Array/Lista contendo os pagamentos deste pedido.
pedidos_carrinho
null 
Opcional
Para casos de pedidos Mercado Livre, retornará os pedidos que estão presentes no mesmo carrinho.
plataforma_pai_id
null 
Opcional
Para casos de plataforma que são filhas de outra plataforma, retornará o ID da plataforma pai.
tipo_operacao
string 
Obrigatório
Tipo de operação do pedido.
plataforma
object 
Obrigatório
Dados da plataforma do pedido.
comprador
object 
Obrigatório
Dados do comprador.
entrega
object 
Opcional
Dados da entrega.
faturamento
array [object] 
Opcional
Array/Lista de faturamento do pedido.
dropshipping
array[string]
Opcional
Array/Lista do dropshipping associado ao pedido.
Exemplo
{
    "status": true,
    "quantidade": 1,
    "registros": [
        {
            "integracao_id": 12345,
            "observacoes": "Pedido fictício para documentação.",
            "pedido_id": "2000000000000001",
            "tipo_me": "me1",
            "carrinho_ml": null,
            "data_pedido": "2026-08-10 09:30:00",
            "ultima_atualizacao": "2026-08-10 09:35:00",
            "status": "Aprovado",
            "situacao_personalizada_id": 1,
            "situacao_personalizada_nome": "Pedido Ativo",
            "vendedor_id": 12345678,
            "token": "token_ficticio_apenas_para_exemplo",
            "pais_origem_pedido": "BR",
            "moeda": "R$",
            "moeda_cotacao_reais": null,
            "entrega_cotacao": null,
            "entrega_status": "pending-shipment_paid",
            "etiqueta_disponivel": false,
            "faturamento_horario": null,
            "nf_plataforma": "",
            "total_sem_frete": 299.8,
            "total_frete": 25.2,
            "total_desconto": 0,
            "total_cupom": 0,
            "cupom_nome": null,
            "total_acrescimo": 0,
            "total_pedido": 325,
            "produtos": [
                {
                    "sequencia": 1,
                    "sku": "PROD-001",
                    "sku_erp": "ERP-001",
                    "numero_serial": null,
                    "mlb": "MLB0000000001",
                    "foto": "https://example.com/imagens/produto-exemplo.jpg",
                    "ean": "0000000000000",
                    "variacao_id": null,
                    "descricao": "Luminária de Mesa LED Modelo Exemplo",
                    "descricao_variacao": "",
                    "observacao": "Produto fictício para demonstração.",
                    "qtde": 2,
                    "valor_unitario": 149.9,
                    "desconto": 0,
                    "valor_total": 299.8,
                    "tarifa_venda": 35.98,
                    "percentual_comissao": 12,
                    "tipo_anuncio": "Clássico",
                    "embalagem_presente": false,
                    "kit": false,
                    "itens_kit": [],
                    "dropshipping": [],
                    "rebate": 0,
                    "deposito_id": "10000001",
                    "dimensoes": {
                        "altura": 0.35,
                        "largura": 0.15,
                        "comprimento": 0.2,
                        "peso": 0.8
                    }
                }
            ],
            "pagamentos": [
                {
                    "sequencia": 1,
                    "data": "2026-08-10T09:30:00",
                    "valor": 325,
                    "status": "Aprovado",
                    "bandeira": "Pix",
                    "operadora": "Operadora Exemplo",
                    "identificacao": "100000000001",
                    "codigo_transacao": "PIX_TRANSACAO_FICTICIA_000001",
                    "cnpj_autorizador": "00.000.000/0000-00",
                    "forma": "Transferência Bancária",
                    "parcelas": 1
                }
            ],
            "pedidos_carrinho": null,
            "plataforma_pai_id": null,
            "tipo_operacao": "Venda",
            "cnpj_transportadora": "",
            "transportadora_id_pedido_relacao": null,
            "plataforma": {
                "id": 1,
                "nome": "Marketplace Exemplo",
                "intermediador_cnpj": "00000000000000",
                "intermediador_identificacao_loja": "12345678",
                "loja": "Loja Demonstração"
            },
            "comprador": {
                "apelido": "CLIENTEEXEMPLO",
                "nome": "Marina Exemplo da Silva",
                "documento": "00000000000",
                "rg_ie": "",
                "endereco": "Rua das Ideias",
                "numero": "123",
                "bairro": "Jardim Exemplo",
                "complemento": "Apartamento 101",
                "cidade": "Cidade Exemplo",
                "uf": "SP",
                "pais": "BRASIL",
                "cep": "00000000",
                "email": null,
                "fone": null,
                "celular": null
            },
            "entrega": {
                "id": "10000000001",
                "nome": "Marina Exemplo da Silva",
                "endereco": "Rua das Ideias",
                "numero": "123",
                "bairro": "Jardim Exemplo",
                "complemento": "Apartamento 101. Referência: Praça Exemplo.",
                "cidade": "Cidade Exemplo",
                "uf": "SP",
                "cep": "00000000",
                "email": "",
                "fone": "00000000000",
                "forma_envio": "Normal",
                "transportadora": "Transportadora Exemplo",
                "codigo_rastreio": null,
                "programa_envio": "default",
                "fulfillment": false,
                "limite_entrega": "2026-08-20",
                "previsao_liberacao_etiqueta": null,
                "limite_expedicao": "2026-08-12",
                "comissao_frete": 0,
                "rebate_frete": 0,
                "cotacao": null,
                "etiqueta_gerada_transportadora": false,
                "id_gerado_transportadora": "",
                "relacionamento": {
                    "nome_transportadora_relacionada": "",
                    "transportadora_pedido": null,
                    "forma_envio_pedido": null,
                    "forma_envio_transportadora": null,
                    "transportadora_id": null,
                    "cnpj_transportadora": ""
                },
                "dados_enviados_erp": null
            },
            "faturamento": [],
            "dropshipping": []
        }
    ]
}