Cross Segmentos - TOTVS Backoffice (Linha Protheus) - SIGAFIN - Falha no processamento de Retorno CNAB via Schedule com arquivo em diretório local (C:) raiíz

[Remover as instruções entre colchetes e altere o tempo aproximado para leitura]

Tempo aproximado para leitura: HH:MM:SS min

Dúvida
Ao efetuar um retorno CNAB via Schedule (utilizando rotinas como FINA205, FINA435, ou Automáticas), os títulos não são baixados mesmo com os parâmetros de diretório (EE_DIRPAG / EE_DIRREC e EE_BKPPAG / EE_BKPREC) apontando para o caminho do arquivo (exemplo: C:\CNAB\). 

Por que o processamento não ocorre?

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - SIGAFIN - Todas as versões

Solução
O incidente ocorre porque o processamento via Schedule (Job) é executado diretamente pelo serviço do servidor (AppServer), e não pelo cliente local (SmartClient).

Quando uma rotina é agendada via Schedule, o serviço do Protheus busca os arquivos baseando-se na estrutura de diretórios do servidor onde o serviço está rodando (RootPath), e não no disco local (C:\) da estação de trabalho do usuário que criou o agendamento

Para corrigir o processamento, siga as diretrizes abaixo:

Localização do Arquivo: O arquivo de retorno CNAB deve ser salvo obrigatoriamente dentro da estrutura de pastas do servidor (dentro do RootPath configurado no appserver.ini ou diretório mapeado acessível pelo serviço do Protheus).

Configuração do Caminho: 

Nos parâmetros do CNAB (Tabela SEE - Campos EE_DIRPAG / EE_DIRREC) ou na configuração da rotina, informe o caminho relativo ou absoluto considerando a visão do Servidor, e não a unidade de disco local.

Incorreto para Schedule: C:\cnab\retorno\

Correto para Schedule: \cnab\retorno\ (Considerando que a pasta cnab está na raiz do Protheus Data).

Importante: 

A utilização de caminhos locais (como C:\) funciona apenas quando a rotina é executada manualmente via menu (interface), pois neste cenário o sistema utiliza o acesso do Client.

Exceções: 

A única exceção a esta regra aplica-se caso exista uma documentação oficial no TDN (Totvs Developer Network) afirmando explicitamente que uma rotina específica (X) possui tratamento diferenciado para buscar arquivos locais c:\ mesmo quando executada via Schedule. 

Caso não haja essa documentação explícita para a rotina em questão, deve-se seguir o padrão de alocar o arquivo no servidor.

Saiba Mais
Para mais detalhes sobre a configuração de jobs e diretórios no Protheus, consulte:

TDN - CNAB (Modelo 2)

TDN - Schedule Protheus

KCS - Ao rodar o retorno do CNAB via Job Schedule não executa as baixas dos títulos