Configuração Agendamento
A tela de Configuração Agendamento é onde você define quando o CD aceita receber mercadoria — os horários disponíveis para fornecedores e transportadoras marcarem entrega no seu centro de distribuição. Sem essa configuração, a tela de Agendamento (que os fornecedores ou o time interno usam para marcar) fica sem janelas para escolher.
A configuração tem três blocos: identificação (qual CD ela controla), regras gerais (duração de cada janela, limites diários de itens e notas, antecedência mínima/máxima, tolerância no check-in) e o quadro de horários da semana (para cada dia da semana — domingo a sábado — uma ou mais faixas de horário disponíveis).
A regra de unicidade é clara: um CD pode ter no máximo uma configuração. Se você tem múltiplos centros de distribuição, cadastre uma configuração por CD — cada um pode ter horários, duração e limites diferentes. A exclusão é livre (sem regra de bloqueio) e o sistema remove automaticamente o quadro de horários junto com a configuração.
Índice
Conceito
- O que é a Configuração Agendamento?
- Como esta tela se conecta com a tela de Agendamento?
- Por que cada CD tem sua própria configuração?
Antes de cadastrar
Estrutura da configuração
- Quais campos compõem a configuração?
- O que é Duração?
- O que é Limite de itens por dia?
- O que é Máximo de agendamentos por dia?
- O que é Intervalo de dias para agendamento?
- O que é Mínimo de horas de antecedência?
- O que é Tempo de tolerância (check-in)?
Quadro de horários da semana
- Como funciona o quadro de horários?
- Como adicionar várias faixas no mesmo dia?
- Como copiar os horários de um dia para os outros?
- Como marcar um dia como indisponível?
- Como apagar todos os horários de um dia?
Exemplos completos
- Exemplo 1 — CD comercial padrão (Seg-Sex, 8h-17h, slots de 30 min)
- Exemplo 2 — CD com almoço fechado e janela manhã/tarde
- Exemplo 3 — CD 24h com janelas longas
- Exemplo 4 — CD com sábado meio expediente
- Exemplo 5 — CD pequeno com poucos agendamentos por dia
Cadastro e gestão
- Como criar a configuração?
- Como editar a configuração?
- Como excluir a configuração?
- Como criar configurações para múltiplos CDs?
Diagnóstico
- Recebi "Já existe uma agenda para esse centro de distribuição"
- Os fornecedores não conseguem marcar agendamento
- O sistema está aceitando agendamentos fora do horário cadastrado
Referência rápida
O que é a Configuração Agendamento?
É o calendário de disponibilidade do CD para receber mercadoria. Antes que qualquer fornecedor ou transportadora consiga marcar uma entrega, esta tela precisa estar configurada — ela diz em quais dias e em quais horários o CD aceita recebimento, quanto tempo dura cada janela de agendamento, quantos agendamentos cabem no dia e com que antecedência os agendamentos podem ser marcados.
📍 Onde: menu lateral → Logística → Config. Agendamento.
Como esta tela se conecta com a tela de Agendamento?
Esta tela é o suporte; a tela de Agendamento (Logística → Agendamento) é onde as marcações realmente acontecem. O fluxo:
- Você cadastra a Configuração de Agendamento aqui (definindo dias, horários, duração e limites).
- Fornecedores ou time interno acessam a tela de Agendamento.
- O sistema mostra somente os slots disponíveis que respeitam:
- Os dias e faixas de horário cadastrados aqui.
- A duração configurada (cada slot tem o tamanho que você definiu).
- Os limites diários (quando o teto de itens/agendamentos do dia é atingido, novos agendamentos para aquele dia ficam bloqueados).
- A antecedência mínima (não dá para marcar para daqui a 30 minutos se a antecedência mínima é 2 horas).
- A janela máxima de antecipação (não dá para marcar para daqui a 90 dias se a janela é 60).
- O agendamento marcado vai para a fila do CD e fica visível no check-in.
Sem configuração, a tela de Agendamento não mostra nenhuma janela disponível.
Por que cada CD tem sua própria configuração?
Porque cada CD tem realidade operacional diferente:
- O CD principal pode atender de segunda a sábado das 7h às 19h e aceitar 200 itens/dia.
- Um CD menor pode atender só de segunda a sexta das 9h às 17h e aceitar 50 itens/dia.
- Um CD especializado pode operar 24h em janelas de 1h cada.
O sistema impõe uma única configuração por CD para que não haja ambiguidade na hora do agendamento.
Pré-requisitos
| Passo | O que configurar | Onde |
|---|---|---|
| 1 | Centro de Distribuição cadastrado | Logística → Centro de Distribuição |
É o único pré-requisito. Apenas locais cadastrados como Centro de Distribuição entram na lista — armazéns auxiliares e outros tipos de unidade não aparecem.
Quais campos compõem a configuração?
| Campo | O que define | Obrigatório |
|---|---|---|
| Conta | Empresa dona da configuração (apenas multi-empresa). | Sim |
| Centro de distribuição | Qual CD esta configuração controla. | Sim |
| Duração | Tamanho de cada janela de agendamento (em minutos ou horas). | Sim |
| Limite de itens por dia | Quantidade máxima de unidades de produto que o CD aceita em um dia. | Não |
| Intervalo de dias para agendamento | Quantos dias à frente o sistema mostra como disponível. | Não |
| Mínimo de horas de antecedência | Quanto antes o agendamento precisa ser marcado. | Não |
| Máximo de agendamentos por dia | Quantas notas/agendamentos cabem em um único dia. | Não |
| Tempo de tolerância | Margem entre o horário marcado e o check-in real sem penalizar o agendamento. | Não |
| Horários da semana | Para cada dia da semana, uma ou mais faixas (início + fim). | Recomendado |
O que é Duração?
Define quanto tempo dura cada slot de agendamento. Quando você define uma faixa de horário (ex.: 8h-12h) com duração de 30 minutos, o sistema divide a faixa em slots: 8:00, 8:30, 9:00, 9:30 … 11:30 — 8 slots de 30 min cada.
Você informa em formato livre: digite 2h, 30m, 1h30, 45m, etc. O sistema converte para minutos internamente e mostra o rótulo amigável ("1 hora e 30 minutos").
Como escolher:
- Operações com alto volume de recebimentos: slots curtos (15-30 min) para girar mais entregas no dia.
- Operações com caminhão grande (carga consolidada, descarga demorada): slots longos (1h-2h) para acomodar o tempo de descarga.
- Média do mercado: 30 minutos a 1 hora por slot.
O que é Limite de itens por dia?
Quantidade máxima de unidades de produto que o CD aceita receber em um dia. Soma de todos os agendamentos.
Exemplo: limite = 500.
- Agendamento A com NF de 100 itens → restam 400 disponíveis.
- Agendamento B com NF de 250 itens → restam 150.
- Agendamento C com NF de 200 itens → seria 250, bloqueado (estoura 500).
Sem limite definido, o CD aceita qualquer quantidade.
Use quando: a equipe de recebimento tem capacidade de processar X itens por dia e você quer evitar sobrecarga.
O que é Máximo de agendamentos por dia?
Quantidade máxima de notas fiscais / agendamentos que cabem em um dia, independente da quantidade de itens de cada um.
Exemplo: máximo = 20.
- 20 fornecedores agendaram para o dia 15 → o slot 21 fica bloqueado mesmo que ainda haja horário aberto no quadro.
Sem limite definido, o número de agendamentos é controlado apenas pelo número de slots disponíveis no quadro da semana.
Use quando: a equipe de portaria/conferência tem limite operacional independente do volume — ex.: 1 conferente faz no máximo 15 atendimentos por dia, então máximo = 15.
O que é Intervalo de dias para agendamento?
Define quantos dias para frente o sistema deixa marcar agendamento, contados a partir de hoje.
Exemplo: intervalo = 60.
- Hoje é 15/04/2025.
- O sistema disponibiliza agendamentos até 15/06/2025 (60 dias depois).
- Tentar marcar para 16/06 ou depois → bloqueado.
Como escolher:
- 7 a 15 dias: operação muito dinâmica, com previsão de curto prazo.
- 30 a 60 dias: padrão para operações com fornecedores que planejam com semanas de antecedência.
- 90+ dias: operações grandes com previsão trimestral.
Sem limite, o sistema deixa marcar para qualquer data futura.
O que é Mínimo de horas de antecedência?
Quantas horas o fornecedor precisa marcar antes do horário desejado. Evita que alguém marque para "agora mesmo" sem dar tempo ao CD se preparar.
Exemplo: antecedência = 2.
- Agora são 14:00.
- Disponível para marcar: a partir das 16:00 do mesmo dia.
- Slot 14:30 ou 15:30 → bloqueado (não dá os 2h mínimos).
Como escolher:
- 1h: operações flexíveis, com equipe sempre disponível.
- 2-4h: padrão para CDs que precisam preparar docas, escala de conferentes.
- 24-48h: operações grandes que exigem planejamento de janela.
O que é Tempo de tolerância (check-in)?
Margem em minutos que o sistema considera aceitável entre o horário marcado do agendamento e o horário real do check-in da transportadora na portaria. Evita que pequenos atrasos virem registros de "agendamento atrasado".
Exemplo: tolerância = 30 minutos. Agendamento marcado para 10:00.
- Check-in às 10:15 → dentro da tolerância (atraso de 15 min, aceito).
- Check-in às 10:30 → no limite.
- Check-in às 10:45 → atrasado (passou da tolerância).
Você informa no mesmo formato livre da Duração: 30m, 1h, 1h30.
Como escolher:
- 15-30 minutos: padrão da maioria das operações.
- 1h: operações com fornecedores vindos de longe (risco de trânsito).
- 0: rigor máximo — qualquer atraso conta.
Como funciona o quadro de horários?
Abaixo dos campos de regras gerais, a tela mostra o quadro semanal — uma seção colapsável por dia da semana (Domingo, Segunda, Terça, Quarta, Quinta, Sexta, Sábado). Para cada dia, você pode:
- Adicionar uma ou mais faixas de horário (ex.: 08:00-12:00 e 13:00-17:00).
- Marcar o dia como indisponível (não aceita agendamentos no dia).
- Apagar todas as faixas do dia (mesma coisa que indisponível).
- Copiar os horários desse dia para todos os outros dias da semana.
Cada faixa tem Horário de início e Horário de fim. O sistema então quebra essa faixa em slots usando a Duração configurada.
Exemplo: faixa 08:00-12:00 com Duração 1 hora → slots disponíveis: 08:00, 09:00, 10:00, 11:00 (4 slots).
Como adicionar várias faixas no mesmo dia?
Útil quando o CD pausa para almoço:
- No dia desejado (ex.: Segunda), clique em Adicionar faixa.
- Preencha Início 08:00 e Fim 12:00.
- Clique em Adicionar faixa novamente.
- Preencha Início 13:00 e Fim 17:00.
- Salvar.
Resultado: agendamentos disponíveis das 8h-12h e das 13h-17h. Entre 12h e 13h não há slots.
Você pode adicionar quantas faixas precisar (manhã, tarde, noite, etc.).
Como copiar os horários de um dia para os outros?
Útil quando segunda a sexta seguem o mesmo padrão:
- Configure a Segunda-feira com todas as faixas que deseja.
- Use a opção Aplicar a todos os dias dentro do painel da Segunda.
- O sistema copia as faixas da Segunda para Domingo, Terça, Quarta, Quinta, Sexta e Sábado.
- Depois você pode editar os dias específicos que devem ser diferentes (ex.: apagar as faixas do Sábado e Domingo).
Atalho enorme para configurações que seguem padrão semanal regular.
Como marcar um dia como indisponível?
Duas formas:
- Marcar dia como indisponível no painel do dia (não cria faixas; deixa o dia explicitamente fechado).
- Apagar todas as faixas do dia (mesmo efeito prático — sem faixas = sem slots).
Use quando o CD não opera em determinado dia (ex.: domingo fechado, ou quarta-feira reservada para inventário interno).
Como apagar todos os horários de um dia?
Dentro do painel do dia, use a opção Limpar horários do dia — remove todas as faixas daquele dia em um clique, sem precisar excluir uma a uma.
Exemplo 1 — CD comercial padrão (Seg-Sex, 8h-17h, slots de 30 min)
Cenário: CD com expediente comercial, 100 itens/dia de capacidade, equipe preparada para até 30 agendamentos diários.
| Campo | Valor |
|---|---|
| Centro de distribuição | CD São Paulo |
| Duração | 30 minutos |
| Limite de itens por dia | 100 |
| Máximo de agendamentos por dia | 30 |
| Intervalo de dias para agendamento | 30 |
| Mínimo de horas de antecedência | 2 |
| Tempo de tolerância | 15 minutos |
| Horários — Segunda a Sexta | 08:00-12:00 + 13:00-17:00 |
| Horários — Sábado/Domingo | indisponíveis |
Resultado: fornecedores podem marcar até 30 dias para frente, com pelo menos 2h de antecedência, em slots de 30 min nas faixas 8h-12h e 13h-17h (16 slots possíveis por dia). Check-in até 15 min de atraso é aceito sem penalidade.
Exemplo 2 — CD com almoço fechado e janela manhã/tarde
Cenário: CD que recebe das 7h às 11h e das 13h às 18h em slots de 1 hora.
| Campo | Valor |
|---|---|
| Centro de distribuição | CD Curitiba |
| Duração | 1 hora |
| Limite de itens por dia | (vazio) |
| Máximo de agendamentos por dia | 15 |
| Intervalo de dias para agendamento | 60 |
| Mínimo de horas de antecedência | 4 |
| Tempo de tolerância | 30 minutos |
| Horários — Segunda a Sexta | 07:00-11:00 + 13:00-18:00 |
| Horários — Sábado | 08:00-12:00 |
| Horários — Domingo | indisponível |
Resultado: slots de 1 hora em duas janelas durante a semana (manhã + tarde), meio expediente no sábado. Tolerância generosa de 30 min para acomodar trânsito.
Exemplo 3 — CD 24h com janelas longas
Cenário: CD grande operando 24h por dia, com slots de 2 horas para descargas longas. Limite alto, sem máximo de agendamentos.
| Campo | Valor |
|---|---|
| Centro de distribuição | CD Hub Logístico |
| Duração | 2 horas |
| Limite de itens por dia | 5000 |
| Máximo de agendamentos por dia | (vazio) |
| Intervalo de dias para agendamento | 90 |
| Mínimo de horas de antecedência | 24 |
| Tempo de tolerância | 1 hora |
| Horários — todos os dias | 00:00-23:59 |
Resultado: 12 slots de 2h por dia, 7 dias por semana, com previsão de até 90 dias e antecedência mínima de 24h. Aceita 5000 itens/dia.
Exemplo 4 — CD com sábado meio expediente
Cenário: CD que trabalha sábado de manhã, mas com volume menor.
| Campo | Valor |
|---|---|
| Centro de distribuição | CD Belo Horizonte |
| Duração | 45 minutos |
| Limite de itens por dia | 200 |
| Máximo de agendamentos por dia | 12 |
| Intervalo de dias para agendamento | 30 |
| Mínimo de horas de antecedência | 3 |
| Tempo de tolerância | 20 minutos |
| Horários — Segunda a Sexta | 08:00-17:00 |
| Horários — Sábado | 08:00-12:00 |
| Horários — Domingo | indisponível |
Resultado: sábado meio expediente. Slots de 45 minutos (12 por dia de semana, 5 no sábado).
Exemplo 5 — CD pequeno com poucos agendamentos por dia
Cenário: CD pequeno, equipe enxuta, aceita só 5 agendamentos por dia. Janela curta, antecedência alta.
| Campo | Valor |
|---|---|
| Centro de distribuição | CD Filial Joinville |
| Duração | 1 hora |
| Limite de itens por dia | 50 |
| Máximo de agendamentos por dia | 5 |
| Intervalo de dias para agendamento | 14 |
| Mínimo de horas de antecedência | 48 |
| Tempo de tolerância | 15 minutos |
| Horários — Segunda a Sexta | 09:00-12:00 + 14:00-16:00 |
| Horários — Sábado/Domingo | indisponíveis |
Resultado: máximo de 5 entregas por dia em 5 slots de 1h disponíveis (3 de manhã + 2 à tarde). Antecedência de 48h dá tempo para planejamento de docas.
Como criar a configuração?
- Acesse Logística → Config. Agendamento.
- Clique em Criar Configuração no canto superior direito.
- Preencha:
- Conta (apenas multi-empresa).
- Centro de distribuição (cada CD aceita só 1 configuração).
- Duração (use o atalho de digitar "2h" / "30m" / "1h30" para criar uma duração nova; depois selecione na lista).
- Demais regras gerais (limites, antecedência, tolerância).
- No quadro Horários da semana:
- Para cada dia que terá agendamento, adicione as faixas.
- Use Aplicar a todos os dias para replicar padrão.
- Marque como indisponível os dias fechados.
- Salvar.
Como editar a configuração?
- Localize na lista (cada CD aparece como uma linha).
- Clique em Editar (lápis) ou dê duplo clique na linha.
- Ajuste o que precisa — pode mudar regras, adicionar/remover faixas.
- Salvar.
A edição não cancela agendamentos já marcados. Se você reduzir o horário disponível, agendamentos existentes naquela faixa antiga continuam no calendário; apenas novos agendamentos respeitam a configuração atualizada.
Como excluir a configuração?
- Clique em Remover (lixeira) na linha.
- Confirme.
A exclusão é física — apaga a configuração e todas as faixas de horário associadas em cascata. Cuidado: depois de excluir, o CD fica sem disponibilidade até você cadastrar nova configuração.
Como criar configurações para múltiplos CDs?
Cada CD precisa de configuração própria. Repita o cadastro:
- Crie a configuração do CD 1.
- Crie a configuração do CD 2 (escolha outro CD na lista — o CD 1 fica filtrado automaticamente).
- E assim por diante.
A lista da tela mostra todas as configurações lado a lado para você comparar regras entre CDs.
Recebi "Já existe uma agenda para esse centro de distribuição"
Significa que o CD escolhido já tem uma configuração ativa. A regra é 1 CD = 1 configuração.
Soluções:
- Em vez de criar nova, edite a configuração existente (clique no lápis na linha do CD desejado).
- Ou, se de fato quer recomeçar, exclua a configuração existente primeiro e depois crie a nova. Cuidado: apagar derruba o quadro de horários do CD.
Os fornecedores não conseguem marcar agendamento
Checklist em ordem:
- Configuração existe para o CD? Confira na lista — se não aparece o CD, crie a configuração.
- Quadro de horários tem faixas? Edite e verifique se cada dia tem pelo menos uma faixa. Sem faixas = sem slots disponíveis.
- Duração faz sentido para a faixa? Faixa de 30 min com Duração de 1 hora → zero slots. Reduza a duração ou aumente a faixa.
- Antecedência mínima muito alta? Se você definiu 48h e o fornecedor está tentando marcar para amanhã, fica bloqueado.
- Janela de antecipação esgotada? Se a janela é 30 dias e o fornecedor quer marcar para 40 dias depois, fica bloqueado.
- Limite diário atingido? Confira na tela de Agendamento se o dia desejado já está fechado (todos os agendamentos consumidos ou limite de itens atingido).
O sistema está aceitando agendamentos fora do horário cadastrado
Causas possíveis:
- Configuração foi editada após os agendamentos serem marcados: agendamentos antigos seguem o cadastro do momento em que foram criados. Cancele e refaça se precisar do horário novo.
- Tolerância está muito alta: tolerância de 1h significa que o check-in pode acontecer até 1h depois do agendamento marcado. Reduza se quiser rigor maior.
- Outro usuário editou a configuração: confira o histórico operacional ou abra a configuração para ver as faixas atuais.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar Agendamento (Configuração) | Acessa a tela e a lista de configurações. Sem este privilégio, o item de menu nem aparece. |
| Criar Agendamento (Configuração) | Botão Criar Configuração habilitado. |
| Editar Agendamento (Configuração) | Botão de edição (lápis) habilitado em cada linha. |
| Deletar Agendamento (Configuração) | Botão de exclusão (lixeira) habilitado em cada linha. |
O nome técnico do grupo é "Configuração Agendamento" — o que define o que cada usuário pode fazer com a configuração. Para liberar uso da tela de Agendamento (onde os agendamentos são marcados), há um grupo de privilégios separado chamado "Agendamento".