Arquivo XSD Importação de XML Módulo de Contratos

Transcrição

1 Arquivo XSD Importação de XML Módulo de Especificação do arquivo XSD /07/ de 10

2 Histórico de Revisões Data Versão Descrição - Elaboração Inicial da especificação do arquivo XSD Módulo de 06/10/ /07/ de 10

3 Índice 1. INTRODUÇÃO LOCALIZAÇÃO ESTRUTURA GERAL DOS ELEMENTOS OPERAÇÕES DISPONÍVEIS REFERÊNCIAS /07/ de 10

4 1. Introdução Importação de Arquivo XML Módulo Este documento tem o objetivo de auxiliar os agentes na construção de aplicações para a criação de arquivos do tipo XML para importação de criação e edição de contratos no sistema CliqCCEE 4.0 A CCEE estabeleceu por meio dessa especificação um padrão de arquivo XSD(XML SchemaDefinition) que é usado para descrever o formato/padrão que um arquivo XML deve seguir, ou seja, ele tem que indicar quais nodes (<node1><subnode1/></node1>) ele pode conter, quais subnodes e atributos. 2. Localização A tabela abaixo lista a localização do gerador de XML Portal CCEE Produção da Endereço CONTEUDO EXCLUSIVO> CONTRATOS > TIPOS > GERADOR XML CONTRATOS - CLIQCCE 3. Estrutura geral dos elementos As seções a seguir descrevem cada parâmetro de entrada, com seus respectivos tipos de dados e descrição. Contrato CCEAL- Criar/Editar CCEAL Nome Tipo Obrigatório Tamanho Dados Gerais Tipo de Gravação* Grupo Máscara de Entrada Regra de Preenchimento Sim 1 R ou C Aceitar somente os valores - Tipos: R Rascunho, C Concluído Data de Início* (DD/MM/AAAA HH) Data de Fim* (DD/MM/AAAA HH) ID do Comprador* Data Sim Não se aplica Não se aplica iguais a "01/01/200000". Data Sim Não se aplica Não se aplica iguais a "01/01/200000". Sim Não se aplica Não se aplica Aceitar somente valores maiores que 0. ID do Vendedor* Sim Não se aplica Não se aplica Aceitar somente valores maiores que 0. ID do Submercado de Sim Não se aplica Não se aplica Aceitar somente os valores de 1 a 4. 1 Sudeste /07/ de 10

5 entrega* 2 Sul 3 Nordeste 4 Norte Referência Não 30 Não se aplica Tamanho Max. 30 caracteres. Direito ao Alívio de Exposição Não 1 0 ou 1 Aceitar somente os valores 0 Autoprodução e 1 Direitos Especiais ID do Submercado de Origem* Particularidade para Verificação de Lastro Sim para contratos de Direitos Especiais Não se aplica Não se aplica Aceitar somente os valores de 1 a 4. 1 Sudeste 2 Sul 3 Nordeste 4 Norte Não 1 G, E ou D Aceitar somente os valores G - Geração Própria E - Exportação D - Lastro de Venda para CCEAR D Observação Não 255 Não se aplica Tamanho Max. 255 caracteres Cessão Grupo Contrato de Cessão Não 1 X ou Preencher com "X" Número do Contrato Origem Não Não se aplica Não se aplica Aceitar somente valores maiores que 0. Médio (Contrato CCEAL Firme Semanal, Mensal, Por Período, e Firme Por Hora e Por Patamar) Data de Início do Data Sim 13 DD/MM/AAA Médio* (DD/MM/AAAA HH) A HH iguais a "01/01/200000:00". Preencher somente até a parcela hora. Data de Fim do Médio* (DD/MM/AAAA HH) Data Sim 13 DD/MM/AAA A HH Contrato CCEAL Firme Semanal e Firme Por Patamar Semana* iguais a "01/01/ :00 Preencher somente até a parcela hora. Sim 1 Não se aplica Aceitar somente valores maior ou igual a 1. [ Preencher com o número da semana. Ex: 1 para a semana1 10 para a semana10 Contrato CCEAL Firme Mensal e Firme Por Hora Mês/Ano* Sim 7 MM/AAAA Aceitar somente valores entre 1 e 12 e ano maior que Preencher com mês e ano. Ex: 01/2014 Contrato CCEAL Firme Por Hora Dia* Sim 2 DD Aceitar somente valores entre 1 e /07/ de 10

