ShippingQuotes
A query shippingQuotes retorna informações de cotações de frete de produtos diretamente ou associados a um carrinho.
Requisição
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| cep | CEP | Sim | CEP usado para a cotação de frete (apenas números) |
| checkoutId | Uuid | Não | ID do carrinho, usado em casos de cotação de frete de todos produtos de um carrinho |
| productVariantId | Long | Não | ID do produto variante, usado em caso de cotação de frete de um único produto |
| quantity | Int | Não | Quantidade do produto a ser cotado. |
Campos
| Campo | Descrição |
|---|---|
| deadline | Prazo de entrega dos produtos |
| name | Nome da opção de frete |
| products | Lista com o ID e valor dos produtos cotados |
| shippingQuoteId | ID de cadastro da opção de frete |
| type | Tipo de frete |
| value | Valor do frete |
| distributionCenterId | ID do Centro de Distribuição |
Exemplos
Exemplo 1
Neste exemplo são pedidas informações de cotações frete de um único produto:
query{
shippingQuotes(cep:"80420120", productVariantId:446){
name
type
value
deadline
distributionCenterId
}
}
Mostrar resposta
{
"data": {
"shippingQuotes": [
{
"name": "Teste Cadastro",
"type": "Retirada",
"value": 0,
"deadline": 1,
"distributionCenterId": 31
},
{
"name": "Entrega virtual",
"type": "Tabela",
"value": 10,
"deadline": 2,
"distributionCenterId": 31
},
{
"name": "Correios PAC 2",
"type": "Intelipost",
"value": 43.58,
"deadline": 5,
"distributionCenterId": 31
},
{
"name": "Correios Sedex 23123",
"type": "Intelipost",
"value": 51.12,
"deadline": 1,
"distributionCenterId": 31
},
{
"name": "SEDEX Varejo",
"type": "Correios",
"value": 159.62,
"deadline": 21,
"distributionCenterId": 31
}
]
}
}
Exemplo 2
Neste exemplo são pedidas informações de cotações frete para vários produtos:
query {
shippingQuotes(cep:"80420120", productVariantId:446, quantity:3) {
name
type
value
deadline
distributionCenterId
products {
productVariantId
value
}
}
}
Mostrar resposta
{
"data": {
"shippingQuotes": [
{
"name": "Teste Cadastro",
"type": "Retirada",
"value": 0,
"deadline": 1,
"distributionCenterId": 31,
"products": [
{
"productVariantId": 446,
"value": 0
},
{
"productVariantId": 446,
"value": 0
},
{
"productVariantId": 446,
"value": 0
}
]
},
{
"name": "Entrega virtual",
"type": "Tabela",
"value": 10,
"deadline": 2,
"distributionCenterId": 31,
"products": [
{
"productVariantId": 446,
"value": 3.33
},
{
"productVariantId": 446,
"value": 3.34
},
{
"productVariantId": 446,
"value": 3.33
}
]
},
{
"name": "Correios PAC 2",
"type": "Intelipost",
"value": 19.64,
"deadline": 5,
"distributionCenterId": 31,
"products": [
{
"productVariantId": 446,
"value": 6.55
},
{
"productVariantId": 446,
"value": 6.55
},
{
"productVariantId": 446,
"value": 6.54
}
]
},
{
"name": "Correios Sedex 23123",
"type": "Intelipost",
"value": 104.31,
"deadline": 1,
"distributionCenterId": 31,
"products": [
{
"productVariantId": 446,
"value": 34.77
},
{
"productVariantId": 446,
"value": 34.77
},
{
"productVariantId": 446,
"value": 34.77
}
]
},
{
"name": "SEDEX Varejo",
"type": "Correios",
"value": 266.62,
"deadline": 21,
"distributionCenterId": 31,
"products": [
{
"productVariantId": 446,
"value": 88.87
},
{
"productVariantId": 446,
"value": 88.88
},
{
"productVariantId": 446,
"value": 88.87
}
]
}
]
}
}
Cotação de frete com o endereço selecionado
Segue abaixo um exemplo:
query ($checkoutId: Uuid!) {
shippingQuotes(checkoutId: $checkoutId, useSelectedAddress: true) {
shippingQuoteId
deadline
id
name
type
value
}
}
Cotação com agendamento
Segue abaixo um exemplo:
query ($checkoutId: Uuid!) {
shippingQuotes(checkoutId: $checkoutId, useSelectedAddress: true) {
deadline
deliverySchedules {
date
periods {
end
id
start
}
}
name
shippingQuoteId
type
value
}
}
Mostrar resposta
{
"data": {
"shippingQuotes": [
{
"deadline": 2,
"deliverySchedules": [
{
"date": "2023-04-28T05:00:00.000-03:00",
"periods": [
{
"end": "19:00:00",
"id": 34,
"start": "11:00:00"
}
]
},
// ...
],
"name": "Teste",
"shippingQuoteId": "0663cbab-2258-463e-912c-5beaf1930087",
"type": "Tabela",
"value": 21.9
}
]
}
}
Cotação de frete com mais de um produto variante com matriz de atributos e suas quantidades
Segue abaixo um exemplo de cotação de frete com vários produtos variantes com matriz de atributos e suas respectivas quantidades:
query {
shippingQuotes(
cep: "80420120"
products: [
{ productVariantId: 179, quantity: 1 }
{ productVariantId: 180, quantity: 1 }
]
) {
name
type
value
deadline
products {
productVariantId
value
}
}
}
Mostrar resposta
{
"data": {
"shippingQuotes": [
{
"name": "Teste Cadastro",
"type": "Retirada",
"value": 0,
"deadline": 1,
"products": [
{
"productVariantId": 179,
"value": 0
},
{
"productVariantId": 180,
"value": 0
}
]
},
{
"name": "Correios PAC 2",
"type": "Intelipost",
"value": 57.4,
"deadline": 6,
"products": [
{
"productVariantId": 179,
"value": 28.7
},
{
"productVariantId": 180,
"value": 28.7
}
]
},
{
"name": "Correios Sedex 23123",
"type": "Intelipost",
"value": 157.49,
"deadline": 2,
"products": [
{
"productVariantId": 179,
"value": 78.75
},
{
"productVariantId": 180,
"value": 78.74
}
]
},
{
"name": "SEDEX Varejo",
"type": "Correios",
"value": 552.02,
"deadline": 22,
"products": [
{
"productVariantId": 179,
"value": 276.01
},
{
"productVariantId": 180,
"value": 276.01
}
]
}
]
}
}
Updated 3 months ago