Calcular frete

POST /api/v1/frete/calcular

Calcula serviços disponíveis para o CEP de destino. Sem peso/dimensões, usa o pacote padrão e marca a resposta como estimativa. Cotações reais exigem peso explícito e valor declarado maior que zero.

POST Requisição

bash

curl -X POST "https://ev.paylog.cash/api/v1/frete/calcular" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "cep_destino": "string",
    "peso": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "valor_declarado": 0
  }'

php

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_TOKEN')
    ->acceptJson()
    ->post('https://ev.paylog.cash/api/v1/frete/calcular', [
    'cep_destino' => 'string',
    'peso' => 0,
    'comprimento' => 0,
    'largura' => 0,
    'altura' => 0,
    'valor_declarado' => 0
  ]);

javascript

const response = await fetch("https://ev.paylog.cash/api/v1/frete/calcular", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "cep_destino": "string",
    "peso": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "valor_declarado": 0
  }),
});

python

import requests

response = requests.post(
    "https://ev.paylog.cash/api/v1/frete/calcular",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
    "cep_destino": "string",
    "peso": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "valor_declarado": 0
  },
)

ruby

require "net/http"
require "json"
require "uri"

uri = URI("https://ev.paylog.cash/api/v1/frete/calcular")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {
  "cep_destino" => "string",
  "peso" => 0,
  "comprimento" => 0,
  "largura" => 0,
  "altura" => 0,
  "valor_declarado" => 0
}.to_json

response = http.request(request)

200 Resposta

json

{
  "cotacao_tipo": "real",
  "origem": {
    "cep": "string",
    "cidade": "string",
    "uf": "string"
  },
  "destino": {
    "cep": "string"
  },
  "pacote": {
    "peso": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "padrao_aplicado": true
  },
  "cotacoes": [
    {
      "transportadora": "string",
      "transportadora_codigo": "string",
      "transportadora_logo": "string",
      "servicos": [
        {
          "servico": null,
          "codigo": null,
          "valor_centavos": null,
          "prazo_dias": null
        }
      ]
    }
  ],
  "transportadoras_omitidas": [
    {
      "codigo": "string",
      "transportadora": "string",
      "motivo": "string"
    }
  ],
  "message": "string"
}

Corpo da requisição

application/json

object

cep_destino string Obrigatório

Obrigatório. CEP brasileiro com 8 dígitos, com ou sem hífen.
peso number

Opcional. Peso em quilogramas; o padrão é 0.5. Peso explícito é necessário para cotação real.
comprimento number

Opcional. Comprimento em centímetros; padrão 20.
largura number

Opcional. Largura em centímetros; padrão 15.
altura number

Opcional. Altura em centímetros; padrão 5.
valor_declarado number

Opcional. Valor declarado em reais; deve ser maior que zero junto com peso explícito para cotação real.

Respostas

200

Cotações calculadas. cotacoes pode ficar vazio e incluir uma mensagem explicativa.

application/json

object

cotacao_tipo string Obrigatório

Valores permitidos real estimativa
origem object Obrigatório
- cep string Obrigatório
- cidade string aceita nulo Obrigatório
- uf string aceita nulo Obrigatório
destino object Obrigatório
- cep string Obrigatório
pacote object Obrigatório
- peso number Obrigatório
- comprimento number Obrigatório
- largura number Obrigatório
- altura number Obrigatório
- padrao_aplicado boolean Obrigatório
  
  true quando ao menos uma medida/peso usou o padrão.
cotacoes array Obrigatório
Itens
object

transportadora string Obrigatório

transportadora_codigo string Obrigatório

transportadora_logo string aceita nulo Obrigatório

servicos array Obrigatório

Itens

object

servico string Obrigatório

codigo string Obrigatório

valor_centavos integer Obrigatório

Preço final cobrado do produtor, em centavos. Serviços com preço menor ou igual a zero são removidos da resposta.

prazo_dias integer aceita nulo Obrigatório
transportadoras_omitidas array Obrigatório
Itens
object

codigo string Obrigatório

transportadora string Obrigatório

motivo string Obrigatório
message string

Presente apenas quando nenhuma cotação está disponível.

401

Token Bearer ausente ou inválido.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

422

Erro de validação dos dados da cotação.

application/json

object

error string Obrigatório
errors object Obrigatório

429

Limite de 60 cálculos por minuto por usuário autenticado excedido.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

500

Falha interna durante o processamento.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.