Correspondências

Registrada por foto, entregue com prova

É o módulo central do Zelus, e ele cobre o objeto inteiro: a foto da etiqueta no balcão, a leitura automática que aponta a unidade, o aviso ao morador, a retirada identificada e o histórico que responde por ela depois.

O problema

O que se perde entre o balcão e o armário

Uma encomenda passa por várias mãos antes de chegar ao morador. Sem um registro único, cada passagem é uma chance de erro — e o erro só aparece quando alguém cobra.

  • A mesma encomenda entra duas vezes

    Troca de turno, retrabalho, dois cadernos abertos ao mesmo tempo. A mesma caixa é registrada de novo, e o controle passa a listar um item que não existe no armário.

  • A etiqueta de devolução engana quem cadastra

    Em etiquetas de devolução os endereços vêm invertidos: o remetente aparece no lugar do destinatário. Quem copia a etiqueta como ela está manda a encomenda para a unidade errada.

  • A encomenda fica semanas parada

    Sem prazo definido e sem visibilidade do que já foi retirado, o armário lota. Ninguém consegue dizer o que está guardado ali há mais tempo, nem de quem é.

Cadastro

O registro começa por uma foto

O que dá para ler da etiqueta, o sistema lê. O que exige julgamento, o operador confirma. Nenhum passo depende de digitar aquilo que já está escrito na caixa.

  1. Fotografe a etiqueta

    A foto é a entrada do fluxo. Antes de enviar, o próprio celular avalia a qualidade da imagem e sugere refazer quando a nitidez não ajuda — evita gastar leitura com uma foto ilegível. O detalhe da captura no celular fica na página do app da portaria.

  2. A leitura propõe destinatário e unidade

    Os dados extraídos da etiqueta são comparados com o cadastro do condomínio, com desempate por bloco ou torre. A unidade de destino chega sugerida na tela, junto com o caminho da estrutura — "Bloco A › Andar 1", por exemplo.

  3. O operador confere e registra

    Num painel único, ele revisa destinatário, código de rastreio, remetente e observação, e escolhe unidade, local de guarda e morador. Ao salvar, a encomenda recebe o número de entrada do condomínio e o aviso ao morador é disparado.

Duas checagens acontecem sem que ninguém precise pedir: o código de rastreio é comparado com o que já está na base, para a mesma encomenda não entrar duas vezes, e o número de entrada é gerado no servidor de forma atômica — dois porteiros registrando ao mesmo tempo recebem números diferentes.

O aviso ao morador nasce aqui, mas para por aqui: o canal — hoje o WhatsApp —, os modelos de mensagem e o acompanhamento de cada envio são assunto do módulo de comunicados. A ergonomia do balcão — enquadramento, lanterna, modo manual — é assunto do app da portaria.

Ver como os avisos são enviados Ver o app que o porteiro usa

Leitura automática

A inteligência artificial lê — e mostra o quanto confia

A etiqueta é lida por um modelo de visão. Um modelo acerta muito e erra às vezes, e o produto é desenhado em torno desse fato, não contra ele: toda leitura chega ao operador com o grau de confiança declarado e com os problemas que o próprio modelo encontrou. A conferência humana não é um remendo — é o desenho.

  • Grau de confiança sempre visível — cada leitura vem com um valor de 0 a 100 e um selo colorido: verde a partir de 75, amarelo a partir de 40, vermelho abaixo disso. É a confiança que o modelo declara naquela leitura — um sinal para o operador olhar com mais atenção, não uma taxa de acerto do sistema.
  • Revisão humana em toda leitura — os campos chegam preenchidos e editáveis, e nada é gravado sem passar pela conferência. O preenchimento manual está sempre disponível: por escolha de quem opera, ou automaticamente, quando a leitura não devolve dado útil. O fluxo nunca trava por causa da imagem.
  • Cerca de 40 campos extraídos da etiqueta — destinatário, remetente, endereço estruturado (bloco, torre, apartamento, sala, andar), transportadora, tipo de objeto, código de rastreio e dados de nota fiscal.
  • O condomínio entra como contexto da leitura — nome, endereço, cidade e CEP do condomínio seguem junto com a imagem, para o modelo distinguir quem é destinatário e quem é remetente. É o que resolve a etiqueta de devolução, em que os dois vêm trocados.
  • Duas fases, para a fila da portaria não esperar — no balcão roda a leitura enxuta, só o necessário para registrar a encomenda. A extração completa dos dados fiscais é uma rotina de madrugada, agendada para as 03:00, e vem desligada por padrão.
  • A imagem pode não sair da sua infraestrutura — os provedores de leitura são cadastrados em ordem de preferência, com troca automática quando um falha. Além do provedor em nuvem, o sistema aceita modelo hospedado no servidor do próprio cliente.

