Logística & E-commerce
"Seu pedido chegará em X dias úteis" (De verdade)
Garanta prazos de entrega precisos e confiáveis. Calcule a data exata considerando os feriados da cidade de origem e destino.
O Problema do "Dia Útil"
No e-commerce, a satisfação do cliente depende da entrega no prazo. Se o seu checkout promete "5 dias úteis", ele precisa considerar que:
Origem (Expedição)
Feriados no local do CD influenciam a data de saída do pedido.
Trânsito
Transportadoras funcionam em regime especial em feriados estaduais.
Destino (Entrega)
Feriados locais no destino podem adiar o recebimento.
Como Resolver com a API
- 1
Receba o CEP do Cliente
Identifique o código IBGE da cidade.
- 2
Consulte Feriados no Prazo
Verifique feriados nos próximos dias na origem e destino.
- 3
Adicione Dias de Margem
Se houver feriado, some +1 dia ao prazo final exibido.
Integração Simples
Nossa API retorna os feriados completos e metadados essenciais para o seu cálculo de frete. Simule uma entrega de São Paulo para Curitiba:
- Consulte feriados na origem (Expedição)
- Consulte feriados no destino (Entrega)
- Adicione margem de segurança automática
// 1. Verificar Origem (SP)
const origem = await api.get(
`/feriados/cidade/3550308?data=${dataExpedicao}`
);
// 2. Verificar Destino (Curitiba)
const destino = await api.get(
`/feriados/cidade/4106902?data=${dataEntrega}`
);
if (origem.length > 0 || destino.length > 0) {
prazoEntrega += 1; // Adiciona +1 dia útil
}