Informações Gerais

Objetivo

Incidente

No ems2, havia uma parametrização no APB que controlava a implantação de documentos, de forma que só seria possível implantar um novo documento se sua data de vencimento fosse superior ao momento da operação (valor “today”) em X horas.

No TOTVS12, por se tratar de outro produto, não existe tal conceito, gerando um transtorno para os clientes que utilizavam esta validação.

Solução

A parametrização será incluída no produto, sendo feito por estabelecimento. Para isso, será incluído três campos na tabela param_estab_apb: um lógico (log_praz_impl - Prazo Implantação, default no) para indicar se a validação está ativa ou não, um inteiro (num_hora_praz_impl - Horas, default 0) que indicará quantas horas deve haver entre a implantação e a data de vencimento, e mais um lógico (log_praz_antecip_pef - Prazo Impl AN/PEF, default no) que servirá para indicar se a regra também deve ser aplicada as antecipações e pagamentos extra-fornecedor.

A validação será feita somente no momento de implantação, como já era no EMS2. Assim, se houver a necessidade, é possível alterar a data de vencimento do documento através da rotina de alteração. Para evitar alterações indevidas, deverá ser informado no APB004 – Relacionamento Usuário Contas a Pagar x Estabelecimento se o usuário tem permissão ou não para alterar a data de vencimento.

Definição da Regra de Negócio

 Salvo indicações, todas as alterações devem ser feitas observando o BF_FIN_ PRAZ_IMPL.

Apb001aa – Parâmetros Estabelecimento

Os novos campos deverão ser incluídos nas telas da rotina (tela base, inclusão, alteração, detalhe, pesquisa), Sendo que se o log_praz_impl não estiver marcado, os outros ficam desabilitados, e habilitam quando o campo é marcado.

Embora no ems2 o tempo fosse quantificado em horas, as validações eram feitas com base em dias, convertendo as horas para dia. Por conta disso, havia uma validação no campo de horas, que impedia de informar algo menor que 24. Esta validação não será replicada, visto que nesta implementação, as validações deverão ser feitas por hora, garantindo uma maior flexibilidade no pagamento.

Ex.: São 17:00 e o documento vence no mesmo dia que está sendo implantado, e a parametrização diz que deve ter 6 horas após a implantação, não irá dar erro, visto que ainda é no dia (17 + 6 = 23:00). Agora se forem 7 horas na parametrização deve barrar, pois o documento deveria ter data de vencimento de um dia após ser implantado (17 + 7 = 24 ou 00:00 do próximo dia).

Validações

Nos fontes listados abaixo, deverá ser incluída a nova validação, verificando se a data do momento (today) mais as horas indicadas na parametrização (num_hora_praz_impl) são maiores que a data de vencimento. Se for, não haverá um questionamento ou uma validação de usuário como fazia no ems2, deve apresentar mensagem de erro e abortar a operação. As horas informadas na parametrização devem considerar apenas dias úteis.

 Locais onde é possível implementar um documento, e portanto devem ser alterados:

Apb704aa – Registrar título contas a pagar

Apb900zg – API implantação título

Apb702aa – Registrar PEF

Apb701aa – Registrar antecipação

APB905zd – API implantação antecipações/PEF

Visto que os títulos são implantados em lotes, a data de atualização do lote nem sempre é a mesma da inclusão do item ao lote. Além disso, se o sistema estiver parametrizado para realizar aprovações no módulo MLA, a data de aprovação também pode ser diferente. Para resolver estes casos, é necessário adicionar a validação também no programa de funções apb739za, que é chamado nas duas rotinas na implantação de um título.

No caso de implantações de Antecipações/Pagamentos Extra-fornecedor, não há lote, sendo implantados individualmente. Porém a mesma regra relativa ao módulo MLA se aplica, sendo necessário adicionar a validação também ao programa de funções apf731za, chamado na aprovação das antecipações e Pagamentos Extra-fornecedor.

Dicionário de Dados