Prazos de Entrega

A Kanglu calcula automaticamente a previsao de entrega dos pedidos. Voce pode configurar como esse calculo e feito para cada transportadora individualmente, ou definir um padrao para todas.

Acesse a pagina em Configuracoes > Prazos no menu lateral.

Modos de Calculo

Cada transportadora pode ser configurada com um dos seguintes modos:

Modo	Comportamento
Nativo	Usa a cotacao direta da transportadora (ex: API da Mandae). So disponivel para transportadoras que possuem integracao nativa de cotacao.
Frenet	Usa a API da Frenet para estimar o prazo de entrega. Requer que a Frenet esteja conectada nas Integracoes.
Fallback	Tenta nativo primeiro, depois Frenet, depois usa o prazo informado pelo ERP (ex: `prazo_entrega` do Bling). Recomendado como padrao.
Desativado	Nao calcula previsao de entrega para esta transportadora.
Usar padrao	Usa a configuracao padrao definida no topo da pagina. Disponivel apenas na configuracao por transportadora.

O modo Fallback e o mais recomendado como padrao, pois garante que sempre havera uma estimativa de prazo, mesmo que a fonte principal falhe.

Configuracao Padrao

No topo da pagina de Prazos, voce define o modo padrao que sera aplicado a todas as transportadoras que nao possuem configuracao especifica.

Campo	Descricao
Modo	Fallback, Frenet ou Desativado
Dias adicionais	Numero de dias uteis extras a adicionar ao prazo calculado (buffer de seguranca)

Configuracao por Transportadora

Abaixo da configuracao padrao, cada transportadora conectada aparece com seus proprios controles:

Modo — Escolha entre Nativo, Frenet, Fallback, Desativado ou Usar Padrao
Dias adicionais — Buffer extra especifico para esta transportadora
Badge "Cotacao nativa" — Aparece automaticamente para transportadoras que possuem funcao de cotacao integrada (ex: Mandae)

O modo Nativo so pode ser selecionado para transportadoras que possuem a badge "Cotacao nativa". Atualmente, apenas a Mandae possui cotacao nativa.

Dias Adicionais

O campo "Dias adicionais" permite adicionar um buffer ao prazo calculado. Isso e util para cobrir atrasos operacionais ou logisticos.

Como funciona:

O sistema calcula o prazo pela fonte configurada (nativo, Frenet ou ERP)
Adiciona os dias adicionais configurados
Recalcula a data de previsao de entrega considerando apenas dias uteis (excluindo sabados e domingos)

Exemplo: Se a Frenet retorna 8 dias e voce configurou +2 dias adicionais, o prazo final sera de 10 dias uteis.

Os dias adicionais podem ser configurados tanto no padrao (aplica a todos) quanto por transportadora (sobrescreve o padrao).

Frenet

A Frenet e um agregador de cotacoes de frete. Com ela, a Kanglu pode estimar prazos de entrega para qualquer transportadora, mesmo as que nao possuem cotacao nativa.

Conectando a Frenet

Acesse Configuracoes > Integracoes no menu lateral
Na secao "Cotacao / Prazos", clique em Conectar no card da Frenet
Informe o Token da API obtido no Painel Frenet
Clique em Conectar

A Frenet usa apenas um token de API para autenticacao. Voce pode obter o token no painel da Frenet em Configuracoes > API.

Como a cotacao funciona

Quando um pedido e registrado, a Kanglu envia uma requisicao para a API da Frenet com:

CEP de origem — CEP da sua empresa
CEP de destino — CEP do cliente
Peso — Peso do pedido (ou 0.3kg como fallback)
Valor — Valor total do pedido

A Frenet retorna cotacoes de diversas transportadoras. A Kanglu automaticamente identifica a transportadora correta e extrai o prazo de entrega.

Status da Frenet

Na pagina de Prazos, um banner no topo indica se a Frenet esta conectada:

Verde — Frenet conectada e disponivel para cotacoes
Laranja — Frenet nao conectada, com botao para ir as Integracoes

Modo Fallback (detalhado)

O modo Fallback segue uma cadeia de tentativas para garantir que sempre haja uma estimativa:

1. Tenta cotacao NATIVA (se a transportadora tem funcao de cotacao)
   ↓ falhou ou nao disponivel
2. Tenta cotacao via FRENET (se a Frenet esta conectada)
   ↓ falhou ou nao disponivel
3. Usa o prazo informado pelo ERP (ex: campo prazo_entrega do Bling)
   ↓ nao disponivel
4. Sem previsao de entrega

No modo Fallback, se nenhuma fonte retornar um prazo, o pedido simplesmente nao tera previsao de entrega — nenhum erro e gerado.

Dados salvos no pedido

Quando o prazo e calculado com sucesso, os seguintes campos sao preenchidos no pedido:

Campo	Descricao
cotacao_servico	Nome do servico utilizado (ex: "Mandae - Economico")
cotacao_prazo_dias	Prazo em dias uteis
cotacao_valor_frete	Valor do frete retornado pela cotacao
data_previsao_entrega	Data estimada de entrega (calculada em dias uteis a partir da data de venda)
cotacao_created_at	Data/hora em que a cotacao foi realizada

Esses dados sao exibidos na pagina de detalhes do pedido no painel e tambem podem ser usados nas notificacoes enviadas ao cliente.

Prazos de Entrega

On this page