1. Visão geral do fluxo

O fluxo Migração de Consumidores Varejista - OFICIAL (código CMV, descrição "Gerenciamento simplificado da migração") organiza, em um quadro de cards, todo o caminho de uma Unidade Consumidora (UC) que passa a ser representada por um novo varejista: validação do CCV, envio da migração à CCEE via API (CP28), recebimento do retorno e encerramento do processo.

Cada UC migrada é um card. O card percorre as etapas do fluxo, e a maior parte das passagens é feita por automações de integração com a CCEE e com os módulos Jurídico e CRM do Thunders.

1.1 Para que serve

• Centralizar as migrações varejistas em um único quadro, com responsável, prazo e histórico por UC.
• Enviar a Nova Migração Varejista à CCEE sem digitar na tela da CCEE, usando as APIs do CP28.
• Atualizar o status do card automaticamente quando a CCEE responde (aprovada ou reprovada).
• Dar visibilidade a prazos: cards a vencer, vencidos e com falha de integração.

1.2 Quem usa

1.3 Contexto regulatório (resumo)

A migração acontece dentro do modelo simplificado do Submódulo 1.8 (vigência 01/07/2025). Os pontos que mais afetam a operação do fluxo são:

• O novo varejista só consegue concluir a migração se tiver o CCV (Contrato de Compra e Venda de Energia) válido com o consumidor. Por isso a primeira etapa do fluxo é a validação do CCV.
• Os prazos da CCEE são contados em dias úteis antes/depois do mês de referência (M-12du). O fluxo traz o campo Mês de Referência e usa-o como base do prazo da etapa de validação.
• O encerramento do contrato com o varejista anterior tem regras próprias: resilição (encerramento sem inadimplemento, aviso de 90 dias, dispensável em comum acordo) e resolução (por inadimplemento, aviso de 15 dias). O treinamento "OFICIAL - Solicitar Troca de Representante" detalha o uso desses tipos de solicitação.
• As UCs migradas via API devem usar o conjunto de APIs correto para o tipo de operação; em caso de dúvida, consulte o Suporte antes de enviar.

Atenção

Este fluxo é produtivo e envia dados reais à CCEE. Preencha somente UCs com contrato confirmado e documentos conferidos.

2. Pré-requisitos

2.1 Acessos e grupos

• Usuário com acesso ao módulo Global > Fluxos.
• Usuário vinculado a um Grupo responsável que tenha permissão no fluxo (Backoffice e/ou Gestão). A permissão é definida em Configurações do fluxo (ícone de engrenagem), por grupo: Admin, Iniciar fluxo, Visualizar e Padrão.
• Em Filtros de acesso, o usuário deve estar associado às empresas (varejistas) que poderá enxergar. Sem isso, o quadro aparece vazio ou com a mensagem de filtros padrão.

2.2 Credenciais da integração CCEE

As automações usam as APIs da CCEE (CP28). Para funcionarem, o administrador precisa ter cadastrado e vinculado a credencial em Global > Painel de Controle > Integrações > Integrações CCEE > Credenciais API, informando ClientId e ClientSecret da CCEE e associando a integração à credencial. Sem credencial válida, a automação falha e o card exibe o ícone de alerta com o botão Tentar novamente.

2.3 Dados necessários antes de abrir o card

3. Como o fluxo é configurado (visão do administrador)

Caminho: Global > Fluxos > Configurações > Fluxos, ícone de lápis na linha do fluxo. A tela Configuração de fluxo mostra, à esquerda, as etapas na ordem em que os cards avançam e, à direita, as abas da etapa selecionada.

Importante

Os botões Salvar etapa e os ícones de lixeira alteram o fluxo em produção. Faça alterações somente se for administrador e depois de combinar com a equipe. Cada etapa precisa ser salva individualmente.

3.1 Mapa das etapas

3.2 Configurações gerais do fluxo (engrenagem)

O ícone de engrenagem ao lado do nome do fluxo abre Configurações de fluxo, com Nome, Descrição, Código (CMV) e a tabela Permissões de acesso por grupo (Admin, Iniciar fluxo, Visualizar, Padrão) e o botão de configuração por etapa. O ícone de olho com risco/aberto alterna a exibição dos detalhes (prazos e grupos) nas etapas.

