Entender as travas de negócio que recusam uma gravação

Uma trava é uma regra que só faz uma coisa: recusar uma gravação que o negócio não permite. “Não é permitido usar parceiro inativo.” e “Produto inativo não pode ser usado.” são mensagens de trava. A gravação não acontece, e a mensagem diz o motivo.

O Kryia One já vem com dezenas de travas, e elas valem em todo caminho de gravação: pelo cadastro, pelas ações do usuário, pelos portais e pelos serviços de baixa, estorno, faturamento e inventário.

De quem são as travas nativas

As travas nativas são do produto. No ambiente do cliente elas aparecem entre as regras gerais e as regras de negócio, no assistente Avançado da Administração do Sistema, mas o cliente não as altera nem as apaga: um registro do produto é recusado com “Registro KRYIA não pode ser modificado.” O que o cliente cria nesse assistente é complementar, e fica à parte.

A mensagem de cada trava é o texto cadastrado nela. Se uma gravação for recusada, leia a mensagem: é ela, e não o nome interno da trava, que diz o que corrigir.

O que as travas recusam

A tabela traz os grupos e exemplos do catálogo nativo.

Grupo	O que é recusado
Cadastro inativo ou sintético	Usar parceiro, produto, local de estoque, operação, tipo de negociação, vendedor, conta, tipo de título, tabela de preço, regra de tributação ou contato que esteja inativo. Usar natureza, centro de resultado ou grupo de produto que seja sintético (não analítico) ou inativo.
Documento	Excluir documento efetivado; efetivar documento sem itens, sem parceiro ou sem vendedor quando a operação os exige, ou com operação ou negociação inativa; vencimento anterior à data de negociação; item com quantidade zero ou negativa, valor negativo ou desconto acima do máximo do produto; documento fiscal já autorizado alterado à mão; mudar a etapa, a etapa operacional ou a situação fora das ações do portal (“A etapa e a situação do documento só mudam pelas ações do portal (avançar, aprovar, efetivar, cancelar).”). Na tela genérica de documentos, esses três campos são só para leitura.
Estoque, custo e fiscal	Alterar ou apagar à mão movimento de estoque (inclusive marcá-lo como estornado), saldo (quantidade, reserva e custo), custo e imposto apurado; inventário encerrado ou apurado; operação que gera nota fiscal sem modelo fiscal.
Produção, logística, compras e contratos	Alterar ordem de produção concluída ou cancelada, ficha técnica encerrada, carga entregue ou cancelada, cotação decidida ou cancelada, solicitação atendida ou recusada, contrato encerrado ou cancelado, meta encerrada. Vigência com fim antes do início. Preço negativo, desconto máximo fora de 0 a 100, percentual de parcela fora de 0 a 100 e limite de crédito negativo.
Financeiro	Alterar ou excluir título baixado ou gerado por documento; mudar a baixa do título (datas, valores, situação e saldo) fora das ações do Financeiro — baixar, estornar, renegociar; título com valor zero ou negativo; movimento bancário conciliado ou ligado a um título; rateio com percentual inválido.

“À mão” quer dizer pela tela ou por uma ação do usuário. O próprio sistema grava movimento, custo e saldo quando um documento é efetivado, e isso não é barrado.

Editar um documento já efetivado

Onde a operação permite editar o documento depois de efetivado, a edição de itens e valores tem as suas próprias recusas, e cada uma diz o que fazer:

Situação do documento	O que o sistema diz
A operação já moveu estoque ou realizou o financeiro	“… já moveu estoque ou realizou o financeiro — o caminho é a devolução, não a edição.”
Algum título já foi baixado	“Este documento já tem título baixado — a edição não alcança um pagamento já realizado.”
Já há título firme, fora de provisão	“… já tem título firme (fora de provisão) — o financeiro já foi realizado, e a edição não alcança um compromisso assumido.”
Um título em provisão tem rateio	“Um título em provisão deste documento tem rateio, e a edição recria o título. Remova o rateio do título no financeiro e edite de novo.”
Um título em provisão tem anexo	A mesma mensagem, com “anexo”: a edição recria o título, e o anexo ficaria preso ao título antigo.
O documento nasceu de outro, ou já gerou outro	A origem ou o derivado ficaria sem o vínculo: edite pela devolução.

O rateio e o anexo se removem do título no financeiro, em Contas a Pagar e Receber; depois, edite o documento de novo. Para a recusa por nota fiscal, veja editar um documento que tem nota.

Quando a edição passa, o sistema recalcula os impostos sobre os itens novos e refaz o título com o mesmo total da efetivação: os itens, mais IPI, ICMS-ST e FCP-ST, mais o frete cobrado na nota — conforme as opções da operação —, e, com ISS retido pelo tomador, o título é o valor líquido.

As ações também respeitam as travas

Uma ação do usuário que altera, exclui, inclui ou inclui em lote passa pelas mesmas travas do cadastro, antes de gravar. O mesmo vale para a operação ORCHESTRATE_RECORD, em todos os caminhos dela. Se uma trava recusa:

• a mensagem da trava aparece e nada daquela operação é gravado;
• com a operação configurada para parar no erro, que é o padrão, a ação inteira é desfeita;
• numa operação repetida para cada item de uma lista, um item recusado desfaz a operação inteira, e não é mais pulado em silêncio.

A trava avalia o registro como ele está gravado, mesmo quando a ação o encontra por um código escrito de outro jeito, como “050” no lugar de 50. Travas marcadas para valer só na edição manual continuam valendo para ações de usuário.

Quando uma ação é recusada e você não sabe por quê, veja Resolver uma ação programada que foi recusada.

Problemas comuns

Uma ação funcionava e agora é recusada. Antes, a operação ORCHESTRATE_RECORD gravava sem consultar as travas da tabela. Hoje ela as consulta, como o cadastro. A mensagem mostra qual trava recusou.

Preciso mudar um registro que a trava recusa. Desfaça pelo caminho do negócio: siga o que a mensagem pede, como estornar a baixa ou cancelar o documento. A trava não se desliga no ambiente do cliente.