Instruções para geração e envio de dados de indicadores de qualidade

(1)

Instruções para geração e envio de dados de indicadores de

qualidade

(2)

1) Envio dos Arquivos...1

1.1) Cadastro para envio de arquivos: ...1

1.2) Instruções de Envio ...1

2) Estrutura do nome dos arquivos:...8

3) Formatação do arquivo XML (conteúdo do Arquivo): ...9

3.1) Padrão XML para DESATIVAÇÃO de conjuntos ...9

3.2) Padrão XML para CRIAÇÃO de conjuntos ...9

3.3) Padrão XML de INFORME DE INDICADORES APURADOS ...11

********** Novos indicadores criados ***********...11

3.4) Padrão XML de ALTERAÇÃO DE INDICADORES APURADOS já enviados ....13

********** Novos indicadores criados ***********...14

3.5) Padrão XML de RECOMPOSIÇÃO DE CONJUNTOS ...15

3.6) Padrão XML de SOLICITAÇÃO DE EXTRATO DE CONJUNTOS...16

3.7) Padrão XML de SOLICITAÇÃO DE EXTRATO DE AMOSTRA de unidades consumidoras ...17

(3)

1

1.1) Cadastro para envio de arquivos:

Deve ser encaminhado por ofício à SRD, identificando os responsáveis pelo envio e recebimento de retorno do processamento, contendo os seguintes itens para identificação:

- Sistemas de Registro: APLTIQ – Indicadores de Qualidade - Sigla e código da concessionária:

- O nome do responsável pelo envio: - E-mail de retorno:

- Telefone de contato:

Após o cadastro ser efetuado, será encaminhado para o e-mail, o Login e a senha de acesso, e código da concessionária para envio pelo DUTO. Essas informações são de caráter pessoal e serão enviadas para o e-mail da pessoa designada para enviar periodicamente os dados dos indicadores.

Caso seja necessário substituir o(s) responsável(is) pelo envio, deve-se informar encaminhar ofício solicitando o descredenciamento da pessoa informando o nome completo e o novo cadastramento na forma descrita acima.

1.2) Instruções de Envio

(4)

(5)

3

Selecione a aplicação

(6)

Informar a quantidade de arquivos que deseja enviar

(7)

5

Selecionar o arquivo que deseja transmitir

Clicar no botão enviar

(8)

(9)

(10)

2) Estrutura do nome dos arquivos:

“APLTIQ0999DESATIVARCONJUNTOS_DDMMAAAA_S01.xml”

Onde:

Seqüência do envio -> “S” constante, 2 caracteres, referente à seqüência de envio dos arquivos. Data de geração do arquivo -> 8 caracteres

no formato DDMMAAAA [Código do Duto] -> 4 caracteres Operação solicitada -> Pode ser um dos valores abaixo:

• CRIARCONJUNTOS : para criar um novo conjunto para a empresa

• DESATIVARCONJUNTOS : para desativar conjuntos da empresa

• RECOMPORCONJUNTOS : para recompor conjunto(s) da empresa

• INDICADORES : para enviar valores apurados dos indicadores

• ALTERARINDICADORES : para alterar o valor anteriormente apurado e enviado para os indicadores • UNIDADESSORTEADAS: para enviar a amostra sorteada

de unidades consumidoras

• EXTRATOCONJUNTOSINDQUAL : retorna para a empresa os conjuntos cadastrados com seu código e nome.

Identificação da aplicação/empresa -> 10 caracteres “APLTIQ” constante e numero de segurança da empresa.

Exemplo:

Arquivo da concessionária 0999 (código do Duto) gerado em 02/02/2007 encaminhando os indicadores apurados, primeiro envio.

APLTIQ0999CRIARCONJUNTOS_02022007_S01. XML

**** “O reenvio de arquivos com problemas deverá utilizar o mesmo nome acrescido da próxima seqüência de envio no mês, como se fosse um novo envio.”.

Exemplo:

Se o último arquivo enviado foi o lote 01, o arquivo sendo reenviado deve ser o 02. APLTIQ0999ALTERARINDICADORES_02022007_S02.XML

(11)

9 <TIQ Tipo="desativarconjuntos" CodigoConcessionario="CÓDIGO ATRIBUIDO À CONCESSIONÁRIA PELA ANEEL" Sigla="SIGLA DA CONCESSIONÁRIA" DataGeracaoArquivo="DATA DE GERAÇÃO DO ARQUIVO (DD/MM/AAAA)" Sequencial="Ex: S01">

<conjunto>

