Processo indenizatório
Fluxo completo de solicitação, análise, rateio por filiais, pagamento e comprovante vinculado ao CTRC.
Contexto
Indenizações de carga costumam envolver várias áreas da transportadora — filiais, operação e financeiro — com trocas manuais de informação, planilhas e registros dispersos no CTRC. Isso atrasa o andamento, dificulta o acompanhamento e aumenta o risco de falhas de comunicação entre quem solicita, quem analisa e quem executa o pagamento.
O processo indenizatório do TurboTMS padroniza esse fluxo diretamente no SSW: solicitação, análise, rateio por filial, pagamento e comprovante que ficam vinculados ao CTRC, com visibilidade para todas as partes envolvidas.
Permissões e habilitação
Habilitação no Painel ADM
A funcionalidade precisa ser habilitada no Painel ADM do TurboTMS para a transportadora, e as permissões por grupos de usuários são definidas em conjunto com a nossa equipe de suporte.
Para esta funcionalidade, as permissões disponíveis e o comportamento esperado no SSW são:
- Solicitar processo : abre o fluxo de nova solicitação e permite reenvio após reprovação. Permite cancelar a própria solicitação enquanto estiver em análise. Usuários solicitantes devem possuir acesso à opção 101 do SSW e permissão para emitir instruções.
- Analisar e operar pagamento : reprova ou dá continuidade à análise, define responsabilidades por unidade, aprova ou reprova o rateio na filial do usuário, acessa os painéis de acompanhamento e o fluxo de pagamento/comprovante nas opções 475 e 506 do SSW. Usuários revisores devem possuir acesso às opções 101, 475 e 506 do SSW, para emitir instruções, despesas e indenizações.
Se nenhuma das duas permissões estiver ativa, o TurboTMS não injeta botões nem tabelas relacionadas ao processo indenizatório.
Usuário TurboTMS cadastrado no SSW
É necessário um usuário dedicado do TurboTMS cadastrado diretamente no SSW, utilizado pela extensão para operações que dependem de credenciais próprias.
Para esta funcionalidade, este usuário precisa dos seguintes acessos no SSW:
- Permissão para visualizar todas as unidades no menu de unidades
Visão geral do fluxo
Fluxograma do processo indenizatórioVisão detalhada de cada etapa, decisões e ramificações de status.- Na tela do CTRC (opção 101), o solicitante abre o painel de processos indenizatórios e envia os dados da indenização (com anexos).
- O processo entra em análise. Um revisor pode reprovar (com motivo), cancelar a solicitação em casos específicos, ou seguir para definir responsabilidades por filial e departamento (percentuais que somam 100%).
- Cada filial envolvida precisa aprovar ou reprovar sua linha de responsabilidade. Uma reprovação de filial pode exigir novo ciclo de definição de responsabilidades.
- Após as aprovações, o processo segue para aguardando pagamento. O financeiro utiliza as telas do SSW (475 e 506) apoiadas pela extensão para registrar o pagamento.
- Em seguida o status passa a aguardando comprovante. Quem tem permissão de revisão envia o comprovante e observação pelo painel da opção 506; o processo é concluído como finalizado.
Em pontos importantes (criação, reprovação, aprovações, pagamento e finalização), a extensão também registra uma ocorrência no CTRC quando isso é possível no SSW, mantendo rastro no próprio documento.
Etapa 1 — Iniciar na tela do CTRC (opção 101)
Com permissão adequada, aparece o botão flutuante “Processo indenizatório” na página do CTRC. Ao clicar, o TurboTMS consulta na API se já existe processo para o CTRC aberto:
- Se não existir e você puder solicitar: abre o painel de nova solicitação.
- Se já existir: a tela exibida corresponde ao status atual (análise, responsabilidades, reprovado, aguardando pagamento/comprovante ou finalizado).
Etapa 2 — Nova solicitação
A janela “PI - Solicitar indenização” mostra um cartão com dados lidos da tela do CTRC (CTRC, datas, frete, nota fiscal, filiais etc.) e um bloco “Solicitação” para preenchimento:
- Favorecido e CNPJ do favorecido
- Valor indenizado (obrigatório)
- Forma de pagamento: Dinheiro, Pix ou Transferência
- Observação (obrigatória)
- Anexos da solicitação
O botão “Solicitar” envia os dados, realiza o upload dos anexos e, em caso de sucesso, fecha o painel. Se a solicitação anterior foi reprovada e você tem permissão de solicitar, um fluxo semelhante permite reenviar uma nova análise.
Etapa 3 — Análise da solicitação (revisor)
Enquanto o status é “Em análise”, quem tem permissão de revisão vê a tela “PI - Análise de solicitação de indenização” com o resumo da solicitação e dados do CTRC.
- Reprovar: abre campo obrigatório de motivo e confirmação; o processo vai para status reprovado.
- Continuar para aprovação: carrega a lista de unidades válidas da transportadora e abre o próximo passo para montar a tabela de responsabilidades.
- Cancelar solicitação (apenas para quem criou o processo, enquanto ainda está em análise): encerra como cancelado.
Etapa 4 — Definir responsabilidades
No passo seguinte, o revisor distribui o valor da indenização entre linhas de unidade (filial), departamento e percentual. As regras da interface exigem linhas completas e soma de percentuais igual a 100%, sem unidades inválidas ou duplicadas. É possível informar uma justificativa opcional.
Em caso de reprovação de responsabilidade, a tela pode exibir o quadro do ciclo anterior e o motivo, para facilitar o ajuste e o reenvio das responsabilidades.
Ao confirmar com “Aprovar indenização”, as linhas são gravadas e o processo passa a aguardar aprovação das filiais.
Etapa 5 — Aprovação na filial em uso
Na janela “PI - Aprovação de responsabilidade”, a extensão identifica a filial atual do usuário e destaca a linha de responsabilidade correspondente. Quem tem permissão de revisão e ainda não aprovou essa linha pode aprovar ou reprovar (neste caso, com motivo obrigatório). Usuários sem permissão de aprovação e usuários de outras filiais veem apenas o resumo, sem botões de ação.
Etapa 6 — Painéis de acompanhamento (opção 101 e 506)
Para visão consolidada fora do CTRC:
- No início da opção 101 , quem solicita vê processos abertos criados por si. Quem revisa vê todos os processos não cancelados e, quando há filial atual, uma tabela de processos aguardando aprovação da sua filial. Clicar no CTRC preenche a busca e aciona a pesquisa.
- Na opção 506, quem revisa vê duas tabelas: processos aguardando pagamento e aguardando comprovante, com paginação e ação de copiar dados. Para pagamento, o número do CTRC funciona como atalho que grava o contexto no navegador e abre a opção 475 para o lançamento.
Etapa 7 — Pagamento no SSW (opção 475)
Ao abrir a opção 475 a partir da tabela de “Aguardando pagamento”, a extensão preenche campos do lançamento com base no processo selecionado. O usuário pode conferir os dados e lançar a despesa no SSW.
Etapa 8 — Lançamento de indenização e comprovante (opção 506)
Na opção 506, com o número da despesa obtido no passo anterior, a extensão preenche valores e textos padrão da indenização, aguarda a autorização do usuário, atualiza o processo para aguardando comprovante e limpa o armazenamento temporário.
De volta à tabela de “aguardando comprovante”, a ação “Enviar comprovante” abre um formulário para anexar arquivos e preencher observação de finalização obrigatória. Ao concluir, o status vira finalizado. Na tela do CTRC, o botão do processo indenizatório passa a exibir apenas leitura do histórico e anexos conforme o caso.