3.3 Etapa Início – campos e automação

Na etapa Início só existem as abas Campos p/ preencher e Automações. Os campos abaixo são exibidos no formulário Novo item:

Na aba Automações do Início há uma automação do tipo Outros: Integração com Módulo CRM > Receber dados ativo físico de carga, que traz para o card os dados do ativo físico cadastrados no CRM.

3.4 Etapa Validar CCV

Grupo responsável: Backoffice. Tipo de etapa: Integração. Prazo: relativo a campo de data – o campo Mês de Referência, com 5 dias úteis antes do início do mês. Na aba Campos p/ preencher não há campos adicionais.

Automação (grupo Atualizar Informação): Módulo Jurídico > Atualização CCV Assinado. Quando o Módulo Jurídico registra o CCV como assinado, o card é atualizado e pode avançar.

3.5 Etapa Enviar para a CCEE

Grupo: Gestão. Tipo: Integração. Prazo: 2 dias úteis a partir da entrada na etapa.

Automações:

• Entrar – Integração Cadastro e Migração - Geral > Nova Migração Varejista: assim que o card entra na etapa, o Thunders chama a API da CCEE e envia a migração.
• Sair – E-mail "Envio de e-mail baseado em um evento": ao sair da etapa, o e-mail configurado é disparado (por exemplo, para o e-mail da UC).

3.6 Etapa Obter Retorno da CCEE

Grupo: Gestão. Tipo: Integração. Prazo: 10 dias úteis a partir da entrada.

• Atualizar Informação – Integração Receber atualização de status da migração: grava no card o Id da Solicitação, o status e demais retornos (comentário da distribuidora, MUSD, DHC, submercado, código da supridora).
• Outros – Automação de Fluxo com a condição REPROVADA: se a CCEE reprovar, o card é redirecionado automaticamente para a etapa Reprovado.

3.7 Etapas Finalizados, Reprovado e CANCELADOS

• Finalizados (etapa final): apenas Nome e Ocultar cards após 30 dias.
• Reprovado (etapa interna, grupo Gestão, 5 dias úteis): recebe as migrações reprovadas. Não há automações; a tratativa é manual (corrigir dados e reenviar, ou cancelar).
• CANCELADOS (etapa final): Ocultar cards após 120 dias.

3.8 Como a automação de integração é montada

Em qualquer etapa, Automações > Incluir nova automação oferece quatro tipos: Fluxo, E-mail, Integração e Integração entre fluxos. Na integração simples escolhe-se: quando disparar (Entrar, Sair, Atualizar Informação ou Outros), com qual contexto e serviço integrar e o que fazer depois (Dar sequência no card). O link Configurar parâmetros da integração abre o mapeamento entre os campos do fluxo e os parâmetros da API (aba Envio) e os campos que guardam o retorno (aba Retorno). Cada categoria aceita no máximo 3 automações.

Dica

O mapeamento de uma integração aparece, com exemplo real, nos treinamentos de Solicitar e Receber Troca de Representante (telas de "Configurar parâmetros da integração").

4. Passo a passo: executar uma migração

Caminho: Global > Fluxos > Fluxos de trabalho. Esta é a tela de execução e acompanhamento; a tela de Configurações é usada apenas por administradores.

4.1 Abrir o fluxo

1. Em Fluxos de trabalho, localize Migração de Consumidores Varejista - OFICIAL (use a busca "Pesquise um fluxo", se necessário).
2. Clique em Acessar fluxo. (Acessar dashboard mostra os indicadores do fluxo.)
3. O quadro mostra, à esquerda, as etapas com a quantidade de cards; à direita, a lista de cards da etapa selecionada.

4.2 Criar o card (Novo item)

1. Clique em Novo item. Abre-se o painel lateral Novo Item, aba Visão Geral.
2. Preencha Varejista, UC, Nome do Ativo, Código Perfil Varejista, Distribuidora, Tipo de Documento, Num. Documento, Data da Denúncia e Mês de Referência; se quiser, informe Nome da Empresa, Observações e Email da UC.
3. Revise os dados e clique em Criar Card.
4. O card recebe o código CMV000X, entra em Validar CCV e a automação do Início busca os dados do ativo no CRM.

Atenção

Não use Criar Card para testar. Cada card gera uma migração real quando chega à etapa Enviar para a CCEE.