<codigo_conjunto>CÓDIGO DO CONJUNTO (ID ANEEL-numérico)</codigo_conjunto> <vigencia_fim>DATA FINAL DA VIGENCIA (DD/MM/AAAA)</vigencia_fim>

<motivo_conjunto>MOTIVO DA DESATIVACAO DE CONJUNTO(texto)</motivo_conjunto> <numero_oficio>NUMERO DA RESOLUÇÃO ANEEL QUE AUTORIZOU A CRIAÇÃO DO CONJUNTO</numero_oficio>

</conjunto>

</TIQ>

Exemplo:

<?xml version="1.0" encoding="ISO8859-1"?>

<codigo_conjunto>10</codigo_conjunto> <vigencia_fim>28/05/2007</vigencia_fim>

<motivo_conjunto>MOTIVO DA DESATIVACAO DE CONJUNTO</motivo_conjunto> <numero_oficio>Oficio nº31/2007</numero_oficio>

</conjunto>

3.2) Padrão XML para CRIAÇÃO de conjuntos

O novo conjunto informado só terá validade se todos os seus conjuntos antecessores foram desativados, através de prévio ofício de desativação de conjuntos.

<nome_conjunto>NOME DO CONJUNTO(texto máximo de 120 caracteres)</nome_conjunto>

<vigencia_inicio>DATA INICIAL DE VIGENCIA (DD/MM/AAAA)</vigencia_inicio> <codigo_atendimento>CÓDIGO DO SISTEMA DE ATENDIMENTO (1 DÍGITO valores possíveis: 1 - Convencional, 2 - Subterrâneo Reticulado, 3 - Subterrâneo Radial, 4 - Aéreo)</codigo_atentimento>

(12)

CONJUNTO </numero_oficio>

<abrangencia>

<codigo_municipio>CÓDIGO DO MUNICÍPIO (IBGE), 7 DÍGITOS numéricos)</codigo_municipio>

</abrangencia>

</conjunto>

</TIQ>

Atenção: Os dados apurados periodicamente para o conjunto cadastrado só devem ser enviados após a efetivação desse cadastramento na ANEEL ser oficializada.

Exemplo:

<nome_conjunto>Conjunto de teste</nome_conjunto> <vigencia_inicio>17/04/2007</vigencia_inicio> <codigo_atentimento>1</codigo_atentimento> <numero_oficio>Oficio nº23/2007</numero_oficio>

<codigo_municipio>1100015</codigo_municipio> <codigo_municipio>1100023</codigo_municipio> </abrangencia>

(13)

11 ARQUIVO (DD/MM/AAAA)" Sequencial="Ex: S01">

<indicador>

<codigo_conjunto>CODIGO DO CONJUNTO (ID ANEEL - numérico), OBRIGATORIO se tipo de indicador diferente de DRC, DRP, NumConsAgt e ICC

</codigo_conjunto>

<codigo_UC>CODIGO DA UNIDADE CONSUMIDORA(texto até 20 caracteres) obrigatório se tipo de indicador for DRC e DRP</codigo_UC>

<sigla_indice>SIGLA DO INDICE A SER INFORMADO, OBRIGATORIO. Os valores válidos são:

DEC - Duração Equivalente de Interrupção por Unidade Consumidora - 3 Min. DEC1 - Duração Equivalente de Interrupção por Unidade Consumidora - 1 Min.

DEC1i - Duração Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 1 Min DEC1r - Duração Equivalente de Interrupção por Unidade Consumidora (Racion.)- 1 Min. DEC1x - Duração Equivalente de Interrupção por Unid. Cons. Fat. Externos - 1 Min. DECi - Duração Equivalente de Interrupção por Unid. Cons. Decor. Rede Própia - 3 Min. DECr - Duração Equivalente de Interrupção por Unidade Consumidora (Racion.)- 3 Min. DECx - Duração Equivalente de Interrupção por Unid. Cons. Decor. Fat. Externos - 3 Min. DRC - Duração Relativa da Transgressão Máxima de Tensão Crítica

DRP - Duração Relativa da Transgressão Máxima de Tensão Precária

FEC - Freqüência Equivalente de Interrupção por Unidade Consumidora - 3 Min. FEC1 - Freqüencia Equivalente de Interrupção por Unidade Consumidora - 1 Min.

FEC1i - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 1 Min FEC1r - Freqüência Equivalente de Interrupção por Unidade Consumidora (Racion.)- 1 Min. FEC1x - Freqüência Equivalente de Interrupção por Unid. Cons. Fat. Externos - 1 Min FECi - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 3 Min FECr - Freqüência Equivalente de Interrupção por Unidade Consumidora (Racion.)- 3 Min. FECx - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Fat.Externos - 3 Min Nie - Número de Ocorrências Emergenciais com Interrupções

