Liberar a análise de XMLs e a ativação de regras na implantação para quem não é administrador

Na etapa de tributação da jornada de implantação, o sistema lê os XMLs das notas, grava as regras sugeridas como rascunho e, depois, ativa as regras que você aprovar. Essas gravações respeitam a permissão do usuário nos cadastros de regras de tributação. Quem é administrador não percebe diferença; quem não é precisa receber as permissões descritas aqui.

Antes de começar

• Você precisa de acesso para dar permissões no controle de acesso dos usuários.
• Saiba qual usuário vai conduzir a etapa de tributação e se ele também vai ativar as regras.

1. Confira a permissão de entrada na jornada

A entrada na jornada continua exigindo só a permissão de consultar na tela ONBOARDING (ou ser administrador). Sem ela, a mensagem é “Permissão negada para o onboarding.”.

Essa permissão não basta para gravar. A escrita nas tabelas oficiais é conferida à parte, a cada gravação, pela permissão de incluir ou alterar da tabela envolvida.

2. Dê as permissões da tributação

No controle de acesso do usuário que não é administrador, conceda:

Para fazer	Permissão necessária
Analisar os XMLs	Incluir em TBLTRB (regras de tributação) e em TBLTRBIMP (tributos da regra)
Ativar as regras	Alterar em TBLTRB

Quem vai analisar e também ativar precisa das três. O administrador dispensa a consulta: passa sem precisar de nenhuma delas.

3. Analise os XMLs

Envie os XMLs e peça a análise. Antes de agendar a análise, o sistema confere, nesta ordem:

1. se há ao menos um XML enviado; se não houver, responde “Envie ao menos um XML antes de analisar.”;
2. se o usuário pode incluir em TBLTRB e em TBLTRBIMP.

Sem a permissão, a análise nem começa: a resposta de que ela está em processamento não é dada, e a recusa chega na hora, não como erro de uma etapa que já estava rodando. A mensagem é:

Sem permissão para incluir registros na tabela TBLTRB.

ou, se for a outra tabela, a mesma frase com TBLTRBIMP. A recusa vem com o status 403 e o código ONBOARDING_SEM_PERMISSAO_TABELA; o código serve para o suporte, e o texto já diz o que falta.

A conferência é repetida quando a análise vai gravar os rascunhos, antes de abrir a gravação. Assim, uma recusa nunca deixa registro pela metade.

Os rascunhos que a análise grava nascem inativos.

4. Ative as regras

Para ativar, o usuário precisa poder alterar TBLTRB, porque ligar uma regra é alterar uma linha que já existe. Sem a permissão, a recusa usa o mesmo formato:

Sem permissão para alterar registros na tabela TBLTRB.

A conferência só acontece quando há ao menos uma regra válida para ativar.

A ativação só liga regras criadas por esta execução da implantação, reconhecidas pelo carimbo que o sistema deixa no campo OBSERVACAO da regra. Ela nunca apaga nem sobrescreve uma regra.

O que não mudou

• Enviar e remover XMLs não passam pela conferência de permissão nas tabelas de regras.
• A remoção de um XML continua recusada quando já existe regra ativada: “Há regra desta implantação já ativa; o XML de evidência não pode mais ser removido.”

Problemas comuns

“Sem permissão para incluir registros na tabela TBLTRB.” (ou TBLTRBIMP) ao analisar. O usuário não pode incluir naquela tabela. Dê a permissão de incluir em TBLTRB e em TBLTRBIMP no controle de acesso e peça a análise de novo. Nada foi gravado na tentativa recusada.

“Sem permissão para alterar registros na tabela TBLTRB.” ao ativar. Dê a permissão de alterar em TBLTRB. Os rascunhos da análise continuam inativos até a ativação.

“Permissão negada para o onboarding.” O usuário não tem a permissão de consultar a tela ONBOARDING. Veja entrar na implantação.

Para manter depois as regras já ativadas, veja cadastrar uma regra de tributação.