4.3 Validar o CCV

1. Abra a etapa Validar CCV (grupo Backoffice) e localize o card.
2. Confira se o CCV foi assinado e registrado no Módulo Jurídico (automação Atualização CCV Assinado).
3. Com o CCV validado, o card segue para Enviar para a CCEE. Respeite o prazo: 5 dias úteis antes do início do mês de referência.

4.4 Enviar para a CCEE

1. Ao entrar na etapa, o Thunders envia automaticamente a Nova Migração Varejista pela API da CCEE.
2. Se o envio falhar, o card mostra um alerta no Histórico com o botão Tentar novamente. Confira credenciais e dados e tente de novo (ver capítulo 6).
3. Quando a etapa termina, o e-mail configurado é enviado e o card passa para Obter Retorno da CCEE.

4.5 Obter o retorno da CCEE

1. Na etapa Obter Retorno da CCEE o Thunders consulta/recebe o status da migração e grava os retornos no card (Id da Solicitação, Status, Comentário da Distribuidora, MUSD, DHC, Submercado e Código da Supridora).
2. Aprovada: o card segue para Finalizados.
3. Reprovada: o card é desviado automaticamente para Reprovado, onde a Gestão trata o motivo.
4. O prazo da etapa é de 10 dias úteis; passou disso, o card entra em Vencidos.

4.6 Tratar reprovações e cancelamentos

• No card em Reprovado, leia o motivo retornado pela CCEE (campo de comentário/status no Histórico), corrija o dado indicado e, se for o caso, solicite novo envio com o administrador do fluxo.
• Se a migração foi desistida, o administrador move o card para CANCELADOS (ver "Mover card" no capítulo 5).

5. Passo a passo: acompanhar os cards

5.1 Leitura da lista de cards

Ao selecionar uma etapa, a área à direita mostra quatro indicadores clicáveis: Cards na etapa, A vencer em 1 dia, Vencidos e Falha (cards cuja automação deu erro). A tabela traz, entre outras colunas: código do card, UC, Nome do Ativo, Id da Solicitação, Data de Envio da Solicitação, Prazo na etapa, Data de Início na etapa e Data de previsão de saída. O botão Colunas (à direita) permite escolher quais colunas exibir, e cada coluna tem filtro próprio.

5.2 Ações por linha

5.3 Visão Geral e Histórico do card

No painel do card, a aba Visão Geral mostra os campos preenchidos e a aba Histórico lista, do mais recente para o mais antigo, cada passagem: etapa, responsável, datas de entrada e saída, previsão de saída, automações executadas e valores gravados. Alertas em vermelho indicam falha de automação, com o botão Tentar novamente; entradas como "Card movido pelo administrador para a etapa" registram movimentações manuais.

5.4 Filtros, atualização e exportação

• Filtro (funil): permite incluir filtros adicionais. O número em vermelho indica filtros de acesso padrão já aplicados ao seu usuário.
• Atualizar (setas circulares): recarrega as contagens e a lista.
• Exportar/baixar (seta para baixo): gera arquivo com os cards listados, útil para conferência e relatórios.

5.5 Prazos e cores

Cards com prazo estourado aparecem em Vencidos; os que vencem no próximo dia, em A vencer em 1 dia. O prazo é calculado conforme o Parâmetro da etapa (a partir da entrada na etapa, ou relativo a um campo de data). Priorize sempre Falha e Vencidos.

6. Problemas comuns e boas práticas

6.1 Boas práticas

• Confira UC, perfil e documento antes de criar o card: erro de digitação gera reprovação.
• Preencha Email da UC para que a comunicação automática chegue à pessoa certa.
• Revise diariamente as abas Falha e Vencidos.
• Não altere etapas, campos ou automações sem ser administrador; o fluxo é compartilhado e produtivo.
• Registre decisões relevantes no campo Observações.

7. Checklist rápido

1. Credencial da CCEE ativa e vinculada.
2. Usuário no grupo correto e com filtro de acesso à empresa.
3. CCV assinado e validado.
4. Card criado com todos os dados e Mês de Referência correto.
5. Envio à CCEE concluído sem falha.
6. Retorno obtido; aprovada vai a Finalizados, reprovada a Reprovado.
7. Cards vencidos e com falha tratados.