ShippingQuoteGroups

A query shippingQuoteGroups retorna informações de cotações de frete agrupadas por Centro de Distribuição (CD), considerando um checkout ou CEP específico.

Essa query é útil em operações com multifrete, onde diferentes CDs são responsáveis pelo envio dos produtos.

❗️

Importante!

Essa query só pode ser utilizada em lojas que estão com a configuração de Multi-frete ativa.

Exemplo

{
  shippingQuoteGroups(
    checkoutId: "0c7c7a90-db98-4c7f-af73-2e4a3fe1261e"
    cep: "80050260"
  ) {
    distributionCenter {
      id
      sellerName
      name
    }
    shippingQuotes {
      name
      shippingQuoteId
      type
      value
    }
  }
}

Mostrar resposta
{
  "data": {
    "shippingQuoteGroups": [
      {
        "distributionCenter": {
          "id": "eyJFbnRpdHkiOiJEaXN0cmlidXRpb25DZW50ZXIiLCJJZCI6MjV9",
          "sellerName": null,
          "name": "CD Padrão"
        },
        "shippingQuotes": [
          {
            "name": "Awake",
            "shippingQuoteId": "35baf232-9a7c-43b5-95ec-452ac4df78bd",
            "type": "Retirada",
            "value": 0
          }
        ]
      }
    ]
  }
}

Argumentos da query

ArgumentoTipoObrigatórioDescrição
checkoutIdUUIDSimIdentificador do checkout que será usado para calcular as cotações
cepStringNãoAlternativa ao checkoutId, permite simular cotações por CEP
useSelectedAddressBooleanNãoIndica se deve usar o endereço selecionado no checkout para a cotação

Campos de retorno

distributionCenter
Identifica o CD responsável pela cotação daquele grupo de produtos.

CampoTipoDescrição
idStringID codificado do centro de distribuição
sellerNameStringNome do seller, caso o CD esteja vinculado a um seller formal. Pode ser null
nameStringNome do Centro de Distribuição (CD). Preenchido mesmo que não haja seller cadastrado

shippingQuotes

Array de cotações com retorno igual ao da query shippingQuotes

🚧

O campo name

Foi adicionado para permitir identificar o CD mesmo quando não há seller formal vinculado. Ele é útil em operações onde cada CD atua como seller internamente, mas não está registrado como tal no sistema.