added
Dimensões do produto disponíveis no GET de Pedidos
14 days ago by Angela Santos
Agora, os campos peso, altura, largura e comprimento de um produto contido no pedido, passam a ser retornados nas respostas dos endpoints:
GET /Pedidos
GET /Pedidos/{id}
GET /Pedidos/situacaoPedido/{situacoesPedido}
GET /Pedidos/formaPagamento/{formasPagamento}
Para mais detalhes sobre este campo, acesse os artigos Consultando uma listagem de pedidos, Consultando um pedido específico, Consultando uma listagem de pedido por situação, Consultando uma listagem de pedidos por forma de pagamento em nossa base de conhecimento.
Como era antes?
Anteriormente, ao utilizar estes endpoints, não era possível consultar as dimensões dos itens, o que limitava o acesso a essa informação diretamente no pedido.
O que mudou?
Agora, a resposta dessas requisições inclui o retorno das dimensões do produto, cadastrados na plataforma.
Com isso, é possível:
- Consultar diretamente as dimensões do produto (peso, altura, largura e comprimento) a partir das requisições de pedidos, sem necessidade de realizar chamadas adicionais.
- Facilitar integrações com sistemas de transporte (TMS), que dependem dessas informações para geração de etiquetas e planejamento de envio.
Exemplo de response com dimensões do produto
{
"pedidoId": 0,
"situacaoPedidoId": 0,
"tipoRastreamentoPedido": "SemRastreamento",
"transacaoId": 0,
"data": "2024-10-01T18:53:24.877Z",
"dataPagamento": "2024-10-01T18:53:24.877Z",
"dataUltimaAtualizacao": "2024-10-01T18:53:24.877Z",
"valorFrete": 0,
"valorTotalPedido": 0,
"valorDesconto": 0,
"valorDebitoCC": 0,
"cupomDesconto": "string",
"marketPlacePedidoId": "string",
"marketPlacePedidoSiteId": "string",
"canalId": 0,
"canalNome": "string",
"canalOrigem": "string",
"retiradaLojaId": 0,
"isPedidoEvento": true,
"usuario": {
"usuarioId": 0,
"grupoInformacaoCadastral": [
{
"chave": "string",
"valor": "string"
}
],
"tipoPessoa": "Fisica",
"origemContato": "Google",
"tipoSexo": "Undefined",
"nome": "string",
"cpf": "string",
"email": "string",
"rg": "string",
"telefoneResidencial": "string",
"telefoneCelular": "string",
"telefoneComercial": "string",
"dataNascimento": "2024-10-01T18:53:24.877Z",
"razaoSocial": "string",
"cnpj": "string",
"inscricaoEstadual": "string",
"responsavel": "string",
"dataCriacao": "2024-10-01T18:53:24.877Z",
"dataAtualizacao": "2024-10-01T18:53:24.877Z",
"revendedor": true,
"listaInformacaoCadastral": [
{
"chave": "string",
"valor": "string"
}
]
},
"pedidoEndereco": [
{
"tipo": "Entrega",
"nome": "string",
"endereco": "string",
"numero": "string",
"complemento": "string",
"referencia": "string",
"cep": "string",
"tipoLogradouro": "string",
"logradouro": "string",
"bairro": "string",
"cidade": "string",
"estado": "string",
"pais": "string"
}
],
"frete": {
"freteContratoId": 0,
"freteContrato": "string",
"referenciaConector": "string",
"valorFreteEmpresa": 0,
"valorFreteCliente": 0,
"peso": 0,
"pesoCobrado": 0,
"volume": 0,
"volumeCobrado": 0,
"prazoEnvio": 0,
"prazoHorasEnvio": 0,
"prazoEnvioTexto": "string",
"retiradaLojaId": 0,
"centrosDistribuicao": [
{
"freteContratoId": 0,
"freteContrato": "string",
"valorFreteEmpresa": 0,
"valorFreteCliente": 0,
"peso": 0,
"pesoCobrado": 0,
"volume": 0,
"volumeCobrado": 0,
"prazoEnvio": 0,
"prazoHorasEnvio": 0,
"prazoEnvioTexto": "string",
"centroDistribuicaoId": 0,
"cotacoesFilhas": [
{
"centroDistribuicaoId": 0,
"freteContrato": "string",
"valor": 0,
"volume": 0,
"tabelaFreteId": 0
}
]
}
],
"servico": {
"servicoId": 0,
"nome": "string",
"transportadora": "string",
"prazo": 0,
"servicoNome": "string",
"preco": 0,
"servicoTransporte": 0,
"codigo": 0,
"servicoMeta": "string",
"custo": 0,
"token": "string"
},
"retiradaAgendada": {
"lojaId": 0,
"retiradaData": "2024-10-01T18:53:24.877Z",
"retiradaPeriodo": "string",
"nome": "string",
"documento": "string",
"codigoRetirada": "string"
},
"agendamento": {
"de": "2024-10-01T18:53:24.877Z",
"ate": "2024-10-01T18:53:24.877Z"
},
"informacoesAdicionais": [
{
"chave": "string",
"valor": "string"
}
]
},
"itens": [
{
"produtoVarianteId": 0,
"sku": "string",
"ean": "string",
"nome": "string",
"quantidade": 0,
"precoCusto": 0,
"precoVenda": 0,
"valorItem": 0,
"valorItemArredondado": 0,
"isBrinde": true,
"valorAliquota": 0,
"isMarketPlace": true,
"precoPor": 0,
"desconto": 0,
"totais": {
"precoCusto": 0,
"precoVenda": 0,
"precoPor": 0,
"desconto": 0
},
"ajustes": [
{
"tipo": "Frete",
"valor": 0,
"observacao": "string",
"nome": "string"
}
],
"centroDistribuicao": [
{
"centroDistribuicaoId": 0,
"quantidade": 0,
"situacaoProdutoId": 0,
"valorFreteEmpresa": 0,
"valorFreteCliente": 0
}
],
"valoresAdicionais": [
{
"tipo": "Acrescimo",
"origem": "string",
"texto": "string",
"valor": 0
}
],
"atributos": [
{
"produtoVarianteAtributoValor": "string",
"produtoVarianteAtributoNome": "string"
}
],
"embalagens": [
{
"tipoEmbalagemId": 0,
"nomeTipoEmbalagem": "string",
"mensagem": "string",
"valor": 0,
"descricao": "string"
}
],
"personalizacoes": [
{
"nomePersonalizacao": "string",
"valorPersonalizacao": "string",
"valor": 0
}
],
"frete": [
{
"quantidade": 0,
"freteContratoId": 0,
"freteContrato": "string",
"valorFreteEmpresa": 0,
"valorFreteCliente": 0,
"peso": 0,
"pesoCobrado": 0,
"volume": 0,
"volumeCobrado": 0,
"prazoEnvio": 0,
"prazoHorasEnvio": 0,
"prazoEnvioTexto": "string",
"centroDistribuicaoId": 0
}
],
"dadosProdutoEvento": {
"tipoPresenteRecebimento": "None",
"eventoId": 0,
"texto": "string"
},
"formulas": [
{
"chaveAjuste": "string",
"valor": 0,
"nome": "string",
"expressao": "string",
"expressaoInterpretada": "string",
"endPoint": "string"
}
],
"seller": {
"sellerId": 0,
"sellerNome": "string",
"sellerPedidoId": 0
},
"metadados": [
{
"chave": "string",
"valor": "string"
}
],
"situacaoPedidoProdutoId": 0,
"imagens": [
{
"nomeArquivo": "string",
"url": "string"
}
],
"categorias": [
{
"categoria": "string",
"hierarquia": "string",
"categoriaPrincipal": false
}
],
"peso": 0,
"altura": 0,
"largura": 0,
"comprimento": 0
}
],
"assinatura": [
{
"assinaturaId": 0,
"grupoAssinaturaId": 0,
"tipoPeriodo": "string",
"tempoPeriodo": 0,
"percentualDesconto": 0
}
],
"pagamento": [
{
"formaPagamentoId": 0,
"numeroParcelas": 0,
"valorParcela": 0,
"valorDesconto": 0,
"valorJuros": 0,
"valorTotal": 0,
"boleto": {
"urlBoleto": "string",
"codigoDeBarras": "string"
},
"pix": {
"qrCode": "string",
"qrCodeExpiracao": "2024-10-01T18:53:24.878Z",
"qrCodeUrl": "string",
"qrCodeUrlPagamento": "string"
},
"cartaoCredito": [
{
"numeroCartao": "string",
"nomeTitular": "string",
"dataValidade": "string",
"codigoSeguranca": "string",
"documentoCartaoCredito": "string",
"token": "string",
"info": "string",
"bandeira": "string"
}
],
"pagamentoStatus": [
{
"numeroAutorizacao": "string",
"numeroComprovanteVenda": "string",
"dataAtualizacao": "2024-10-01T18:53:24.878Z",
"dataUltimoStatus": "2024-10-01T18:53:24.878Z",
"adquirente": "string",
"tid": "string"
}
],
"informacoesAdicionais": [
{
"chave": "string",
"valor": "string"
}
]
}
],
"observacao": [
{
"observacao": "string",
"usuario": "string",
"data": "2024-10-01T18:53:24.878Z",
"publica": true
}
],
"valorCreditoFidelidade": 0,
"valido": true,
"valorSubTotalSemDescontos": 0,
"pedidoSplit": [
0
],
"usuarioMasterId": 0,
"metadados": [
{
"chave": "string",
"valor": "string"
}
],
"transacaoPaiId": 0,
"detalhesContaCorrente": [
{
"contaCorrenteId": 0,
"tipoContaCorrenteId": 0,
"descricaoTipoConta": "string",
"valor": 0,
"referencias": [
"string"
]
}
],
"pedidoPai": 0
}
Observação
As dimensões dos produtos são retornadas utilizando as seguintes unidades de medida: gramas (g) para peso e centímetros (cm) para altura, largura e comprimento.