Public
Documentation Settings

Plataforma de Integração CCEE

A Plataforma de Integração é uma ferramenta que conecta os sistemas dos agentes com os sistemas da CCEE.

A solução complementa os canais de acesso oferecidos pela CCEE para conectar o negócio do cliente de forma simples e acessar informações com rapidez, segurança e confiabilidade.

Entre os benefícios para os agentes que utilizam a plataforma estão:

  • Redução de atividades manuais por meio da integração entre sistemas
  • Menor custo e risco operacional com a automatização de rotinas
  • Maior agilidade e qualidade na integração e no intercâmbio de dados entre CCEE e demais participantes do mercado

Quem pode utilizar

Agentes e consultorias que tenham representação total dos seus clientes aderidos à CCEE. Os serviços da Plataforma de Integração disponibilizam informações aos agentes que sejam de sua responsabilidade. Portanto os agentes somente poderão realizar requisições referente a perfis de agente próprios ou representados. Exceções se aplicam a serviços de consultas de cadastros, como ativos e parcelas ou agentes e perfis.

Como aderir

Para utilizar a solução, basta possuir um certificado digital e realizar um cadastro na CCEE. Veja como é simples:

Como utilizar

Com o certificado instalado e o cadastro realizado, o próximo passo é conectar seu sistema aos serviços da plataforma. Veja abaixo como utilizar cada um deles.

Código do Perfil de Agente

O código de perfil do agente representa o perfil do agente dentro da CCEE. O perfil é uma forma de diferenciar o tratamento atribuído na contabilização entre usinas e cargas de um mesmo agente. Por exemplo, um mesmo agente pode ter uma usina com energia incentivada e outra com energia convencional, tendo os tratamentos adequados na contabilização para tipo de energia. Já para cargas aplica-se o mesmo conceito, perfis diferentes permitem que sejam contabilizadas cargas com características diferentes, como por exemplo cargas sujeitas a desconto ou sem desconto. Resumindo, o perfil é como o agente monta as suas contratações de energia.

  • Cuidado para não confundir o código do agente com o código do perfil do agente.

Sua consulta pode ser feita pela Plataforma Cadastral, como também da planilha Infomercado Dados Individuais, encontrada nos documentos do site da CCEE. A informação também consta na consulta do serviço Perfil Participante Mercado.

Esta informação deverá ser enviada no "Header" de todas as requisições da Plataforma de Integração.

Limites de requisições

Atualmente o limite de requisições de todos os nossos serviços encontra-se em 400 chamadas por minuto. Ou seja, para cada usuário sistêmico é permitido realizar 400 chamadas por minuto por serviço da plataforma.

Caso a sua chamada apresente um erro "2003", cujo texto seja similar a este:

O usuário [xpto] excedeu o limite de 400 requisição(ões) a cada 60 segundo(s). Tente novamente em 19 segundo(s).

reveja o número de chamadas efetuadas por usuário, e por serviço.

Atenção - Exceção do limite de requisições

Para o serviço SituacaoColetaMedicao-obterSituacaoColetaMedicao o limite de requisições é diferenciado, ou seja, é de 60 requisições por 3600 segundos.

Loading