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": 600000,
            "observacoes": "",
            "pedido_id": "20000600000",
            "tipo_me": "me2",
            "carrinho_ml": null,
            "data_pedido": "2025-00-00 18:00:00",
            "ultima_atualizacao": "2025-00-00 18:00:00",
            "status": "Entregue",
            "situacao_personalizada_id": 1,
            "situacao_personalizada_nome": "Pedido Ativo",
            "vendedor_id": 4200000,
            "token": "0aa0a0a0a0a0a0a0a0a0a0",
            "pais_origem_pedido": "BR",
            "moeda": "R$",
            "moeda_cotacao_reais": null,
            "entrega_cotacao": null,
            "faturamento_horario": "2025-00-00 18:00:00",
            "nf_plataforma": "",
            "total_sem_frete": 380.88,
            "total_frete": 0,
            "total_desconto": 0,
            "total_cupom": 0,
            "total_acrescimo": 0,
            "total_pedido": 380.88,
            "produtos": [
                {
                    "sequencia": 1,
                    "sku": "109005",
                    "sku_erp": "109005",
                    "numero_serial": null,
                    "mlb": "MLB0000000000",
                    "foto": "https://www.google.com.br",
                    "ean": "",
                    "variacao_id": 182049415825,
                    "descricao": "Kit 10 Barras Rodape De Poliestireno Frisado 10 Cm Altura",
                    "descricao_variacao": "Cor: Branco Liso",
                    "observacao": "",
                    "qtde": 1,
                    "valor_unitario": 380.88,
                    "desconto": 0,
                    "valor_total": 380.88,
                    "tarifa_venda": 62.85,
                    "percentual_comissao": 16.5,
                    "tipo_anuncio": "Premium",
                    "embalagem_presente": false,
                    "kit": false,
                    "itens_kit": [],
                    "dropshipping": [],
                    "dimensoes": {
                        "altura": null,
                        "largura": null,
                        "comprimento": null,
                        "peso": null
                    }
                }
            ],
            "pagamentos": [
                {
                    "sequencia": 1,
                    "data": "2025-00-00 18:00:00",
                    "valor": 380.88,
                    "status": "Aprovado",
                    "bandeira": "Visa",
                    "operadora": "Mercado Pago",
                    "identificacao": "1010011010010",
                    "codigo_transacao": null,
                    "forma": "Cartão Crédito",
                    "parcelas": 11
                }
            ],
            "pedidos_carrinho": null,
            "plataforma_pai_id": null,
            "tipo_operacao": "Venda",
            "plataforma": {
                "id": 1,
                "nome": "Mercado Livre",
                "intermediador_cnpj": "10101010101010",
                "intermediador_identificacao_loja": "10101010101010",
                "loja": "Mercado Livre"
            },
            "comprador": {
                "apelido": "TESTE",
                "nome": "TESTE DO SHOPPING",
                "documento": "55555555555",
                "rg_ie": "",
                "endereco": "Rua Andrade Neves",
                "numero": "10",
                "bairro": "CENTRO",
                "complemento": "",
                "cidade": "São Paulo",
                "uf": "SP",
                "pais": "BRASIL",
                "cep": "02022555",
                "email": null,
                "fone": null,
                "celular": null
            },
            "entrega": {
                "id": "44613105897",
                "nome": "TESTE ENTREGA",
                "endereco": "Rua Andrade Neves",
                "numero": "10",
                "bairro": "CENTRO",
                "complemento": "",
                "cidade": "São Paulo",
                "uf": "SP",
                "cep": "0000000",
                "email": "",
                "fone": null,
                "forma_envio": "Normal",
                "transportadora": "Mercado Envios",
                "codigo_rastreio": "MEL00000000",
                "programa_envio": "cross_docking",
                "limite_entrega": "2025-03-22",
                "previsao_liberacao_etiqueta": null,
                "limite_expedicao": "2025-00-00 18:00:00",
                "comissao_frete": 44.45,
                "cotacao": null,
                "dados_enviados_erp": {
                    "ie": "",
                    "nf": "302920",
                    "data": "16/03/2025",
                    "erro": null,
                    "chave": "400000000000000000000000000",
                    "serie": "1",
                    "status": "FATURADO",
                    "volume": "1",
                    "especie": null,
                    "horario": "2025/00/00 18:00:00",
                    "etiqueta": null,
                    "rastreio": "",
                    "cancelado": false,
                    "atualizado": 1,
                    "forma_envio": "TRANSPORTADORA",
                    "rastreioURL": "",
                    "produto_cfop": "",
                    "horario_update": "2025/00/00 18:00:00",
                    "transportadora": "MERCADO ENVIOS",
                    "previsao_entrega": "2025/03/24",
                    "envia_status_proprio": false
                }
            },
            "faturamento": [
                {
                    "nf": "302920",
                    "chave": "4000000000000000000000000000000000000",
                    "serie": 1,
                    "emissao": "2025/00/00 18:00:00",
                    "url_xml": "https://apiv2.shoppingdeprecos.com.br/pedidos/xml/0101010110101010101010101010",
                    "url_pdf": "https://apiv2.shoppingdeprecos.com.br/pedidos/pdf/0101010110101010101010101010"
                }
            ],
            "dropshipping": []
        }
    ]
}
Página anterior
Listagem de Pedidos
Próxima página
Listar Situações Personalizadas