Logotipo da Sisfrete - Sistema TMS de Gestão Logística
Documentação

Integração API - Cotação

1. Endereço da API Sisfrete (Endpoint)

A chamada para API Sisfrete é feita através do seguinte endereço web:

https://cotar.sisfrete.com.br/cotacao/Integracao.php

2. Autenticação

Obrigatório no Header da Requisição (HTTP)

Header: {
  "token": "SUA_CHAVE"
}

Se o token estiver errado mostrará uma mensagem de falha.

3. Observação dos campos

Analisar as informações conforme os campos encontrados no item 4.

Verificar a correção dos campos para evitar erros de persistência.

Campo / DescriçãoTipoObrigatoriedade
destination

CEP do comprador (8 dígitos). Aceita qualquer formatação.

stringSim
items

Lista de objetos contendo os produtos da cotação.

arraySim
seller_id

Identificador único da conta do vendedor.

stringNão
canal_vendas

Nome da plataforma ou Marketplace de origem.

stringNão
store_id

ID da loja (para múltiplas unidades).

stringNão
sku

Código de identificação do produto.

stringSim
quantity

Quantidade de itens do mesmo SKU.

intSim
origin

CEP de postagem do lojista (8 dígitos).

stringSim
price

Preço unitário x quantidade.

floatSim
dimensions

Objeto contendo medidas e peso.

objectSim
length

Comprimento em centímetros.

floatSim
width

Largura em centímetros.

floatSim
height

Altura em centímetros.

floatSim
weight

Peso total em quilogramas.

floatSim

4. Estrutura do JSON Request

Envio dos dados para registro e cálculo de frete no banco de dados.

{
  "destination": "13295000",
  "items": [
    {
      "seller_id": "89540000",
      "sku": "prod-1",
      "quantity": 1,
      "origin": "02611-000",
      "price": 316,
      "dimensions": {
        "length": 1,
        "height": 1,
        "width": 1,
        "weight": 1
      }
    }
  ]
}

5. Estrutura do JSON de Resposta

Retorno das cotações processadas e separadas por pacotes de envio.

A resposta retorna as cotações separadas por “pacotes”. Cada pacote oferece as modalidades Normal ou Expresso.

Atributos de Items

skuIdentificação do item a ser comprado.
seller_idIdentificação da conta vendedora (cópia do request).
store_idOpcional. Identificação da loja específica.
quantityQuantidade enviada neste pacote específico (pode variar por CD).
stockDisponibilidade em estoque por CD. Caso indisponível, retornar -1.
error_codeCódigo de erro específico do produto (ver tabela abaixo).

Atributos de Quotations

costCusto real do frete. Se indisponível, retornar valor igual ao price.
pricePreço apresentado ao comprador (pode ser subsidiado/grátis).
handling_timeDias úteis para separação e empacotamento (padrão 0).
shipping_timeDias úteis para o trânsito (entrega).
promiseSoma de handling_time + shipping_time.
captionNome da modalidade. Valores válidos: "Normal" ou "Expresso".
service_idCódigo único do serviço/transportadora (0 a 99).
{
  "packages": [
    {
      "items": [
        {
          "sku": "00266983118",
          "seller_id": "207740981",
          "quantity": 1,
          "stock": -1,
          "error_code": 0
        }
      ],
      "quotations": [
        {
          "cost": 66.6,
          "price": 66.6,
          "handling_time": 0,
          "shipping_time": 39,
          "promise": 39,
          "caption": "Normal"
        }
      ]
    }
  ]
}

Tabela de Erros (error_code)

0Sem Erro
1Sem Estoque
2CEP Inválido
3Não Atendido
4Não Existe
-1Erro Inesperado