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 - 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
    • Aceite Pedido Compra Amazon - Vendor
      POST
    • Recuperação dos XMLs das Notas Fiscais dos Pedidos
      POST
  • 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
    • Modelo de envio - Estoque por Depósito
  1. Pedidos

Dados de um Pedido

GET
https://apiv2.shoppingdeprecos.com.br/pedidos/{pedidoID}/integracao/{IntegracaoID}/dados
Última modificação:2025-06-30 12:26:55
💡

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 Path
pedidoID
string 
requerido
IntegracaoID
string 
requerido
Código da integração no Shopping de Preços. Saiba mais clicando aqui
Exemplo:
1111
Parâmetros Header
X-Client
string 
requerido
Token fornecido pelo Shopping de Preços - Saiba mais clicando aqui
Exemplo:
xxxxxxxxxxxxx
Accept
string 
requerido
Exemplo:
application/json
Accept-Encoding
string 
requerido
Exemplo:
application/gzip
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//integracao/1111/dados' \
--header 'X-Client: xxxxxxxxxxxxx' \
--header 'Accept: application/json' \
--header 'Accept-Encoding: application/gzip' \
--header 'Authorization: Basic Og=='

Respostas

🟢200OK
application/json
Body
status
boolean 
requerido
Para caso de sucesso, retornará true, e para caso de erros, retornará false.
quantidade
integer 
requerido
Quantidade de registros retornados.
registros
array [object {34}] 
requerido
Array/Lista com os registros retornados.
integracao_id
integer 
requerido
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 
requerido
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 
requerido
Data em que o pedido foi gerado na plataforma.
ultima_atualizacao
string 
requerido
Data da última atualização do pedido na plataforma.
status
string 
requerido
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 
requerido
Seu ID (Identificador de cliente) no Shopping de Preços.
token
string 
opcional
pais_origem_pedido
string 
requerido
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 
requerido
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 {23}] 
requerido
Array/Lista com os registros retornados.
pagamentos
array [object {10}] 
requerido
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 
requerido
Tipo de operação do pedido.
plataforma
object 
requerido
Dados da plataforma do pedido.
comprador
object 
requerido
Dados do comprador.
entrega
object 
opcional
Dados da entrega.
faturamento
array [object {6}] 
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
Built with