POST /melhorenvio-frete-calc

https://auth.kleevopay.com/functions/v1/melhorenvio-frete-calc

Calcula as opções de frete disponíveis para um CEP de destino, considerando os produtos do carrinho.

🔑 Autenticação: nenhuma.

Corpo da requisição

{
  "seller_id": "uuid",
  "cep_destino": "01310-100",
  "items": [{ "product_id": "uuid", "quantity": 2 }]
}

Exemplo de requisição

cURL

curl --request POST \
  --url https://auth.kleevopay.com/functions/v1/melhorenvio-frete-calc \
  --header 'content-type: application/json' \
  --data '{
    "seller_id": "uuid",
    "cep_destino": "01310-100",
    "items": [{ "product_id": "uuid", "quantity": 2 }]
  }'

JavaScript

const response = await fetch(
  'https://auth.kleevopay.com/functions/v1/melhorenvio-frete-calc',
  {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({
      seller_id: 'uuid',
      cep_destino: '01310-100',
      items: [{ product_id: 'uuid', quantity: 2 }],
    }),
  }
)

const shippingOptions = await response.json()

Python

import requests

response = requests.post(
    "https://auth.kleevopay.com/functions/v1/melhorenvio-frete-calc",
    headers={"content-type": "application/json"},
    json={
        "seller_id": "uuid",
        "cep_destino": "01310-100",
        "items": [{"product_id": "uuid", "quantity": 2}],
    },
)

shipping_options = response.json()

Resposta 200

Lista de opções de frete, cada uma com transportadora, prazo e valor.

Resposta 422

{ "error": true, "message": "Nenhuma opção de frete disponível para este endereço." }
🚫 Respostas de erro: a rota de frete usa o campo message além do error booleano quando não há opções disponíveis para o endereço informado.