NumCon - Número de Consumidores do Conjunto no Período

NumOcorr - Número de Ocorrências Emergenciais no Conjunto no Período Pnie - Percentual do Número de Ocorrências Emergenciais com Interrupções TMD - Tempo Médio de Deslocamento

TMM -Tempo Médio de Mobilização

TMP - Tempo Médio de Preparação</sigla_indice>

********** Novos indicadores criados ***********

ERP – Extensão de rede primária com nível de tensão inferior a 69kV em Km(com duas casas decimais)

AREA - Área do conjunto em Km2 (com duas casas decimais)

PNIT – Potência instalada de transformadores de distribuição com , tensão inferior a 69kV (exceto os de cooperativas) em kVA (com duas casas decimais)

CMM – Consumo médio mensal em MWh, média aritmética simples do ultimo ano(exceto o consumo de UC´s com tensão maior ou igual a que 69kV) (mínimo de três casas decimais) TSC – Tipo de sistema do conjunto. 1 para Sistema interligado e 2 para Sistema isolado.

(14)

<valor_indicador>VALOR DO INDICADOR, NUMÉRICO ADEQUADO PARA O INDICE QUE ESTÁ SENDO INFORMADO.(ACEITA ATÉ 8 CASAS

DECIMAIS) *** usar o PONTO como separador de casas decimais</valor_indicador>

<periodo_competencia>PERIODO DA COMPETENCIA DO INDICADOR, (1-4) PARA TRIMESTRAL E (1-12) PARA MENSAL</periodo_competencia>

<ano_competencia>ANO DA COMPETENCIA DO INDICADOR, NUMÉRICO FORMATO AAAA</ano_competencia>

</indicador>

</TIQ>

Exemplo:

<indicador> <codigo_conjunto>10</codigo_conjunto> <codigo_UC></codigo_UC> <sigla_indice>DEC</sigla_indice> <valor_indicador>7893.159874</valor_indicador> <periodo_competencia>4</periodo_competencia> <ano_competencia>2007</ano_competencia> </indicador> <indicador> <codigo_conjunto>10</codigo_conjunto> <codigo_UC></codigo_UC> <sigla_indice>FEC</sigla_indice> <valor_indicador>7951.12675969</valor_indicador> <periodo_competencia>4</periodo_competencia> <ano_competencia>2007</ano_competencia> </indicador> <indicador> <codigo_conjunto>64000</codigo_conjunto> <codigo_UC></codigo_UC> <sigla_indice>DEC</sigla_indice> <valor_indicador>8421.9632</valor_indicador> <periodo_competencia>4</periodo_competencia> <ano_competencia>2007</ano_competencia> </indicador> <indicador> <codigo_conjunto>64000</codigo_conjunto> <codigo_UC></codigo_UC>

(15)

13

</TIQ>

3.4) Padrão XML de ALTERAÇÃO DE INDICADORES APURADOS já

enviados

<TIQ Tipo="alterarindicadores" CodigoConcessionario="CÓDIGO ATRIBUIDO À CONCESSIONÁRIA PELA ANEEL" Sigla="SIGLA DA CONCESSIONÁRIA"

DataGeracaoArquivo="DATA DE GERAÇÃO DO ARQUIVO (DD/MM/AAAA)" Sequencial="Ex: S01">

<codigo_conjunto>CODIGO DO CONJUNTO (ID ANEEL - numérico), OBRIGATORIO se tipo de indicador diferente de DRC, DRC</codigo_conjunto>

<codigo_UC>CODIGO DA UNIDADE CONSUMIDORA(texto até 20 caracteres) obrigatório se tipo de indicador for DRC e DRP</codigo_UC>

<sigla_indice>SIGLA DO INDICE A SER INFORMADO, OBRIGATORIO. Os valores válidos são:

DEC - Duração Equivalente de Interrupção por Unidade Consumidora - 3 Min. DEC1 - Duração Equivalente de Interrupção por Unidade Consumidora - 1 Min.