6 Hora Início* Inserir somente uma vez, em caso de mais de 1 dia. Ex: Dia Hora Sim 2 HH Aceitar somente valores entre 00 e 23, e 23*. Utilizar as horas da seguinte forma: Usar 23* para a hora adicional do dia de término do horário de verão MWh* Sim 28, , iguais que 0, Criar contrato CCEAL Firme Por Patamar Unidade do Patamar* Sim 1 0 ou 1 Aceitar somente os valores 0 MWh 1 MWmédio Leve (MWh ou MWmédio) Não 6 casas (MWmédio) e 3 casas (MWh) , ou igual que 0. Preencher com 3 casas para o tipo Patamar 0 - MWh Preencher com 6 casas para o tipo 1 - MWmédio Médio (MWh ou MWmédio) Não 6 casas (MWmédio) e 3 casas (MWh) , , ou igual que 0. Preencher com 3 casas para o tipo Patamar 0 - MWh Preencher com 6 casas para o tipo 1 MWmédio Pesado (MWh ou MWmédio) Não 6 casas (MWmédio) e , ,9999 igual que 0. Preencher com 3 casas para o /07/ de 10

7 3 casas (MWh) 99 ou tipo Patamar 0 - MWh Preencher com 6 casas para o tipo 1 - MWmédio Criar contrato CCEAL Firme Semanal, Mensal e Por Período MWmédio* ,999 Sim 28, , Criar contrato CCEAL Firme (Todos os tipos) Validar Não 1 X ou Médio igual que 0. *colocar como nota: Preencher com X [ Criar contrato CCEAL Firme Por Percentual Semanal, Mensal, Por Período, e Firme Por Hora e Por Patamar Tipo Modulação Mínimo (MWh) Máximo (MWh) Não 1 Para CCEAL Firme: F, G, C ou M Não 28, ,999 Não 28, ,999 Aceita somente os valores listados abaixo: F - Flat G - Geração C - Carga M - MRE Criar contrato CCEAL Firme Semanal, Mensal, Por Período, e Firme Por Hora e Por Patamar ID da Parcela do Não Não se aplica Não se aplica Aceitar somente valores maiores que 0. Ativo Para Modulação - Obrigatório caso o tipo da Modulação for 'C-Carga' ou 'G-Geração'' Contrato CCEAL- Finalizar ou Cancelar Contrato CCEAL Nome Tipo Obrigatório Tamanho Finalizar ou Cancelar Número do Contrato* Data Finalização Contrato (DD/MM/AA Grupo Máscara de Entrada Regra de Preenchimento Sim Não se aplica Não se aplica Aceitar somente valores maiores que 0 Inserir somente uma vez. Data Não 13 DD/MM/AAAA HH iguais a "01/01/ ". Preencher somente até a parcela hora /07/ de 10

8 AA HH) Validar Finalização Cancelar Contrato Não 1 X ou Preencher com X Não 1 X ou Preencher com X Não deverá ser preenchido caso o campo "Cancelar Contrato" ou "Validar Cancelamento" for informado. Não deve ser preenchido caso o campo "Cancelar Contrato" for informado. Não deve ser preenchido caso o campo "Data Finalização Contrato" ou "Validar Finalização" for informado. Validar Cancelament o Não 1 X ou Preencher com X Não deve ser preenchido caso o campo "Data Finalização Contrato" ou "Validar Finalização" for informado. Contrato CCEAL- Validar CCEAL Nome Tipo Obrigatório Tamanho Dados Gerais Número do Contrato* ValidarRegi stro do Contrato s MWmédio Início Vigência do Médio (DD/MM/A AAA HH) Grupo Máscara de Entrada Regra de Preenchimento Numéric o Sim Não se aplica Não se aplica Aceitar somente valores maiores que 0. Inserir somente uma vez. Não 1 X ou Preencher com "X" Grupo Data Não 13 DD/MM/AAAA HH iguais a "01/01/ :00". Preencher somente até a parcela hora. Inserir somente uma vez em caso de mais de um período. Validar Médio Não, Obrigatório somente se o campo Início Vigência do Médio for informado 1 X ou Preencher com X [ /07/ de 10

9 4. Operações disponíveis As operações disponíveis para contratos do tipo CCEAL Firme são: Criar contrato com dados gerais e montantes (Rascunho); Criar contrato CCEAL Firme Semanal; Criar contrato CCEAL Firme Mensal; Criar contrato CCEAL Firme Por Período; Criar contrato CCEAL Firme DECLARADO para cada hora; Criar contrato CCEAL Firme DECLARADO por patamar; Editar contrato CCEAL Firme Semanal; Editar contrato CCEAL Firme Mensal; Editar contrato CCEAL Firme Por Período; Editar contrato CCEAL Firme DECLARADO para cada hora; Editar contrato CCEAL Firme DECLARADO por patamar; Validar Dados do Contrato, Médio; Finalizar ou Cancelar Contrato CCEAL; Exemplo de XML de Criação 1. Criar contrato CCEAL Firme DECLARADO para cada hora <CCEALtipoGeracao="5" tipocceal="1" sistemaorigem="contingencia"> <Contrato sequencialcontrole="1" tipogravação="c" validarregistro="x" datadeinicio="01/01/ :00:00" datadefim="31/12/ :00:00" idcomprador="1" idvendedor="2" idsubmerentrega="1" referencia="10" diralivexp="0" idsubmerorigem="1" partverlastro="e" observação="anotar o montante e acompanhar" contratocessao="x" idcontratocessao="123"> <MédiodataDeInicio="01/01/ " datadefim="31/12/ " validar="x"> <MédioContratoCCEALFirme montantemedio="999999,999999"/> <MesAnomesAno="01/2000"> <Dia dia="01"> <Hora hora="00" montantehorario="999999,999"/> </Dia> </MesAno> <AtivoAssociadoModulacaoidAtivoAssociadoModulacao=""/> </Médio> </Contrato> </CCEAL> 2. Editar contrato CCEAL Firme Semanal <CCEALtipoGeracao="13" tipocceal="1" <Contrato sequencialcontrole="1" numerocontrato="123" tipogravação="c" validarregistro="x" > <MédiovigenciaDeInicio="01/01/ " vigenciadefim="31/12/ " > <semana semana="1" validar="x"> <MédioContratoCCEALFirme /07/ de 10

10 montantemedio="999999,999999"/> <TipoModulacaotipoModulacao="F"/> <LimiteModulacao limiteminimomodulacao="999999,999" limitemaximomodulacao="999999,999"/> <AtivoAssociadoModulacaoidAtivoAssociadoModulacao=""/> </semana> </Médio> </Contrato> </CCEAL> 3. Validar Dados do Contrato e Médio <CCEALtipoGeracao="24" > <Contrato sequencialcontrole="1" numerocontrato="123" validarregistro="x"> <MédiovigenciaDeInicio="01/01/ " validar="x"> </Contrato> </CCEAL> 4. Finalizar ou Cancelar Contrato CCEAL <CCEALtipoGeracao="25"> <Contrato sequencialcontrole="1" numerocontrato="123" datafinalizacao="01/02/ " validarfinalizacao="x" cancelarcontrato="" validarcancelamento=""/> </CCEAL> 5. Referências Sigla Definição Versão do Gerador de XML /07/ de 10