1. Visão geral do fluxo

O fluxo OFICIAL - Solicitar Troca de Representante é usado pelo novo varejista (o solicitante) para pedir à CCEE a troca de representante de uma Unidade Consumidora (UC) e acompanhar a resposta. A solicitação é enviada pela API do CP28 (contexto Troca de Representante); a CCEE encaminha o pedido ao varejista atual, que pode deferir ou indeferir, e o resultado volta ao card.

O fluxo par deste é o OFICIAL - Receber Troca de Representante, usado pelo varejista atual para responder às solicitações recebidas (ver treinamento específico).

1.1 Para que serve

• Registrar e enviar à CCEE a solicitação de troca de representante por UC, sem acessar o portal da CCEE.
• Guardar o Id da Solicitação devolvido pela CCEE e a data da solicitação.
• Atualizar automaticamente o card quando o varejista atual responde.
• Mover para Indeferidos pelo Atual Varejista as solicitações recusadas.

1.2 Contexto regulatório (resumo)

No modelo simplificado (Submódulo 1.8 dos Procedimentos de Comercialização da CCEE, vigência 01/07/2025), o novo varejista informa o tipo de solicitação conforme a situação do contrato do consumidor com o varejista atual:

• Os prazos são contados em dias e a efetivação depende do calendário M-12du (dias úteis do mês de referência). Se o varejista atual não responder dentro do prazo regulatório, a CCEE pode considerar a solicitação aprovada automaticamente.
• UCs migradas via API: o novo varejista deve usar o conjunto de APIs adequado ao tipo informado (por exemplo, o desligamento usa APIs próprias). Em caso de dúvida, confirme com o Suporte antes de enviar.

Atenção

A solicitação é enviada à CCEE com dados reais. Escolha o Tipo Solicitação correto: resilição, resolução e desligamento têm prazos e efeitos diferentes.

2. Pré-requisitos

• Acesso a Global > Fluxos e permissão do seu grupo no fluxo (ver Configurações de fluxo > Permissões de acesso).
• Grupo responsável: o fluxo usa o grupo Produtos nas etapas Envio para CCEE e Aguardando Retorno.
• Filtro de acesso à empresa que será o Solicitante (novo varejista).
• Credencial da CCEE ativa em Global > Painel de Controle > Integrações > Integrações CCEE > Credenciais API, com a integração do contexto Troca de Representante vinculada.
• Dados da solicitação: Solicitante, Distribuidora, Perfil Varejista, Código UC, Mês de Referência e Tipo de Solicitação.

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

Caminho: Global > Fluxos > Configurações > Fluxos, lápis na linha do fluxo.

Importante

Salvar etapa, lixeira e a engrenagem alteram o fluxo em produção. Use somente se for administrador.

3.1 Mapa das etapas

3.2 Etapa Início – campos

A aba Automações do Início não possui automações.

3.3 Etapa Envio para CCEE

Etapa Manual, grupo Produtos, prazo de 10 dias úteis a partir da entrada. A aba Campos p/ visualizar define quais campos dos estágios anteriores o responsável enxerga (aqui, todos os campos do Início e, adiante, os retornos).

Na aba Automações há uma automação do grupo Sair (executa quando o card deixa a etapa):

• Tipo Integração – Troca de Representante > Solicitar mudança de representante.

Mapeamento de envio (Configurar parâmetros da integração > Envio)

Mapeamento de retorno (aba Retorno)

A aba Retorno lista tudo o que a API devolve; marca-se o que deve ser guardado e escolhe-se o campo do fluxo que receberá o valor (os campos novos precisam existir em Campos p/ preencher). No ambiente, estão mapeados:

Estão disponíveis, porém não mapeados: unidade consumidora, concessionária, tipo de mudança de representante, mês de referência, situação da mudança, identificador da migração alterada, indicador de antecedência, varejista novo e código de perfil novo, varejista e código de perfil, descrição/justificativa, data de atraso, data da notificação e identificador da celebração na CER.

3.4 Etapa Aguardando Retorno

Etapa Automática (o card não é movido por pessoas), grupo Produtos, 10 dias úteis. Possui três campos somente leitura, preenchidos pelas automações: Retorno Atual Varejista, Comentários Atual Varejista e Id Solicitação de Troca de Representante.

Automações da etapa:

• Atualizar Informação – Integração Troca de Representante > Atualização de mudança de representante: traz a resposta do varejista atual para o card.
• Outros – Fluxo Solicitações Reprovadas: se a solicitação for indeferida, o card é desviado para Indeferidos pelo Atual Varejista.

3.5 Etapas finais

• Finalizados: solicitações deferidas e concluídas.
• Indeferidos pelo Atual Varejista: oculta os cards após 120 dias.

4. Passo a passo: solicitar a troca de representante

4.1 Abrir o fluxo

1. Acesse Global > Fluxos > Fluxos de trabalho.
2. Busque "Troca de Representante" no campo Pesquise um fluxo e clique em Acessar fluxo em OFICIAL - Solicitar Troca de Representante.

4.2 Criar a solicitação

1. Clique em Novo item.
2. Escolha o Solicitante (novo varejista) e a Distribuidora.
3. Informe o Perfil Varejista (número) e o Código UC.
4. Selecione o Mês Referência e o Tipo Solicitação (Resilição, Resolução ou Desligamento).
5. Clique em Criar Card (botão ao final do formulário). O card recebe o código TR000X e entra em Envio para CCEE.

Atenção

O campo Data solicitação CCEE é preenchido pelo sistema (somente leitura). Não use Criar Card em testes: ao sair de Envio para CCEE a solicitação é enviada de verdade.

4.3 Enviar para a CCEE

1. Na etapa Envio para CCEE, localize o card e abra-o pelo lápis para conferir os dados.
2. Quando estiver tudo correto, mova o card para a etapa seguinte (ícone Mover card, escolhendo Aguardando Retorno), ou conclua a etapa conforme o procedimento da sua equipe.
3. Ao sair da etapa, a automação Solicitar mudança de representante envia o pedido à CCEE e grava o Id da Solicitação e a Data solicitação CCEE.
4. Se houver erro, o card exibe alerta no Histórico, com Tentar novamente (ver capítulo 6).

4.4 Aguardar o retorno

1. O card passa a Aguardando Retorno e permanece até a resposta do varejista atual.
2. A automação Atualização de mudança de representante atualiza os campos Retorno Atual Varejista e Comentários Atual Varejista.
3. Se a solicitação for deferida, o card segue para Finalizados. Se for indeferida, a automação Solicitações Reprovadas envia o card para Indeferidos pelo Atual Varejista.
4. Prazo: 10 dias úteis. Passado isso, o card aparece em Vencidos.

5. Passo a passo: acompanhar

5.1 Quadro e indicadores

Cada etapa mostra a contagem de cards. Dentro da etapa, os botões Cards na etapa, A vencer em 1 dia, Vencidos e Falha filtram a lista. A tabela traz Cód, Solicitante, Distribuidora, Perfil Varejista, Código UC, Mês Referência, Tipo Solicitação, Data solicitação, Prazo na etapa, Data de início, Data prevista e Erro. A coluna Erro mostra falhas de integração.

5.2 Histórico do card

Abra o card (lápis) e use a aba Histórico: ela mostra a inclusão do item, quem criou e quando, os valores informados, a etapa atual com previsão de saída e, nas passagens seguintes, entradas e saídas, automações executadas e retornos. Use o botão de busca para localizar um texto no histórico.

5.3 Ações, filtros e exportação

• Mover card (ícone de seta): apenas administrador; escolhe a etapa de destino.
• Filtro (funil): os filtros de acesso padrão já aplicados aparecem com o número em vermelho.
• Atualizar e Exportar (seta para baixo) ficam na barra de ferramentas de Etapas.

6. Problemas comuns e boas práticas

• Escolha o tipo de solicitação com base no contrato real e documente a justificativa fora do card quando necessário.
• Revise Falha e Vencidos diariamente.
• Alinhe com o varejista atual a resposta no fluxo Receber Troca de Representante para evitar indeferimentos por falta de resposta.

7. Checklist rápido

1. Credencial CCEE ativa e integração Troca de Representante vinculada.
2. Dados conferidos: solicitante, distribuidora, perfil, UC, mês de referência.
3. Tipo de solicitação correto.
4. Card criado e enviado; Id da Solicitação preenchido.
5. Retorno acompanhado até Finalizados ou Indeferidos.
6. Falhas e vencidos tratados.