DEC1i - Duração Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 1 Min DEC1r - Duração Equivalente de Interrupção por Unidade Consumidora (Racion.)- 1 Min. DEC1x - Duração Equivalente de Interrupção por Unid. Cons. Fat. Externos - 1 Min. DECi - Duração Equivalente de Interrupção por Unid. Cons. Decor. Rede Própia - 3 Min. DECr - Duração Equivalente de Interrupção por Unidade Consumidora (Racion.)- 3 Min. DECx - Duração Equivalente de Interrupção por Unid. Cons. Decor. Fat. Externos - 3 Min. DRC - Duração Relativa da Transgressão Máxima de Tensão Crítica

DRP - Duração Relativa da Transgressão Máxima de Tensão Precária

FEC - Freqüência Equivalente de Interrupção por Unidade Consumidora - 3 Min. FEC1 - Freqüencia Equivalente de Interrupção por Unidade Consumidora - 1 Min.

FEC1i - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 1 Min FEC1r - Freqüência Equivalente de Interrupção por Unidade Consumidora (Racion.)- 1 Min. FEC1x - Freqüência Equivalente de Interrupção por Unid. Cons. Fat. Externos - 1 Min FECi - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Rede Própria - 3 Min FECr - Freqüência Equivalente de Interrupção por Unidade Consumidora (Racion.)- 3 Min. FECx - Freqüência Equivalente de Interrupção por Unid. Cons. Decor.Fat.Externos - 3 Min Nie - Número de Ocorrências Emergenciais com Interrupções

NumCon - Número de Consumidores do Conjunto no Período

NumOcorr - Número de Ocorrências Emergenciais no Conjunto no Período Pnie - Percentual do Número de Ocorrências Emergenciais com Interrupções TMD - Tempo Médio de Deslocamento

TMM -Tempo Médio de Mobilização

(16)

ERP – Extensão de rede primária com nível de tensão inferior a 69kV em Km(com duas casas decimais)

AREA - Área do conjunto em Km2 (com duas casas decimais)

PNIT – Potência instalada de transformadores de distribuição com , tensão inferior a 69kV (exceto os de cooperativas) em kVA (com duas casas decimais)

CMM – Consumo médio mensal em MWh, média aritmética simples do ultimo ano(exceto o consumo de UC´s com tensão maior ou igual a que 69kV) (mínimo de três casas decimais) TSC – Tipo de sistema do conjunto. 1 para Sistema interligado e 2 para Sistema isolado.

<valor_indicador>VALOR DO INDICADOR, NUMÉRICO ADEQUADO PARA O INDICE QUE ESTÁ SENDO INFORMADO.(ACEITA ATÉ 8 CASAS

DECIMAIS) *** Usar o PONTO como separador de decimais</valor_indicador>

<periodo_competencia>PERIODO DA COMPETENCIA DO INDICADOR, (1-4) PARA TRIMESTRAL E (1-12) PARA MENSAL</periodo_competencia>

<ano_competencia>ANO DA COMPETENCIA DO INDICADOR, NUMÉRICO FORMATO AAAA</ano_competencia>

</indicador>

</TIQ>

Estes indicadores já foram enviados anteriormente para a Aneel e são passíveis de aceitação pela SRD/SFE.

Exemplo:

<indicador> <codigo_conjunto>10</codigo_conjunto> <codigo_UC>432bv143</codigo_UC> <sigla_indice>DEC</sigla_indice> <valor_indicador>465.7458</valor_indicador> <periodo_competencia>4</periodo_competencia> <ano_competencia>2007</ano_competencia> </indicador> <indicador> <codigo_conjunto>10</codigo_conjunto> <codigo_UC>432bv143</codigo_UC> <sigla_indice>FEC</sigla_indice> <valor_indicador>12.645455</valor_indicador> <periodo_competencia>4</periodo_competencia> <ano_competencia>2007</ano_competencia>

(17)

15 <nome_conjunto>NOME DO CONJUNTO OBRIGATÓRIO (máximo de 120

caracteres)</nome_conjunto>

<vigencia_inicio>DATA INICIAL DE VIGENCIA (DD/MM/AAAA)</vigencia_inicio> <codigo_atendimento>CÓDIGO DO SISTEMA DE ATENDIMENTO (1 DÍGITO valores possíveis: 1 - Convencional, 2 - Subterrâneo Reticulado,

3 - Subterrâneo Radial, 4 - Aéreo)</codigo_atentimento> <numero_oficio> NUMERO DA RESOLUÇÃO ANEEL QUE AUTORIZOU A CRIAÇÃO DO CONJUNTO </numero_oficio>

<codigo_municipio>CÓDIGO DO MUNICÍPIO (IBGE), 7 DÍGITOS</codigo_municipio> </abrangencia>

<antecessor>

<conjunto_antecessor>CÓDIGO DO CONJUNTO ANTECESSOR (ID ANEEL)</conjunto_antecessor>

