Pular para o conteúdo principal

Agendamento

A tela de Agendamento é o calendário do CD — onde você vê e gerencia os horários em que recebimentos de mercadoria estão marcados para chegar. Cada compromisso é um cartão no calendário com data, hora de início, hora de término, fornecedor, nota fiscal e status. O time da portaria, conferência e supervisão usam essa tela para se organizar: quem chega às 8h, quem chega às 14h, quantas notas em cada janela do dia.

A tela apresenta o calendário em três visões (mês, semana, dia), cada cartão colorido conforme o status calculado automaticamente pelo sistema: verde para já recebido, azul para agendado no futuro, vermelho para atrasado (passou da hora e ninguém chegou), cinza para bloqueios avulsos (sem recebimento amarrado, usado para reservar espaço da agenda em manutenção ou eventos internos).

Os horários disponíveis na agenda não são livres — eles vêm da tela Configuração Agendamento (cadastrada pelo administrador), que define quais dias da semana o CD opera, em quantas janelas (manhã/tarde/noite), quanto dura cada slot, quantas notas/itens cabem por dia, com que antecedência o agendamento pode ser feito e qual tolerância de atraso o check-in aceita. Esta tela é o lado do operador; a Configuração Agendamento é o lado do administrador.

Índice​

Conceito

Visões e cartões

Status do agendamento

Criar agendamento

Editar e excluir

Exportar e imprimir

Diagnóstico

Referência rápida

O que é a tela de Agendamento?​

É o calendário de recebimento do CD. Cada cartão no calendário representa um horário marcado em que algum recebimento de mercadoria vai chegar: data, hora de início, hora de término, fornecedor (quando amarrado a um recebimento), número da NF, status atual.

Os cartões servem para:

  • Visualizar o pipeline de chegadas do dia/semana/mês.
  • Distribuir carga de trabalho entre os turnos da portaria.
  • Identificar atrasos rapidamente (cartões vermelhos).
  • Bloquear horários em que o CD não pode receber (almoço, evento, manutenção).

📍 Onde: menu lateral → Logística → Agendamento.

Qual a relação com a Configuração Agendamento?​

Duas telas, dois lados:

Configuração AgendamentoAgendamento (esta tela)
Quem usaAdministrador do CD.Operador/Portaria.
Configurado quandoUma vez (ou raramente, em ajustes).Todo dia, na operação.
O que defineQuais janelas existem, duração, limites diários, antecedência, dias da semana.Quem vai usar cada janela, quando, para qual recebimento.
Exemplo"CD recebe segunda a sexta das 8h às 17h em slots de 30 minutos"."Recebimento 1234 do fornecedor X marcado para amanhã, 9h00-9h30".

Sem a Configuração não há janelas para marcar. Com a Configuração mas sem agendamentos, o calendário fica vazio (mas operacional). A Configuração é o esqueleto; o Agendamento preenche a carne.

Quem usa esta tela?​

Normalmente:

  • Time da portaria / recebimento — vê quem vai chegar no dia, prepara docas.
  • Supervisor do CD — distribui equipe pela agenda, identifica picos.
  • Comprador — agenda recebimentos que ele cadastrou.
  • Atendimento ao fornecedor — informa o horário marcado quando o fornecedor liga.

Quais visões do calendário estão disponíveis?​

Três visões padrão (controle no topo do calendário):

  • Mês — visão macro, 30 dias por vez. Cada dia mostra resumo de quantos agendamentos têm.
  • Semana — visão da semana toda em colunas por dia, hora por hora.
  • Dia — apenas o dia escolhido, com horas em colunas detalhadas.

Use Mês para planejar; Semana para gerenciar; Dia para executar (a portaria geralmente fica nessa visão).

Botões adicionais no topo:

  • Atualizar Dados (ícone de seta circular) — recarrega a lista.
  • Exportar Excel — gera planilha com os agendamentos da visão atual.
  • Imprimir — gera imagem do calendário e abre janela de impressão.
  • Criar Agendamento — abre o modal de novo agendamento.

O que cada cor dos cartões significa?​

