Professional Documents
Culture Documents
Anexo1 Interfaz (SIG-AMI) - KAVICENTINEL REV6.1 180925 ENG PDF
Anexo1 Interfaz (SIG-AMI) - KAVICENTINEL REV6.1 180925 ENG PDF
SUB-DIRECTION OF DISTRIBUTION
ANNEXED 1
INTERFACE SPECIFICATION BETWEEN KAVI CENTINEL AND
IT MANAGEMENT SYSTEM (SIG-AMI).
OBJECTIVE:
Define the characteristics, operation and test protocol for the interfaces between the
Management Information System (SIG-AMI) and the Institutional Commercial Systems of CFE.
SCOPE:
The definition of the characteristics and operation of the commands for the interfaces
between the Management Information System (SIG-AMI) and the KaviCentinel have the
following rates as scope, and only applicable to them.
Types of readings:
RATES
Domestic 01, 1A, 1B, 1C, 1D, 1E, 1F
Commercial (low voltage) 2, 3
Commercial (medium voltage) 0M
09, 9C, 9N
Agricultural low voltage
9M, 9C, 9N
Agricultural medium voltage
Street lighting 05, 5A
Pumping or re-pumping of drinking water 06
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Three-phase M1 M2 M3
(Arrangement,multi
phase, type cabinet,
Wh totals)
Forms 9S, 12S 16S. M1 M1 M1
“KL”, “VL”, “FD”
Note: Multiphase Arrangement, It refers to an array of single-phase cabinet type meters for
measuring more than 1 phase.
M1 + M2 + M3 =
MEQ
Forms 9S, 12S M1 M1 M1 M1
16S.
“KL”, “VL”, “FD”
Note:
Multiphase Arrangement, It refers to an array of single-phase cabinet type meters for
measuring more than 1 phase.
Single-phase M1
( Type cabinet)
Dual-phase M1 M2
(Arrangement,multi
pha se, type
cabinet, Wh totals)
Three-phase M1 M2 M3
(Arrangement,multi
phase, type
cabinet, Wh totals)
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Note: In multiphase arrangements, the SIG-AMI you must identify the customer measurement
arrangement to execute disconnections and connections of your meters.
A. Definitions.
TERMINOLOGY DESCRIPTION
SICOM Commercial Billing and Collection System of CFE.
SICOSS Service Request Control System CFE.
KAVICentinel Readings Management System. System that includes
communication interfaces with SICOM-SICOSS and SIG-AMI.
Reading Consumption reading of kilowatt-hours, maximum demand
and reagents of field meters
Rate Officially set price to charge electric power service.
To Consider:
1) The meter counter reset is subject to the Boolean flag .
2) <ReiniciarContadores> used in the Update Meter Data method
3) Boolean flag <ReiniciarContadores> Must be = True for the counter reset to run
Value Description
EnProceso The execution of the command is not yet
complete
Pausada The execution of the command is
temporarily stopped to allow execution
of a command with higher priority
(see attached table Hierarchy in command
execution).
Abortada The execution of the command was
incomplete due to an error that prevents
its completion successfully.
Completada The command execution has been
completed successfully.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
• The areas of Distribution of CFE should count on the updated version of the system
KAVICentinel that integrates the interfaces between the Computer Management System
(SIG-AMI) and the Institutional Commercial Systems of CFE.
• The Computer Management System (SIG-AMI) and the KAVICentinel should consider that
the methods of their WebServices should add a user and password to be able to be
called from the client.
• Maximum response time allowed by satisfactory request, after the SIG-AMI receives the
petition from KaviCentinel through its webServices:
o Readings in real time from a service (a RPU): 2 minutes maximum for each
meter installed in the service.
o Readings by a group of meters (readings to the Base of Data of SIG-AMI): 1
minute for each 3000 meters.
o Disconnection in real time from a service (a RPU): 2 minutes maximum for each
measure installed in the service.
o Disconnection of group of meters (by scheduled task of SICOM): At least in a
period of 8 hours, the SIG-AMI will have the ability to disconnect at least 3000
meters.
o Reconnection in real time of a service (a RPU): 2 minutes maximum for each
meter installed in the service.
o Reconnection of a group of meters (by scheduled task of SICOM): At least in a
period of 8 hours, the SIG-AMI will have the ability to reconnect at least 3000
meters.
o Extraction of events in real time: 2 minutes per meter.
o Update of data (of SICOM to the Base of Data of the SIG-AMI): Maximum 5
minutes per 3000 meters.
o Data consultation (of SICOM to the Base of Data from SIG-AMI): Maximum 1
minute for each 3000 meters.
• The Computer Management System (SIG-AMI) must provide a mechanism to check the
status and progress of each request made by the KAVICentinel system.
• The Computer Management System (SIG-AMI) should have the ability to execute at least
the following commands:
a) Reading of a meter or group of meters (online or by scheduled task)
b) Online disconnection of a meter or group of meters
c) Online reconnection of a meter or group of meters
d) Changes in online status by a meter or group of meters (high, low or
change of meter)
e) Report alarms online by a meter or group of meters
• The SIG-AMI should be able to use the method published in the
KaviCentinel WebServices for alarm reporting
f) Online verification of a meter or group of meters
• The SIG-AMI must publish a method that allows the
KaviCentinel to consult the alarm history.
Example of:
Maximum response time permitted for satisfactory request, from which the SIG-AMI will
receive the request from KaviCentinel through its webServices
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
1 RPU = 1 client
Can contain the following number of meters of a BT
QUANTITY OF METERS MAXIMUM TIME
METERS PERMITTED
1 physical Meter 123456 (called Consumption1) 2 minutes
2 DIFFERENT 123456, 234567 (called Consumption1, Consumption2) 4 minutes
physical Meters
3 DIFFERENT 123456, 234567, 345678 (called Consumption1, 6 minutes
physical Meters Consumption2, Consumption3)
1 RPU = 1 client
Can contain the following number of meters of a BT
QUANTITY OF METERS MAXIMUM TIME
METERS PERMITED
Bidirectional 123456(called Consumption1, Consumption2) 2 minutes
Meters
1 RPU = 1 client
Can contain the following number of meters when it is an MT.
QUANTITY OF METERS MAXIMUM TIME
METERS PERMITED
1 Meter 123456 (called Consumption1, Demand, Reactives) 2 minutes
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
wsKAVICentinel
wsSIGAMI
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
a. General Diagram
SOAP 1.2
KAVICentinel SIG-AMI
b. Structure of commands
WebService: wsSIGAMI
Method: LeerMedidores
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService: wsSIGAMI
Method: LeerMedidores
Definition SOAP Response:
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService: wsKAVICentinel
Method: RecibirLecturas
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionErrorLectura>string</DescripcionErrorLectura>
<FechaInicioLectura>dateTime</FechaInicioLectura>
<FechaFinLectura>dateTime</FechaFinLectura>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaLecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</ListaLecturas>
<ResultadoLecturaDemanda>
<DemandaReseteada>boolean</DemandaReseteada>
<NumeroResetsDemanda>int</NumeroResetsDemanda>
<CodigoErrorResetDemanda>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorResetDemanda>
</ResultadoLecturaDemanda>
</ResultadoLecturasMedidor>
</listaResultados>
</RecibirLecturas>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RecibirLecturas
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
a) Considerations
1) Retries.- In relation to the request of readings, in case that the response of method
wsKAVICentinel.RecibirLecturas or the method wsSIGAMI.LeerMedidores isn't successful,
the request retry mechanism must be implemented, the number of retries and the time
interval must be configurable until a satisfactory response is obtained or the number of
retries is drained. Each failed retry should generate its corresponding record in an
error log that allows identifying the source of the error.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Demand Considerations:
o The value of NumeroResetsDemanda must be the accumulated number after
resetting the demand to the meter.
o The value for the read code called “Demand” (or type 4) should be the value
of maximum demand registered in intervals of 15 minutes, before the rest.
The security of the method will be implemented through the authentication header
requesting user and password that CFE will design to SIG-AMI in an individual manner
and must evaluate that the request made comes from the KaviCentinel. In the same
way the Web Service wsKaviCentinel will require that the SIG-AMI authenticate with
the same mechanism but with another user and password different from the main
ones
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURES
WebService: wsSIGAMI
Method: DesconectarMedidores
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
</PeticionOperacionMedidor>
<PeticionOperacionMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ListaTiposLectura>
<TiposLectura>ConsumoTotal or ConsumoFase1 or ConsumoFase2
or ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
ConsumoEnergiaEntregada or ConsumoEnergiaRecibida or DemandaMaxima or
Reactivos</TiposLectura>
<TiposLectura>ConsumoTotal or ConsumoFase1 or ConsumoFase2
or ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
ConsumoEnergiaEntregada or ConsumoEnergiaRecibida or DemandaMaxima or
Reactivos</TiposLectura>
</ListaTiposLectura>
</PeticionOperacionMedidor>
</listaMedidores>
</DesconectarMedidores>
</soap12:Body>
</soap12:Envelope>
WebService wsSIGAMI
Method: DesconectarMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</DesconectarMedidoresResult>
</DesconectarMedidoresResponse>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RecibirDesconexiones
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionErrorDesconexion>string</DescripcionErrorDesconexion>
<FechaInicioDesconexion>dateTime</FechaInicioDesconexion>
<FechaFinDesconexion>dateTime</FechaFinDesconexion>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaLecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</ListaLecturas>
</ResultadoDesconexionMedidor>
<ResultadoDesconexionMedidor>
<Medidor>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ResultadoDesconexion>OK or ERROR</ResultadoDesconexion>
<CodigoErrorDesconexion>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorDesconexion>
<DescripcionErrorDesconexion>string</DescripcionErrorDesconexion>
<FechaInicioDesconexion>dateTime</FechaInicioDesconexion>
<FechaFinDesconexion>dateTime</FechaFinDesconexion>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaLecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</ListaLecturas>
</ResultadoDesconexionMedidor>
</listaResultados>
</RecibirDesconexiones>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RecibirDesconexiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Consideraciones
1) Retries.- In relation to the disconnection of meters, in case that the response of
method wsKAVICentinel.RecibirDesconexiones or the method
wsSIGAMI.DesconectarMedidores is not satisfactory, the request retry mechanism
must be implemented, the number of retries and the time interval must be
configurable until a satisfactory response is obtained or exhaust the number of
retries. Each failed retry should generate its corresponding record in an error log
that allows identifying the source of the error. For each meter that has not been
possible to disconnect, the fields must be used
ResultadosOperacionDesconexion, CodigoErrorDesconexion and
DescripcionErrorDesconexion.
2) Refer to point F. Considerations with sending emails.
3) The system must implement a mechanism to perform manual forwarding of said
requests
4) Disconnection Retries.- In the cases in which SIG-AMI cannot successfully
disconnect the meter, it must implement an internal mechanism to repeat
disconnection attempts, to ensure the
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
KAVICentinel will use the method ReconectarMedidores from the web service
wsSIGAMI from SIG-AMI, which will confirm if the request was received
satisfactorily. Asynchronously, the SIG-AMI will return the result of the requested
reconnection to the system KAVICentinel using the method RecibirReconexiones
from the web service wsKAVICentinel.
The security of the method will be implemented through the authentication header
requesting user and password that CFE will design to SIG-AMI in an individual manner
and must evaluate that the request made comes from the KaviCentinel. In the same
way the Web Service wsKaviCentinel will require that the SIG-AMI authenticate with
the same mechanism but with another user and password different from the main
ones.
a. DIAGRAMA
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ReconectarMedidores
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService wsSIGAMI
Method: ReconectarMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<ReconectarMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<ReconectarMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</ReconectarMedidoresResult>
</ReconectarMedidoresResponse>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RecibirReconexiones
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionErrorDesconexion>string</DescripcionErrorDesconexion>
<FechaInicioDesconexion>dateTime</FechaInicioDesconexion>
<FechaFinDesconexion>dateTime</FechaFinDesconexion>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaLecturas>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
<DescripcionErrorDesconexion>string</DescripcionErrorDesconexion>
<FechaInicioDesconexion>dateTime</FechaInicioDesconexion>
<FechaFinDesconexion>dateTime</FechaFinDesconexion>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaLecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</ListaLecturas>
</ResultadoDesconexionMedidor>
</listaResultados>
</RecibirDesconexiones>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RecibirReconexiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Considerations
1) Retries.- In relation to the reconnection of meters, in case the method response
wsKAVICentinel.RecibirReconexiones or the method
wsSIGAMI.ReconectarMedidores is not satisfactory, the request retry mechanism
must be implemented, the number of retries and the time interval must be
configurable until a satisfactory response is obtained or exhaust the number of
retries. Each failed retry should generate its corresponding record in an error log
that allows identifying the source of the error. For each meter that reconnection
was not possible, the fields should be used ResultadoReconexionMedidor,
CodigoErrorReconexion and DescripcionErrorReconexion.
2) Refer to point F. Considerations with sending emails.
3) The system must implement a mechanism to perform manual forwarding of such
requests.
4) Reconnection retries.- In the cases in which the system SIG-AMI cannot
successfully reconnect the meter, you must implement an internal mechanism for
the repetition of reconnection attempts, to guarantee the highest percentage of
effectiveness without affecting the maximum response time of the commands, so
that the KaviCentinel always receives a response from each message, whether
successful or failed. The Kavicentinel will implement your forwarding only of
requests that arrive with error and with the same request ID.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ObtenerEventosMedidor
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService wsSIGAMI
Method: ObtenerEventosMedidor
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService: wsKAVICentinel
Method: RecibirEventos
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionErrorExtraccionEventos>string</DescripcionErrorExtraccionEv
entos>
<FechaInicioExtraccionEventos>dateTime</FechaInicioExtraccionEventos>
<FechaFinExtraccionEventos>dateTime</FechaFinExtraccionEventos>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<ListaEventosMedidor>
<EventoMedidor>
<CodigoEventoCFE>int</CodigoEventoCFE>
<CodigoEventoSigAmi>string</CodigoEventoSigAmi>
<DescripcionEventoSigAmi>string</DescripcionEventoSigAmi>
<FechaEventoSigAmi>dateTime</FechaEventoSigAmi>
</EventoMedidor>
<EventoMedidor>
<CodigoEventoCFE>int</CodigoEventoCFE>
<CodigoEventoSigAmi>string</CodigoEventoSigAmi>
<DescripcionEventoSigAmi>string</DescripcionEventoSigAmi>
<FechaEventoSigAmi>dateTime</FechaEventoSigAmi>
</EventoMedidor>
</ListaEventosMedidor>
<ListaLecturas>
<Lectura>
<Tipo>ConsumoTotal or ConsumoFase1 or ConsumoFase2 or
ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
WebService: wsKAVICentinel
Method: RecibirEventos
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Considerations
1) Retries.- Regarding the extraction of meter events, in case the method response
wsKAVICentinel.RecibirEventos or the method
wsSIGAMI.ObtenerEventosMedidor is not satisfactory, the request retry
mechanism must be implemented, the number of retries and the time interval
must be configurable until a satisfactory response is obtained or the number of
retries is exhausted. Each failed retry should generate its corresponding record in
an error log that allows identifying the source of the error. For each meter that has
not been possible to extract events,
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
KAVICentinel will use the method ConsultarDatosMedidores from the web service
wsSIGAMI of SIG-AMI, which will confirm if the request was received in a
satisfactory manner. Asynchronously, the SIG-AMI will return the result of the data
consulted to the system KAVICentinel using the method RecibirDatosMedidores from
web service wsKAVICentinel.
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ConsultarDatosMedidores
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService wsSIGAMI
Method: ConsultarDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService: wsKAVICentinel
Method: RecibirDatosMedidores
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<RecibirDatosMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaDatosMedidor>
<DatosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>string</CodigoMedidor>
<LoteMedidor>string</LoteMedidor>
<Marca>string</Marca>
<Modelo>string</Modelo>
<VersionFirmware>string</VersionFirmware>
<Latitud>float</Latitud>
<Longitud>float</Longitud>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<FechaHoraRegistro>dateTime</FechaHoraRegistro>
<Lecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</Lecturas>
</DatosMedidor>
<DatosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>string</CodigoMedidor>
<LoteMedidor>string</LoteMedidor>
<Marca>string</Marca>
<Modelo>string</Modelo>
<VersionFirmware>string</VersionFirmware>
<Latitud>float</Latitud>
<Longitud>float</Longitud>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<FechaHoraRegistro>dateTime</FechaHoraRegistro>
<ListaLecturas>
<Lectura xsi:nil="true" />
<Lectura xsi:nil="true" />
</ListaLecturas>
</DatosMedidor>
</listaDatosMedidor>
</RecibirDatosMedidores>
</soap12:Body>
</soap12:Envelope>
If one or more of the meters are not in the SIGAMI Database, the answer for each of these must
have the following sample format:
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<RecibirDatosMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaDatosMedidor>
<DatosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>Desconocido</CodigoMedidor>
<LoteMedidor>Desconocido</LoteMedidor>
<Marca>Desconocido</Marca>
<Modelo>Desconocido</Modelo>
<VersionFirmware>Desconocido</VersionFirmware>
<Latitud>0</Latitud>
<Longitud>0</Longitud>
<EstadoRelevador>Desconocido</EstadoRelevador>
<EstadoMedidor>Inactivo</EstadoMedidor>
<FechaHoraRegistro>dateTime</FechaHoraRegistro>
<Lecturas>
</Lecturas>
</DatosMedidor>
</listaDatosMedidor>
</RecibirDatosMedidores>
</soap12:Body>
</soap12:Envelope>
The DateRegistration Date corresponds to the date on which the search was performed.
WebService: wsKAVICentinel
Method: RecibirDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
</soap12:Body>
</soap12:Envelope>
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ActualizarDatosMedidores
Definition SOAP Request:
POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<LoteMedidor>string</LoteMedidor>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<Cliente>
<Rpu>string</Rpu>
<Nombre>string</Nombre>
<Direccion>string</Direccion>
<Cuenta>string</Cuenta>
<Tarifa>string</Tarifa>
<NumeroHilos>int</NumeroHilos>
<DemandaContratada>float</DemandaContratada>
<EsBidireccional>boolean</EsBidireccional>
</Cliente>
<ReiniciarContadores>boolean</ReiniciarContadores>
</DatosParaActualizarMedidor>
<DatosParaActualizarMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>string</CodigoMedidor>
<LoteMedidor>string</LoteMedidor>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<Cliente>
<Rpu>string</Rpu>
<Nombre>string</Nombre>
<Direccion>string</Direccion>
<Cuenta>string</Cuenta>
<Tarifa>string</Tarifa>
<NumeroHilos>int</NumeroHilos>
<DemandaContratada>float</DemandaContratada>
<EsBidireccional>boolean</EsBidireccional>
</Cliente>
<ReiniciarContadores>boolean</ReiniciarContadores>
</DatosParaActualizarMedidor>
</listaDatosMedidores>
</ActualizarDatosMedidores>
</soap12:Body>
</soap12:Envelope>
WebService wsSIGAMI
Method: ActualizarDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
WebService: wsKAVICentinel
Method: RecibirConfirmacionActualizacionDatosMedidores
Definition SOAP Request:
POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionErrorActualizacion>string</DescripcionErrorActualizacion>
<FechaActualizacion>dateTime</FechaActualizacion>
</ConfirmacionActualizacionDatosMedidor>
<ConfirmacionActualizacionDatosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ResultadoActualizacion>OK or ERROR</ResultadoActualizacion>
<CodigoErrorActualizacion>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorActualizacion>
<DescripcionErrorActualizacion>string</DescripcionErrorActualizacion>
<FechaActualizacion>dateTime</FechaActualizacion>
</ConfirmacionActualizacionDatosMedidor>
</listaConfirmaciones>
</RecibirConfirmacionActualizacionDatosMedidores>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
WebService: wsKAVICentinel
Method: RecibirConfirmacionActualizacionDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Considerations
1) Retries.- Regarding the update of meter data, in case the method response
wsKAVICentinel.RecibirConfirmarcionActualizacionDatosMedidores or the
method wsSIGAMI.ActualizarDatosMedidores is not satisfactory, the request retry
mechanism must be implemented, the number of retries and the time interval
must be configurable until a satisfactory response is obtained or the number of
retries is exhausted. Each failed retry should generate its corresponding record in
an error log that allows identifying the source of the error. For each meter that
has not been possible to update data, the fields should be used
ResultadoActualizacion, CodigoErrorActualizacion and
DescripcionErrorActualizacion.
2) Refer to point F. Considerations with sending emails.
3) The system must implement a mechanism to perform manual forwarding of said
requests.
4) If in the request to update meters from KAVICentinel to the wsSIGAMI web service,
the data of one or more meters does not exist in the SIG-AMI database, it must be
able to create the new records of the meters.
5) Update Retries of Meter Data : In cases where the SIG-AMI system cannot
satisfactorily update the meter data, It must implement an internal mechanism for
repetition of update attempts, to ensure the highest percentage of effectiveness
without being affected the performance of the system should avoid consuming
excessive time for these retries for consideration of each SIG-AMI, so that the
KaviCentinel always receives a response from each message, whether successful or
failed. The Kavicentinel implements its rejection only of requests that arrive with
error and with the same request ID.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
c. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
d. COMMAND STRUCTURE
WebService: wsKAVICentinel
Method: RegistrarAlarmaMedidor
Definition SOAP Request:
WebService: wsKAVICentinel
Method: RegistrarAlarmaMedidor
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Considerations
1) Retries.- Regarding the alarm log of the meters, in case the method response
wsKAVICentinel.RegistrarAlarmaMedidor is not satisfactory, the request retry
mechanism must be implemented, the number of retries and the time interval
being configurable until a satisfactory response is obtained or the number of
retries is exhausted. Each failed retry should generate its corresponding record in
an error log that allows identifying the source of the error. For each alarm that
has not been possible to register, the following fields must be used
ResultadoActualizacion, CodigoErrorActualizacion and
DescripcionErrorActualizacion.
2) Refer to point F. Considerations with sending emails.
3) The system must implement a mechanism to perform manual forwarding of said
requests.
4) If the alarm generated involves several meters of the same route, the SIG-AMI
system must implement the mechanism to make a single report, which includes all
affected meters in the array.
e. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
f. COMMAND STRUCTURE
WebService: wsKAVICentinel
Method: RegistrarNuevoMedidor
Definition SOAP Request:
<Marca>string</Marca>
<Modelo>string</Modelo>
<VersionFirmware>string</VersionFirmware>
<Latitud>float</Latitud>
<Longitud>float</Longitud>
<EstadoRelevador>Abierto or Cerrado or SinRelevador or
Desconocido</EstadoRelevador>
<EstadoMedidor>Activo or Inactivo or Baja</EstadoMedidor>
<FechaHoraRegistro>dateTime</FechaHoraRegistro>
<ListaLecturas>
<Lectura>
<Tipo>ConsumoTotal or ConsumoFase1 or ConsumoFase2 or
ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
ConsumoEnergiaEntregada or ConsumoEnergiaRecibida or DemandaMaxima or
Reactivos</Tipo>
<Valor>float</Valor>
</Lectura>
<Lectura>
<Tipo>ConsumoTotal or ConsumoFase1 or ConsumoFase2 or
ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
ConsumoEnergiaEntregada or ConsumoEnergiaRecibida or DemandaMaxima or
Reactivos</Tipo>
<Valor>float</Valor>
</Lectura>
</ListaLecturas>
</datosMedidor>
<idSigAmi>int</idSigAmi>
</RegistrarNuevoMedidor>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: RegistrarNuevoMedidor
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
c. Considerations
1) Retries.- In relation to the registration of new meter, in case the method response
wsKAVICentinel.RegistrarNuevoMedidor is not satisfactory, the request retry
mechanism must be implemented, the number of retries and the time interval
must be configurable until a satisfactory response is obtained or the number of
retries is exhausted. Each failed retry should generate its corresponding record in
an error log that allows identifying the source of the error.
2) Refer to point F. Considerations with sending emails.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ConsultarEstadoPeticiones
Definition SOAP Request:
WebService wsSIGAMI
Method: ConsultarEstadoPeticiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
KAVICentinel will use the method ComprobarEstadoServicios from the web service
wsSIGAMI from SIG-AMI, which will return if the services are available or with
problems before sending requests. In the same way the SIG-AMI will use the method
ComprobarEstadoServicios from web service wsKAVICentinel, which will return if
the services are available or with problems before attempting to send data.
a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI
b. COMMAND STRUCTURE
WebService: wsSIGAMI
Method: ComprobarEstadoServicios
Definition SOAP Request:
WebService wsSIGAMI
Method: ComprobarEstadoServicios
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionProblemaEnServicios>string</DescripcionProblemaEnServicios>
</ComprobarEstadoServiciosResult>
</ComprobarEstadoServiciosResponse>
</soap12:Body>
</soap12:Envelope>
WebService: wsKAVICentinel
Method: ComprobarEstadoServicios
Definition SOAP Request:
<soap12:Body>
<ComprobarEstadoServicios xmlns="http://www.cfe.gob.mx/">
<idSigAmi>int</idSigAmi>
</ComprobarEstadoServicios>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
WebService: wsKAVICeninel
Method: ComprobarEstadoServicios
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<DescripcionProblemaEnServicios>string</DescripcionProblemaEnServicios>
</ComprobarEstadoServiciosResult>
</ComprobarEstadoServiciosResponse>
</soap12:Body>
</soap12:Envelope>
Start
Receive
Server reading
Select FTP request
routes for
taking of
reading
Process
Data conversion Information
NO Is it a
telemeter process
route?
SI
Database Look for readings in
the database of
Processes the data group of meters
Reading requests
to build the
reading request Database
Sends archives
through
Receive the
ftp to KAVICentinel response and Send results
process the Use
reading data wsKAVICentinel,
Method
RecibirLecturas.
Reading archives
for billing
Send archives
Billing through
processing ftp to SICOM
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start Receives
Receive request reading request
from
online
Request reading online reading
of meter online
for finiquito
Obtain
Reading request meter reading
online
NO Is it a
telemeter?
Send request.
End SI Use wsSIGAMI, method Generates result
LeerMedidores, with parameter
Requests reading LecturaEnLinea = true
of meter online
Reading result
HTTP Receive
result
reading
online
Receive result
and evaluate
Sends results.
Data Use wsKAVICentinel,
Send reading Method RecibirLecturas.
base
result to SICOM
NO Satisfactory
Calculate reading?
settlement FTP Receives
amount manual Server disconnection
SI
request
Calculate
settlement
amount automatic Perform
disconnection
Process of meter
data conversion
Is settlement
amount
accepted? Generate result
READING
NO Receive
YES Disconnection response request
request from
Formalize Disconnection request S06
settlement result
NO Satisfactory
Archive with YES
meter information disconnection?
for disconnection
Invoke CGI Sicoss Invoke CGI Sicoss
to generate S06 to generate S06
Pending Finished
Send archive
through Send result
ftp to KAVICentinel HTTP
Process result
Database
End
Start FTP
Server Receive request
Receive data and process
from disconnection
Select
route services to be cut
Processing of
data conversion Process Record the
Information information
Is it a
telemeter Database
NO
route?
Disconnection Database
End YES request
Proceed with
disconnections
Process the data Generate result
to build the with SCD
cut request Database
Send request using
wsSIGAMI, method
DesconectarMedidores
Archives with Results of the
information from disconnections Send results to
meters KAVICentinel HTTP
Receive the
response and
process the data
Send archives of disconnections Send results, consume
through wsKAVICentinel method
RecibirDesconexiones
ftp to KAVICentinel
Satisfactory
disconnection?
NO YES
Database of disconnection
HTTP
End
Database
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start FTP
Server Receive Receive
reconnection register request
result from
Debit payment request SC7
Process the
data conversion Generate Register
Changes status of meter request SC7
service from Cut
reconnection
to Active and verify
meter
Reconnection
request
Generate result Database
NO
Is it telemeter
meter? Send request.
Use wsSIGAMI,
End Reconnection
method Request SC7
YES ReconectarMedidores result
Receive
result
Process result
RECONEXION
Data base
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
UPDATE METER DATA IN THE SIG-AMI DATA BASE OR REPORT METER TO KAVICENTINEL
Start FTP
Receive request to
Server update meter data
New service is
A connection registered with
order is registered new meter
Process the Database
Metodo ActualizarDatosMedidores/RecibirConfirmacionActualizaciónDatosMedidores
CHANGE OF METERS
Start
Process response
Send archive through
ftp to KAVICentinel
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start
Receive Alarm
Report Read request
Generate event
meter: Retire the and begin
meter from its base search
Database
Database
Invoke socket-CGI
Generate new
order (SMC)
SI
Delivery result
from order number
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
HIGH VOLTAGE
KAVI Centinel SIG-AMI SICOSS
Start
Database
Process data. Criterion: 1 Generate new command
service(Q02). according to criteria.
Greater than 1 per route (Q02-1 service per route
Use ws:soap x)
(Q07)
wsKAVICentinel (Q07 -Greater than 1
per route x)
Method:
RegistrarAlarmaMedidor
Receive
result and Invoke URL and
process send data to
data KaviCentinel
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start
Read request
and begin
Receive alarm Generate event search
report meter: Inverse energy
flow
Database
Database
Is it
Process data Database
Bidirectional?
SI
End
NO Existing previous
Use ws:soap order (SM*, Q0*) with
wsKAVICentinel status 1, W, 2, 3 NO
Method:
RegistrarAlarmaMedidor
Generate new
Invoke socket-CGI command (SMC)
SI
Delivery result
from order number
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start
Receive alarm Read request and start
report search
Generate event meter:
Cabinet door
open door
Database
Database
Database
Process data
Use ws:soap
wsKAVICentinel
Method: Previous existing
RegistrarAlarmaMedidor
order (SMS) with
Select one meter status 1, W, 2, 3 NO
from list of meters
Generate new
order (SMS)
SI
Invoke socket-CGI
Delivery result
from order number
Receive
Invoke URL and
result and
process send data to
data KaviCentinel
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Start
Read petition
Receive alarm and start
report search
Generate event meter:
Fatal meter erros
Database
Database
Invoke socket-CGI
Generate new
SI order (SM3)
Deliver result
from order number
Receive
results Invoke URL and send
and process data to KaviCentinel
data
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
LOW BATTERY
KAVI Centinel SIG-AMI SICOSS
Start
Database
Database
Generate new
SI order (SM3)
Deliver result
from order number
Receive
result and Invoke URL and
process send data to
data KaviCentinel
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
RESET COUNTERS
KAVI Centinel SIG-AMI SICOSS
Start
Read request
Receive Alarm and start
Report Generate meter search
event: Restart
counters
Base de
Datos
Database
Database
Process data.
Use ws:soap
wsKAVICentinel
Method:
RegistrarAlarmaMedidor
Invoka socket-CGI
Previous existing
order (SMC) with NO
status 1, W, 2, 3
Generate new
order (SMC)
SI
Deliver result
from order number
Receive
result and Invoke URL and
process send data to
data KaviCentinel
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
OVER-DEMAND DETECTION
KAVI Centinel SIG-AMI SICOSS
Start
Receive Alarm
Report Generate meter Read request and start
event: Detection search
sobreDemanda
Database
Database
Database
Process data
Use ws:soap
wsKAVICentinel
Method:
RegistrarAlarmaMedidor
Previous existing
Invoke socket-CGI order (SMD) con NO
status 1, W, 2, 3
Generate new
SI order (SMD)
Deliver result
from order number
Process result
End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION
Reactivos
RespuestasPeticion OK Indicates that the request
could be received and it was
possible to process it.
ERROR Indica que la petición no pudo
ser recibida.
ResultadosOperacionMedidor OK Indica que la operación
ejecutada por cada medidor
fue satisfactoria.
ERROR Indica que ocurrió un error al
ejecutar la operación en el
medidor.
CodigosErrorPeticion Ninguno No error.
BaseDeDatosNoDisponible There is a problem in the
Database that prevents
processing requests.
ErrorEscrituraEnDisco There is an error on the disk
preventing processing requests.
MemoriaInsufuciente The memory in use exceeds
the server's ability to handle
the request.
TamanioPeticionFueraLimite The request received exceeds
the maximum number of
meters.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION