Calcular frete

POST  https://api.axado.com.br/v2/consulta

Descrição

Realiza uma consulta de cálculo de frete.

Running

Status

Tempo de resposta: 220ms

Parâmetros

Nome Tipo Descrição Exemplo Obrigatório
cep_origem String CEP de origem de onde a mercadoria será enviada, deve ser uma string contendo apenas números, incluindo os zeros a esquerda 04050000
cep_destino String CEP de destino da mercadoria a ser enviada, deve ser uma string contendo apenas números, incluindo os zeros a esquerda 04050000
valor_notafiscal String Valor total dos produtos no carrinho 130.72
prazo_adicional String Prazo fixo (em dias) adicionado ao final do cálculo de prazo da consulta 1
preco_adicional String Preço fixo (em reais) adicionado ao final do cálculo do valor do frete (mostrado ao cliente) 1.00
volumes Array Lista contendo os volumes: Ver volumes 2014-02-30
fretegratis Boolean Se passado como true, o produto fica com frete grátis independente da campanha. true

Exemplo de Request - cURL

                                                                         
curl -X POST "https://api.axado.com.br/v2/consulta?token={seu_token}"
    -d "{
        "cep_origem": "04050000",
        "cep_destino": "88020010",
        "valor_notafiscal": "130.72",
        "prazo_adicional": "1",
        "preco_adicional" "1.00",
        "volumes": [
            {
                "sku": "A-01",
                "quantidade": "1",
                "preco": "15,20",
                "altura": "35",
                "comprimento": "10",
                "largura": "30",
                "peso": "2"
            }
         ]
        }"
      
                                
                                
Testar API

Retornos

200 Retorna um Json contendo uma lista de cotações resultantes da consulta:

Nome Tipo Descrição Exemplo
consulta_token String Identificador único da consulta. 04050000
cotacoes Array Lista de cotações calculadas a partir das tabelas de frete que devem ser exibidas ao seu cliente, elas podem ser alteradas pela personalização de frete ou campanha de frete. Ver exemplo

400 Caso haja qualquer erro, tanto de desenvolvimento da integração, quanto na utilização pelo usuário final, será retornado um documento informando o código do erro erro_id e erro_mensagem.

Obs O serviço servico_metaname pode vir repetido quando ativado a leilão de frete.
Neste caso pode ser usado o serviço servico_nome.Ver exemplo

erro_id nome detalhes
101 CEP_ORIGEM_NAO_ENCONTRADO CEP de origem não consta na base de CEP atual dos correios
102 CEP_DESTINO_NAO_ENCONTRADO CEP de destino não consta na base de CEP atual dos correios
103 VALOR_NOTA_INVALIDO Valor da nota não é um número válido
104 VOLUMES_INVALIDO Nenhum volume foi informado ou um dos volumes tem o valor quantidade inválido
106 COMPRIMENTO_INVALIDO Comprimento não é um número válido
107 LARGURA_INVALIDA Largura não é um número válido
108 ALTURA_INVALIDA Altura não é um número válido
109 PESO_INVALIDO Peso não é um número válido
110 SETOR_INVALIDO Erro legado para setor inválido
1000 PRECO_INVALIDO O preço de um dos volumes não é um número válido
301 POST_ERRADO Falta parâmetro no post
302 POST_URL_MAL_FORMATA URL mal formatada para o parâmetro
303 JSON_INVALIDO Houve algum problema no json, como erro de syntaxe, valores faltando ou tipos inválidos
304 REQUISICAO_INVALIDA Requisição inválida, nenhum valor para fazer o cálculo foi informado

401 O token (código de acesso) informado é inválido.

erro_id erro_mensagem
1 Erro de autenticação

429 Caso o seu plano tenha um limite no número de consultas

erro_id erro_mensagem
2 Limite de consultas atingido

500

erro_id erro_mensagem
0 Ocorreu um erro no servidor