CorStatusSignificado
Verde (#53b884)RecebidoO recebimento amarrado já foi feito (check-in registrado).
Azul (#34a7e7)AgendadoMarcado para o futuro, ainda não chegou.
Vermelho (#ed5d5d)AtrasadoPassou da hora marcada e o check-in não foi feito.
Cinza (#bfbfbf)Não agendadoBloqueio avulso (sem recebimento amarrado) ou compromisso sem amarração de NF.

A cor é calculada na hora pelo sistema — não tem como mudar manualmente. Quando você faz o check-in do recebimento na portaria, o cartão muda automaticamente de azul para verde.

Como aparece o cartão expandido (popover)?​

Clique em qualquer cartão no calendário e um popover detalhado abre ao lado, mostrando:

  • Cabeçalho colorido (mesma cor do status) com número do agendamento e título/fornecedor.
  • Indicador de recebimento ("Com Recebimento" azul ou "Sem Recebimento" laranja).
  • Data e hora completas (com formatação em português).
  • Detalhes do recebimento (quando há): quantidade de itens, número de SKUs, peso bruto, volume.
  • Observações.
  • Botões de Editar e Excluir (conforme privilégios).

O popover fica posicionado próximo ao cartão clicado e fecha sozinho quando você clica fora.

Para que serve o número antes do título?​

Cada cartão mostra #<id> antes do título — esse é o identificador único do agendamento. Ele aparece na lista, no popover, no cabeçalho do modal de edição e no Excel exportado. Use para referência cruzada quando precisar bater dados com outra tela ou abrir chamado.

Como o status é calculado?​

O sistema usa esta lógica em tempo real na consulta:

  1. Se o recebimento amarrado tem data de check-in → Recebido (verde).
  2. Se o agendamento ainda não passou da data fim e sem check-in → Agendado (azul).
  3. Se o agendamento passou da data fim e ainda sem check-in → Atrasado (vermelho).
  4. Se não tem recebimento amarrado → Não agendado (cinza).

Não há trigger automático de atualização — toda vez que você consulta a lista, o status é recalculado. Por isso o cartão que estava azul às 9h pode estar vermelho às 11h sem você ter feito nada — apenas porque a hora passou.

Por que um agendamento aparece como Atrasado?​

A condição é simples: a hora final do agendamento já passou e o check-in do recebimento ainda não foi feito. Pode ser:

  • A transportadora atrasou e não chegou no horário.
  • A transportadora chegou mas a portaria ainda não fez check-in no sistema.
  • O recebimento foi conferido fisicamente mas alguém esqueceu de registrar a chegada no idworks.

Olhe o vermelho como aviso — provavelmente algo está fora do padrão, vale conferir.

O que é "Não agendado" se está na agenda?​

Status especial para agendamentos avulsos — aqueles que não estão amarrados a um recebimento específico. Servem para:

  • Bloquear horário do CD (almoço, manutenção, evento interno) e impedir agendamentos sobrepostos.
  • Reservar slot para um recebimento que ainda vai chegar mas não foi cadastrado no sistema.
  • Documentar compromissos internos (treinamento da equipe, visita técnica).

Como não há recebimento amarrado, o sistema marca como "Não agendado" (no sentido de "não amarrado") e usa cinza.

Quando um agendamento muda para Recebido?​

Quando o check-in do recebimento é feito na portaria (tela de Compras / Recebimento → ação de check-in). O sistema preenche o campo de data/hora de check-in e, na próxima consulta da agenda, o cartão aparece verde.

Não há ação manual nesta tela para "marcar como recebido" — o status é derivado do check-in feito em outra tela.

Como criar um agendamento amarrado a um recebimento?​

Caso mais comum: o recebimento já foi cadastrado em Compras (XML importado ou cadastro manual) e você quer marcar quando ele vai chegar.

  1. Clique em Criar Agendamento no topo da tela.
  2. No modal:
    • Conta (multi-empresa).
    • Tipo de agendamento → selecione "Com recebimento".
    • Recebimento → busque pelo número, NF ou fornecedor.
    • O sistema preenche automaticamente os dados (fornecedor, status, NF, peso, volumes, itens).
    • Título/nome → texto livre (geralmente já vem com o nome do fornecedor).
    • Data e hora de início e Data e hora de término.
    • Observações opcionais.
  3. Salvar.

O sistema:

  • Valida que o recebimento existe na empresa.
  • Verifica se o recebimento já não tem outro agendamento (se tem, bloqueia indicando a data atual).
  • Cria o agendamento.

Como criar um agendamento avulso (sem recebimento)?​

Para bloquear horário sem amarrar a um recebimento específico:

  1. Clique em Criar Agendamento (ou clique direto em uma data no calendário).
  2. No modal:
    • Conta.
    • Tipo de agendamento → selecione "Sem recebimento" (ou deixe o campo "Recebimento" vazio).
    • Título/nome → ex.: "Almoço portaria", "Treinamento equipe", "Manutenção dock 3".
    • Data e hora de início e término.
    • Observações com mais contexto.
  3. Salvar.

O agendamento entra como Não agendado (cinza) e aparece no calendário ocupando o slot.

Pode dois agendamentos no mesmo horário?​

Sim — a tela permite agendamentos simultâneos. O CD pode ter várias docas/operadores recebendo ao mesmo tempo. O limite de agendamentos por dia é controlado pela Configuração Agendamento (campo "Máximo de agendamentos por dia"); dentro do dia, o sistema não impede sobreposição.

Quando você quiser forçar exclusividade de horário (ex.: manutenção em todas as docas), crie um agendamento avulso ocupando o slot inteiro. Não impede tecnicamente outros agendamentos, mas avisa visualmente.

Pode dois agendamentos do mesmo recebimento?​

Não. Cada recebimento pode ter no máximo 1 agendamento ativo. Tentar criar um segundo agendamento para o mesmo recebimento retorna:

Recebimento já esta agendado para <data e hora>

Para remarcar, edite o agendamento existente (não crie novo). Para soltar o recebimento e criar outro, exclua o existente primeiro.

Pré-requisitos antes de criar​

ItemOnde
Configuração Agendamento ativa para o CDLogística → Configuração Agendamento
Recebimento cadastrado (quando for amarrar)Compras (XML importado ou cadastro manual)
Privilégio Criar AgendamentoConfigurações → Perfis de Acesso

Sem a Configuração Agendamento, o calendário fica sem janelas válidas e a marcação não respeita as regras (duração, antecedência, limites diários).

Como editar um agendamento?​

Duas formas:

  • Clique no cartão no calendário → popover abre → botão Editar.
  • Clique e arraste o cartão para outro horário (no IDWCalendar — funciona em algumas visões).

No modal:

  • Pode trocar Título, Data início, Data fim, Observações.
  • Pode mudar o Recebimento vinculado (desde que o novo não esteja já agendado).

Requer privilégio Editar Agendamento.

Como remarcar para outro horário?​

Mesma mecânica da edição:

  1. Clique no cartão.
  2. Editar.
  3. Ajuste Data e hora de início e Data e hora de término.
  4. Salve.

O recebimento amarrado permanece o mesmo — só o horário muda. O status pode mudar de Atrasado para Agendado se você jogou para o futuro.

Como excluir um agendamento?​

  1. Clique no cartão.
  2. Botão Excluir no popover.
  3. Confirme.

Apaga fisicamente. Não há recuperação pela tela. Se o recebimento amarrado já foi feito (status Recebido), exclua com cuidado — embora o sistema não bloqueie, perder o agendamento limita auditoria histórica.

Como exportar a agenda para Excel?​

Botão Exportar Excel no topo. Gera planilha com os agendamentos da visão atual (mês/semana/dia), incluindo título, datas, status, fornecedor, NF, peso, volumes.

Útil para:

  • Distribuir a agenda do dia/semana para a equipe.
  • Backup ou compartilhamento externo (com fornecedor, transportadora).
  • Análise mensal (quantos recebimentos por fornecedor, picos de carga).

Como imprimir a agenda?​

Botão Imprimir no topo:

  1. O sistema gera uma imagem (snapshot) do calendário visível.
  2. Abre uma nova janela com a imagem.
  3. Aciona o diálogo de impressão do navegador.

Use quando precisar afixar a agenda em quadro físico do CD ou levar para reunião offline.

Recebi "Recebimento já esta agendado para X"​

O recebimento que você tentou amarrar já está em outro agendamento. A mensagem inclui a data e hora do agendamento existente para você localizar.

Soluções:

  • Procure no calendário pelo recebimento e edite o agendamento existente.
  • Se quer trocar o recebimento, exclua o agendamento existente e crie novo.

Recebi "Data de início precisa ser menor que data de término"​

Validação trivial: data início precisa vir antes da data fim. Confira:

  • Você não inverteu os campos por engano.
  • Não está com um agendamento de duração negativa (ex.: início às 14h, fim às 13h).

O calendário não mostra horários disponíveis​

Causas possíveis:

  • Configuração Agendamento não cadastrada para o CD: vá em Logística → Configuração Agendamento e crie.
  • Quadro de horários vazio na configuração: a configuração existe mas não tem faixas marcadas em nenhum dia da semana.
  • Antecedência mínima muito alta: configuração exige 48h e você está tentando marcar para amanhã.
  • Limite diário atingido: o dia já tem o máximo de agendamentos ou de itens.

Verifique todos esses pontos na tela Configuração Agendamento do CD em questão.

Status mudou para Atrasado mas a transportadora avisou que vai chegar​

O status Atrasado é só um indicador visual — não bloqueia nada. Quando a transportadora chegar:

  • Faça check-in normalmente no recebimento (tela de Compras).
  • O cartão muda automaticamente para Recebido (verde).

Se preferir, antes de marcar Recebido, remarque o agendamento para um horário futuro (editar o cartão e ajustar Data fim). Isso devolve a cor azul "Agendado" — mas geralmente não é necessário; o importante é fazer o check-in.

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égioLibera
Visualizar AgendamentoAcessa a tela e o calendário. Sem este privilégio, o item de menu nem aparece.
Criar AgendamentoBotão Criar Agendamento habilitado e clique em data vazia do calendário.
Editar AgendamentoBotão Editar habilitado no popover do cartão.
Deletar AgendamentoBotão Excluir habilitado no popover do cartão.