</antecessor>

</TIQ>

Exemplo:

<nome_conjunto>Conjunto de teste Recompor</nome_conjunto> <vigencia_inicio>26/04/2007</vigencia_inicio>

<codigo_atentimento>2</codigo_atentimento> <numero_oficio>Oficio nº23/2007</numero_oficio>

<codigo_municipio>1100015</codigo_municipio> <codigo_municipio>1100023</codigo_municipio> </abrangencia>

<antecessor>

<conjunto_antecessor>10</conjunto_antecessor> <conjunto_antecessor>64000</conjunto_antecessor> </antecessor>

(18)

</TIQ>

3.6) Padrão XML de SOLICITAÇÃO DE EXTRATO DE CONJUNTOS

<TIQ Tipo="extratoconjuntosindqual" CodigoConcessionario="CODIGO ATRIBUIDO À CONCESSIONÁRIA PELA ANEEL" Sigla="SIGLA DA CONCESSIONÁRIA"

DataGeracaoArquivo="DATA DE GERAÇÃO DO ARQUIVO (DD/MM/AAAA)" Sequencial="Ex: S01">

<cod_concessionario>CODIGO ATRIBUIDO À CONCESSIONÁRIA PELA ANEEL, FORMATACAO 4 DIGITOS</cod_concessionario>

</TIQ>

Exemplo:

<cod_concessionario>5160</cod_concessionario> </TIQ>

Essa solicitação vai gerar como retorno um arquivo com a relação de conjuntos da empresa contendo código e nome do conjunto:

/********************************************************************************************************** x--- TIQ (VERSAO 1.0) ---x Data/Hora: 30/04/2007 18:21:32

Sistema: INDICADORES DE QUALIDADE

Nome do arquivo analisado: APLTIQ5160EXTRATOCONJUNTOSINDQUAL_30042007_S45.xml

ABAIXO SEGUE A LISTA DE CONJUNTOS COM SEUS RESPECTIVOS CODIGOS: Conjunto: Conjunto 10 - Codigo: 10

Conjunto: Conjunto de teste do sistema/migração - Codigo: 24000 Conjunto: Teste de Correcao - Codigo: 171

Itens de Validação:

Arquivo de LOG Criado Com Sucesso!...(OK) Dados carregados com o nome do arquivo!...(OK) Dados carregados com sucesso!...(OK) Validacao dos dados do cabecalho!...(OK)

(19)

17 <?xml version="1.0" encoding="ISO8859-1"?>

<cod_concessionario>CODIGO ATRIBUIDO À CONCESSIONÁRIA PELA ANEEL, FORMATACAO 4 DIGITOS</cod_concessionario>

<trimestre>TRIMESTRE DA AMOSTRA, FORMATACAO 1 DIGITO (1-4)</trimestre> <ano>ANO DA AMOSTRA, FORMATACAO 4 DIGITOS</ano>

</TIQ>

Obs.:

Essa solicitação vai gerar como retorno um arquivo com a relação das unidades consumidoras sorteadas para acompanhamento no trimestre.

/************************************************************************** ******************************** x TIQ (VERSAO 1.0) ---x Data/Hora: 08/05/2007 15:00:02

Sistema: INDICADORES DE QUALIDADE

Nome do arquivo analisado: APLTIQ2866EXTRATOAMOSTRA_08052007_S02.xml

Segue abaixo os dados das Amostra do Concessionario: 2866 - Ano: 2005 - Trimestre: 2

Codigo da Unidade: 000000000002763 - Conjunto: CURITIBA ALTO DA GLÃ“RIA - UF: PR

Codigo da Unidade: 000000000008751 - Conjunto: CURITIBA ATUBA - UF: PR Codigo da Unidade: 000000000013566 - Conjunto: PINHAIS - UF: PR

Codigo da Unidade: 000000000022352 - Conjunto: CURITIBA ATUBA - UF: PR Codigo da Unidade: 000000000023969 - Conjunto: CURITIBA ALTO DA GLÃ“RIA - UF: PR

Codigo da Unidade: 000000000064548 - Conjunto: CURITIBA BOQUEIRÃƒO - UF: PR

Codigo da Unidade: 000000000066253 - Conjunto: CURITIBA PINHEIRINHO - UF: PR

(20)

4) Resultado do processamento do arquivo

O resultado do processamento estará disponível no DUTO (http://duto.aneel.gov.br/duto/), na página, conforme figura abaixo, no link “Dados carregados na base”.

(21)