PRJ-6092·PRJ-6092

Solicitar Nova Análise Tributária

O módulo de Análise Tributária já tinha a lista, o detalhe por NCM e o banco de análises — mas o ponto de entrada (pedir uma análise nova) era o elo fraco. Solicitações chegavam por canais paralelos (planilha, e-mail, WhatsApp) e quase sempre incompletas: faltava tipo de operação, estado de desembaraço, destinação, Ex Tarifário, NCM detalhado.

TributárioEm andamentoAlta06 de jun. de 2026
Em resumo
VD
Victor Dias
Design Lead
Área
Tributário
Squad
Razac Team
Telas afetadas
1

Contexto

O módulo de Análise Tributária já tinha a lista de solicitações, o detalhe por NCM e o banco de análises — mas o ponto de entrada (pedir uma análise nova) era o elo fraco. As solicitações chegavam por canais paralelos (planilha, e-mail, WhatsApp) e quase sempre incompletas: faltava tipo de operação, estado de desembaraço, destinação da mercadoria, Ex Tarifário, NCM detalhado.

Resultado: o analista tributário voltava ao solicitante pra completar os dados antes mesmo de começar a análise.

Problema

Sem um formulário guiado, a solicitação não padroniza o que de fato muda a tributação:

  • Dados da operação incompletos (regime, contribuinte de ICMS, estado do cliente × estado de desembaraço, país de origem).
  • Produtos sem detalhe fiscal — cada NCM precisa de descrição, destinação, Lista CAMEX e, quando há Ex Tarifário, o EX NCM correspondente.
  • Cada ida-e-volta atrasa a análise e espalha a informação em vários lugares (sem rastro).

Hipótese

Um formulário único e guiado — Dados da Operação + N produtos (NCM), validando só os campos que realmente alteram a tributação — captura tudo que o analista precisa na primeira tentativa, reduzindo retrabalho e o tempo até a análise começar.

Solução

Tela Solicitar Análise Tributária (analise-tributaria-solicitar), publicada e navegável no portal:

  1. Banner de validade de 6 meses — reforça que análises têm prazo, evitando refazer o que ainda vale.
  2. Dados da Operação — Tipo de Operação (conta própria / por conta e ordem / encomenda), Cliente (nome + CNPJ), Contribuinte de ICMS, Estado do Cliente, Estado de Desembaraço, País de Origem e Outras Informações. Cada campo traz um helper text explicando por que ele influencia a tributação (ex.: conta própria não aplica TTD; estado define impostos de venda × nacionalização).
  3. Produtos (repetível) — NCM, Descrição da Mercadoria, Destinação (consumo / revenda / industrialização / imobilizado), Lista CAMEX, Possui Ex Tarifário?EX NCM condicional, e Regime de Importação Especial. Botões de adicionar / remover produto.
  4. Validação — exige os obrigatórios da Operação e de cada produto, e torna o EX NCM obrigatório quando o produto possui Ex Tarifário.
  5. Envio — confirma e retorna à lista de análises, onde a solicitação entra como Pendente.

Tela construída sobre o módulo do PRJ-TRIBUTARIO, fechando o fluxo: Solicitar → Lista → Detalhe por NCM → Resposta.

Outcomes

Tela construída e publicada (v1.0.0), em validação com o time tributário. Métricas de completude na 1ª tentativa e tempo até início da análise a coletar pós-rollout.

Documentação criada a partir da tela já implementada — alinhar Contexto/Problema e métricas finais com o conteúdo dos cards PRJ-6092 e PRJ-6093 quando o Jira estiver acessível.