> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/rn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/rn/orquestrador/versoes-anteriores/versao-3.28.0.md).

# Versão 3.28.0

Versão lançada 06/10/2026

## Release Notes — Versão orquestrador 3.28

### O que é novo

* **Integração com Provedor Dharma OCR (Back-end)**: implementada a infraestrutura de suporte ao provedor Dharma para extração de dados em documentos PDF. Esta atualização inclui:
  * **Proxy de Autenticação**: centralização da chave de API no servidor, garantindo que segredos não sejam expostos nos agentes locais.
  * **Gestão de Saldo e Reserva**: novo sistema de reserva de créditos de OCR que assegura a disponibilidade de saldo no início da requisição e realiza a cobrança efetiva apenas após a conclusão bem-sucedida do processamento.
  * **Suporte a Processamento Assíncrono**: endpoints preparados para lidar com o fluxo de criação, upload direto para armazenamento seguro e consulta de status (polling) das requisições Dharma.
* **Segurança em Agendamentos Privados**: implementada uma nova camada de validação para agendamentos configurados como privados. Agora, o sistema exige obrigatoriamente a indicação de ao menos um usuário ou setor com permissão de acesso, evitando que agendamentos fiquem "órfãos" ou invisíveis na plataforma.

### Correções

* **Controle de Disparo de Agendamentos**: corrigida uma falha onde agendamentos desativados ou configurados incorretamente como privados continuavam a disparar execuções de robôs. O motor de agendamento agora respeita rigorosamente o status de ativação e as permissões de visibilidade configuradas.
* **Persistência de Permissões (ACL)**: ajuste na lógica de salvamento de agendamentos para garantir que as listas de acesso (usuários e setores) sejam validadas antes da gravação no banco de dados, prevenindo a criação de registros inconsistentes.
* **Sincronização de Horários**: corrigida a divergência entre o horário configurado no agendamento e o horário efetivo de disparo das tarefas, assegurando pontualidade nas execuções automáticas.