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

Request

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

Mostrar resposta

Response

{
  "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

Argumento	Tipo	Obrigatório	Descrição
checkoutId	UUID	Sim	Identificador do checkout que será usado para calcular as cotações
cep	String	Não	Alternativa ao checkoutId, permite simular cotações por CEP
useSelectedAddress	Boolean	Não	Indica 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.

Campo	Tipo	Descrição
id	String	ID codificado do centro de distribuição
sellerName	String	Nome do seller, caso o CD esteja vinculado a um seller formal. Pode ser null
name	String	Nome 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.