Ciclo de vida

Cada situação da encomenda é uma transição validada

A encomenda não muda de situação porque alguém marcou uma caixinha na tela. Cada passagem é validada no servidor — não dá para pular etapa nem voltar no tempo — e cada mudança relevante grava um evento.

  1. Aguardando leitura

    A foto da etiqueta foi enviada e a leitura automática ainda está em processamento.

  2. Aguardando conferência

    Os dados voltaram do modelo e esperam a revisão do operador, que confirma a unidade de destino numa etapa própria.

  3. Aguardando retirada

    A encomenda está registrada, com número de entrada do condomínio, local de guarda definido e prazo correndo.

  4. Morador avisado

    A notificação foi disparada para os responsáveis pela unidade marcados para receber aviso, e o resultado real do envio volta para a portaria.

  5. Entregue

    A retirada foi confirmada e registrada: quem levou, quando e por qual via.

Duas saídas alternativas encerram o ciclo sem entrega — devolvida ao remetente e cancelada. As duas exigem registro, e nenhuma apaga o que já aconteceu: o histórico da encomenda continua inteiro.

  • 10 tipos de evento gravados na trilha de cada encomenda, da criação à retirada
  • ~40 campos que a leitura extrai da etiqueta, com grau de confiança declarado
  • 7 dias prazo padrão para o morador retirar, ajustável por condomínio
  • 4 tipos de retirante registrados: morador, terceiro, entregador e funcionário

Caixa de entrada

O que está em aberto, à vista de quem responde

Síndico e administrativo não precisam ligar para a portaria para saber o que está guardado. A lista de encomendas aguardando retirada é a mesma para quem opera no balcão e para quem acompanha pelo painel.

Busca e filtros na lista

Busca por unidade, nome, código de rastreio ou remetente, filtro por unidade e alternância entre lista e grade. A ordenação é natural: a unidade 2 vem antes da 10, que vem antes da 201.

Detalhe com a linha do tempo

Cada encomenda abre com unidade, destinatário, há quanto tempo chegou, código de rastreio, remetente e a sequência do que já aconteceu com ela até ali.

Prazo e pendências por unidade

O condomínio define em quantos dias a encomenda deve ser retirada — o padrão são sete. Depois de cada retirada, o sistema informa se ainda restam itens pendentes naquela unidade.

No painel web, os mesmos dados alimentam os indicadores de a confirmar e aguardando retirada; no app, dois cartões na tela inicial levam direto à lista de pendências e ao histórico do dia.

Retirada

Quem retira é identificado antes de levar

A entrega é o momento em que o condomínio assume um risco. Por isso a retirada não é um botão de "entregue": é o registro de quem levou, por qual via e com qual comprovação.

Morador cadastrado

Escolhe-se o responsável na lista da unidade, e ele confirma informando os cinco últimos dígitos do próprio celular. O código é conferido no app contra o telefone cadastrado: não é enviado por mensagem, é um dado que o morador sabe de cor e que o operador do balcão não tem como adivinhar.

Terceiro autorizado

Nome e documento são obrigatórios, com foto do documento opcional. O documento é guardado apenas como hash e exibido mascarado na tela — e a própria interface avisa isso a quem está operando.

Retirada em lote

Quando a unidade tem várias encomendas, todas saem de uma vez. A primeira seleção trava a unidade e desabilita as demais, para não misturar moradores no mesmo lote, e o resultado volta item a item: quantas foram confirmadas e quantas não.

Alguns condomínios não liberam encomenda para terceiro. Essa regra é aplicada no servidor, não escondendo um botão na tela: o servidor recusa a operação e nada é gravado — sem registro, sem evento, sem mudança de situação. A checagem olha o vínculo efetivo de quem está retirando, e, se a regra não estiver configurada, o sistema bloqueia. Ausência de informação nunca vira permissão.

A confirmação por código é a primeira fase, deliberada, de um roadmap de métodos de confirmação: começar por um método que não depende de a mensagem chegar. Em desenvolvimento, código enviado por mensagem e assinatura em tablet — nenhum dos dois está no fluxo de hoje.

Prova

Depois da entrega, a resposta continua no sistema

O valor não está no método de confirmação: está no registro que sobra dele. Quando um morador diz que não recebeu, a resposta não depende da memória de ninguém.

  • Comprovante da retirada — ao fim da entrega, a tela lista o que saiu: código de rastreio, destinatário, quem retirou, local de guarda e data e hora. Na retirada em lote, todos os itens aparecem no mesmo comprovante.
  • Histórico com filtros e busca — as retiradas já feitas ficam consultáveis por período (hoje, ontem, últimos três dias ou data específica) e por unidade, com busca textual que alcança inclusive o nome de quem retirou.
  • Linha do tempo do objeto — o detalhe de cada encomenda mostra a sequência inteira: criada, foto enviada, leitura processada, unidade sugerida, unidade confirmada, detalhes atualizados, aviso enviado, retirada confirmada.
  • Documento de quem retira, protegido — guardado apenas como hash e exibido mascarado. A foto do documento é opcional e segue as mesmas regras dos demais arquivos.
  • Arquivos só por link temporário — a foto da etiqueta e o comprovante ficam em armazenamento com acesso por link assinado que expira. O banco guarda a referência, nunca um endereço público permanente.
  • O que a leitura extraiu não circula — o resultado completo da etiqueta, que pode conter documento, telefone e endereço do destinatário, é armazenado e nunca devolvido pela API. Os registros de uso da leitura automática não contêm dado pessoal.

Por quanto tempo o histórico e os arquivos ficam guardados é definido pela política de retenção do cliente, no módulo de LGPD: {{PRAZO_RETENCAO_HISTORICO}}.

Como tratamos os dados dos moradores

Configuração

Cada condomínio com as suas regras

O módulo é o mesmo para todos, mas quase nada é fixo. As configurações vivem em duas camadas — um padrão global e a exceção do condomínio — e valem no servidor, não apenas na tela.

  • Onde a numeração começa — o condomínio escolhe o número inicial das correspondências. A numeração é contínua, sem reinício anual, dimensionada para o volume real de cerca de 3.000 correspondências por mês.
  • Prazo de retirada — sete dias por padrão, ajustável em cada condomínio.
  • Campos obrigatórios do cadastro — foto, local de guarda, destinatário, entregador, transportadora, código de rastreio e remetente podem ser exigidos ou não. O padrão exige apenas a unidade de destino.
  • Locais de guarda tipados — prateleira, armário, bancada, sala. Os locais pertencem ao condomínio; ao escolher a unidade de destino, o app já mostra apenas os daquele condomínio, agrupados por tipo.
  • Liberação para terceiros — ligada ou desligada por condomínio, com efeito no servidor e bloqueio quando a regra não está configurada.

Na interface, desabilitar uma configuração e resetá-la para o padrão são ações diferentes de propósito: resetar apaga a customização, desabilitar preserva o valor para quando o condomínio quiser reativá-lo.

Veja o módulo rodando com as encomendas do seu condomínio

Mostramos o caminho completo usando a estrutura real do seu condomínio: da foto da etiqueta no balcão ao comprovante de quem levou.

Solicitar demonstração

Sem compromisso. Respondemos em até um dia útil.