Download as pdf or txt
Download as pdf or txt
You are on page 1of 72

FEDERAL ELECTRICITY COMMISSION

SUB-DIRECTION OF DISTRIBUTION

REVISION: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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:

Type of Readings Code


Consumer 1 1
Consumer 2 2
Consumer 3 3
Demand 4
Reagents 5

Reach by Rates and type of Readings to be obtained by meter:

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

REVISION: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Unidirectional read type combinations


M = represents Measurer

Consumer1 Consumer2 Consumer3 Demand Reagent


Single-phase M1
Dual-phase M1
(Forms 12S, 16S,
Wh totals)
Dual-phase M1 M2
(Arrangement,multip
hase, type cabinet,
Wh totals)
Three-phase(Forms M1
12S, 16S, Wh totals)

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.

Combinations of type of readings for Bidirectional


M = represents Measurer

Energy Energy received Demand Reagent


delivered
Single-phase M1 M1
Dual-phase M1 M1
(Forms 12S, 16S,
Wh totals)
Three-phase M1 M1
(Forms 12S, 16S,
Wh totals)
Dual-phase MEQ MEQ
(Arrangement,multi
phase, type cabinet,
Wh totals)
M1 + M2 = MEQ

Three-phase MEQ MEQ


(Arrangement,multi
phase , type
cabinet, Wh totals)
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISION: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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.

General requirements for readings


• If it is a multiphase arrangement, the sum of the arrangement meters for Energy
delivered and Energy received is required.
• The readings of consumption1, consumption2 and consumption3 (Wh).
• The maximum demand reading (Watt).
• The reagent reading (VArh).

Combinations for disconnections and single-phase and multi-phase connections


M = Represents Meter
FASE 1 FASE 2 FASE 3
Single-phase M1
Dual-phase M1 M1
(Forms 12S, 16S,
Wh totals)
Three-phase(Forms M1 M1 M1
12S, 16S, Wh totals)

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

REVISION: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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.

Hourly rate Different consumption readings in kilowatt-hours, kVarhours and


demands in kilowatt classified for hourly periods.
RPU Permanent user registration.
XML Extensible Markup Language File
WebServices Web service that contains the methods for executing the commands
for the interface between SIG-AMI and KaviCentinel.
Reading Calendar Scheduled task for SIG-AMI, where the date that some specific
work will be done is indicated.
Meter number Unique number of meter assigned by CFE.
Self Container Meter with the ability to measure directly, without the need for
Meter auxiliary transformers.
Route Sequence of continuous services for reading and distribution of
notice-receipt.
Cycle Route set
Current reading Meter reading at the time of interrogation.
N/A Does not apply
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

B. Description for error messages


Error Messages Condition to fulfill
Ninguno The operation was successful
MedidorNoEncontrado The meter is not registered in the database of the
SIG-AMI
MedidorSinComunicacion The meter is not registered in the database of the
SIG-AMI, but has no communication at the time
of the command execution (applies for real time
reading of the meter, Readings per group of
meters, No connection of meter group,
Real-time reconnection of a meter, Meter group
reconnection, Event Extraction).

ErrorEnFirmware The commands sent by SIG-AMI could not


be executed by the meter due to incompatibility in
its firmware.
TiempoDeEsperaAgotado The meter is in the database of the SIG-AMI and
was in communication before the time of the
request, However, when sending the transaction,
no response was obtained.
(Applies for real time readings of a meter,Readings
per meter group, No connection of meter group,
Real-time reconnection of a meter, Meter group
reconnection, Event Extraction).

LecturaMedidorFueraDeLimite When the date of the reading to be extracted from


the Database of the SIG-AMI is greater than the
days set in the parameter
<limiteDiasAntiguedadLectura>
ErrorDePermisos When Applies.
When a command could not be executed on the
meter because it did not have the required
permissions (be called security encrypted files,
security keys, tokens or password).
MedidorDuplicado When Applies.
When there is duplication of a meter number in
the Database ofl SIG-AMI or physically
programmed with the same ID, more than 1 meter.
MedidorSinRelevador The SIG-AMI will answer, when the request for
disconnection of the meter group, real-time
reconnection of a meter or reconnection of
the meter group, is made to a meter which
does not have a relay.
OtrosErrores Applies for any error not considered in this table
of contents.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

The SIG-AMI will return a description of


the error occurred in the field
DescripcionError of the corresponding command.
The description must be sent in Spanish.

C. Description of the enumeration values StatusMeter :


Value Description
Activo Meter assigned to a customer with a valid
contract.
Inactivo Meter that runs without a customer and
continues in the database of the SIG-AMI.
This meter can be associated with a new
customer and return to the value of Active.
(It refers to any meter that is removed from the
base and will be allowed to be reusable)
Baja Meter that runs without a customer and continues in
the database of the SIG-AMI for traceability and this
meter cannot be associated with a new customer
because it is found in meter theft, scrap meter or
physically damaged.
(It refers to any meter that is removed from the base for
being damaged or lost, it will already be allowed to be
reusable)

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

D. Description of the values of the enumeration StatusRequest of the requests made


to SIG-AMI :

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Desconocido The SIG-AMI cannot determine the status


of the request consulted.
EnReintento This status is exclusive use for CFE, it is not
expected to receive this value from the
SIG-AMI.
SinDatos This status is exclusive use for CFE, it is not
expected to receive this value from the
SIG-AMI.
Incompleta This status is exclusive use for CFE, it is not
expected to receive this value from the
SIG-AMI.

Command Execution Hierarchy


Type of executions Commands Priority
Real Time Executions Real-time reconnection of a meter 1

Real Time Executions Real-time disconnection of a meter 2

Real Time Executions Real-time reading of a meter 3


Executions scheduled by task Reading by task by group of meters 4

Executions scheduled by task Task disconnection per meter group 5

E. Considerations with sending emails



If upon reaching the maximum number of retries the request could not be completed,
The system will send a notification via email, informing the user of the unfinished
requests and the reasons why they could not be satisfactory. The email addresses will
be configurable and a screen must be available to register the emails with at least the
following data to request:
▪ Name
▪ Last Name
▪ Email Address
▪ Box to enable or disable email sending
▪ Type of user, cataloged as: computer specialist
• In the case of the SIG-AMI, will send another type of mail, it is requested that
everything related to services between KaviCentinel and the SIG-AMI, it is solely and
exclusively cataloged as computerized.
• A specific list should be implemented, because they are situations that are in the
computer specialist.
• The sending of emails, cataloged as informatics, applies to all commands, when the
maximum number of retries of command requests has been reached.
F. General requirements for interface operation.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

• 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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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)

or the following case may be presented:

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

G. Operation scheme between interfaces of the SIG-AMI and KaviCentinel System

wsKAVICentinel

wsSIGAMI
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description, operation and testing of the Computer Management System (SIG-AMI)


and KaviCentinel commands.

1. COMMANDS FOR THE READING OF A METER OR GROUP OF METERS (ONLINE OR BY


SCHEDULED TASK).
KAVICentinel will use the method LeerMedidores 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 requested readings to the
system KAVICentinel using the method RecibirLecturas from the web service
wsKAVICentinel.
Method security is implemented through the authentication header asking the user
and password that CFE will design to SIG-AMI in an individual manner and should
evaluate that the request made is from the KAVICentinel. In the same way the Web
Service wsKaviCentinel will require that the SIG-AMI authenticates itsef with the same
mechanism but with another user and password different than the initial.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<LeerMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaPeticionesLectura>
<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
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

ConsumoEnergiaEntregada or ConsumoEnergiaRecibida or DemandaMaxima or


Reactivos</TiposLectura>
</ListaTiposLectura>
</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>
</listaPeticionesLectura>
<lecturaEnLinea>boolean</lecturaEnLinea>
<limiteDiasAntiguedadLectura>int</limiteDiasAntiguedadLectura>
</LeerMedidores>
</soap12:Body>
</soap12:Envelope>

Description of the input parameters:


Parameter Description Type of data Longitude
idPeticion Identifier of the petición initiated by string 18
KAVICentinel. Will be occupied by the
SIG-AMI to send the response after
processing the request
NumeroMedidor Identifier of the meter from which the string 6
reading is required
(official for CFE, comes in meter plate)
ListaTiposLectura List of reading types required by each List<enum>
meter
lecturaEnLinea Flag indicating if the reading will be boolean
obtained in real time, or the most
recent stored reading will be
retrieved by each meter
limiteDiasAntiguedadLectura Indicates the maximum number of days int
of the reading retrieved by each meter
when lecturaEnLinea is equal to FALSE,
otherwise, this value will be ignored.

WebService: wsSIGAMI
Method: LeerMedidores
Definition SOAP Response:
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<LeerMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<LeerMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</LeerMedidoresResult>
</LeerMedidoresResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of conditions for command LeerMedidores

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirLecturas xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaResultados>
<ResultadoLecturasMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ResultadoOperacion>OK or ERROR</ResultadoOperacion>
<CodigoErrorLectura>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorLectura>
<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>
<ResultadoLecturasMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ResultadoOperacion>OK or ERROR</ResultadoOperacion>
<CodigoErrorLectura>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorLectura>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Descriptions of parameters for input:


Paramtere Description Type of data Longitude
IdPeticion Identifier of the read request initiated string 18
by KAVICentinel when using the
LeerMedidor method of the
wsSIGAMI web service
NumeroMedidor Meter identifier from which the string 6
reading was obtained
ResultadoOperacion Indicator of result from the reading enum

CodigoErrorLectura Motive for which the extraction of enum


the reading could not be satisfactory
DescripcionErrorLectura Detailed description of the error that string 100
impeded the extraction of the reading
FechaInicioLectura Date and time of start of the process of datetime
the actual meter reading
FechaFinLectura Date and time of the end of the datetime
process of the actual meter reading
EstadoRelevador Status of how the meter relay is enum
located, for the types of meters with
remote disconnection

EstadoMedidor Status of meter in the SIG-AMI enum


ListaLecturas List of the readings requested by List<Lectura>
each meter
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

DemandaReseteada Indicates if the reset of demand was boolean


successful or not
NumeroResetsDemanda Accumulator with demand reset int
number
CodigoErrorResetDemanda Reason why demand extraction enum
could not be satisfactory

WebService: wsKAVICentinel
Method: RecibirLecturas
Definition SOAP Response:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirLecturasResponse xmlns="http://www.cfe.gob.mx//">
<RecibirLecturasResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirLecturasResult>
</RecibirLecturasResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

2) Refer to point F. Considerations with sending emails.


3) The system must implement a mechanism to perform manual forwarding of said requests.
4) Retries of reading online.- In the cases where SIG-AMI cannot perform the online meter
reading successfully, it should implement an internal mechanism of repetition of reading
attempts, to guarantee the highest percentage of effectiveness of the command; The
maximum response time must be avoided, so that the KaviCentinel always receives a
response of every message whether it was successful or a failure. The KaviCentinel will
implement your rejection only of requests that arrive with error and with the same request
ID.
5) Demand.- During the call of the method wsSIGAMI.LeerMedidores, the property
ResultadoLecturaDemanda of object ResultadoLecturasMedidor must contain the values
corresponding to:
i. DemandaReseteada, indicating if it was possible or not to reset the demand.
ii. CodigoErrorResetDemanda, in cases where it is not possible to reset the claim, it will
indicate the error occurred, according to the enumeration CodigosErrorMedidor.
iii. NumeroResetsDemanda, which will indicate the accumulated resets that have been
made on the meter. This property will only have values when the type of reading
requested includes the type TiposLectura.DemandaMaxima, In any other case, this
value must be null.

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.

6) Online reading.- In the method wsSIGAMI.LeerMedidores, when the parameter


lecturaEnLinea is true, the requested readings must be taken at that time from the meter,
and the value of parameter limiteDiasAntiguedadLectura should be ignored, in the case
of not being able to obtain the reading online, the fields
ResultadosOperacionMedidor, CodigoErrorLectura y DescripcionErrorLectura should be
used.
i. If lecturaEnLinea is false, the readings will be obtained from the history
stored in the database, based on the parameter limiteDiasAntiguedadLectura.
ii. When bringing the database readings (for the cases in which the parameter
lecturaEnLinea is false), the most recent meter reading should be obtained,
provided that the date of the reading is between the current date and the date
resulting from subtracting the days specified in the parameter
limiteDiasAntiguedadLectura. If no readings are found that meet the criteria of
previous days, the result of reading that meter in the response result array will
not be omitted, but it will be specified what was the cause for why it was not
possible to recover the readings for that meter (the fields
ResultadosOperacionMedidor, CodigoErrorLectura y DescripcionErrorLectura
should be used).
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

2. COMMANDS FOR DISCONNECTING A METER OR GROUP OF METERS


KAVICentinel will use the method DesconectarMedidores from the web service
wsSIGAMI of SIG-AMI, which will confirm if the request was received satisfactorily.
Asynchronously, the SIG-AMI will return the result of the requested disconnections to
the system KAVICentinel using the method RecibirDesconexiones of 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. 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

<?xml version="1.0" encoding="utf-8"?>


<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>
<DesconectarMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaMedidores>
<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>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

</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>

Description of input parameters:


Parameter Description Type of data Longitude
idPeticion Request identifier initiated by string 18
KAVICentinel. willbe occupied by the SIG-
AMI to send the response after processing
the request.
NumeroMedidor Meter identifier from which string 6
disconnection is required
(official for CFE, comes in meter plate)
ListaTiposLectura List of reading types required by each List<enum>
meter

WebService wsSIGAMI
Method: DesconectarMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<DesconectarMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<DesconectarMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</DesconectarMedidoresResult>
</DesconectarMedidoresResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirDesconexiones xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaResultados>
<ResultadoDesconexionMedidor>
<Medidor>
<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>
<ResultadoDesconexionMedidor>
<Medidor>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Description of input parameters:


Parameter Description Type of data Longitude
IdPeticion Identifier of the disconnection request string 18
initiated by
KAVICentinel when using the method
DesconectarMedidores from web
service wsSIGAMI
NumeroMedidor Meter identifier string 6
disconnected
ResultadoDesconexion Meter disconnection result enum
indicator
CodigoErrorDesconexion Reason why the disconnection enum
could not be successful
DescripcionErrorDesconexion Detailed description of the error string 100
that prevented the disconnection.
FechaInicioDesconexion Start date and time of datetime
meter disconnection
FechaFinDesconexion End date and time of datetime
meter disconnection
EstadoRelevador Status of how the meter relay is enum
located, for the types of meters with
remote disconnection

EstadoMedidor Status of the meter in the SIG-AMI enum


ListaLecturas List of readings requested by each List<Lectura>
meter
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

WebService: wsKAVICentinel
Method: RecibirDesconexiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirDesconexionesResponse xmlns="http://www.cfe.gob.mx//">
<RecibirDesconexionesResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirDesconexionesResult>
</RecibirDesconexionesResponse>
</soap12:Body>
</soap12:Envelope>

Description of the output values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

highest percentage of effectiveness if the maximum response time of the


commands is affected, such that the KaviCentinel always receive a response from
each message whether successful or failed. The Kavicentinel will implement your
resignation only from requests that arrive with error and with the same request ID.

3. COMMANDS FOR THE RECONNECTION OF A METER OR GROUP OF METERS

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<ReconectarMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaMedidores>
<PeticionOperacionMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ListaTiposLectura>
<TiposLectura>ConsumoTotal or ConsumoFase1 or ConsumoFase2
or ConsumoFase3 or ConsumoDiurno or ConsumoNocturno or
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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>
<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>
</ReconectarMedidores>
</soap12:Body>
</soap12:Envelope>

Description of input parameters:


Parameter Description Type of data Longitude
idPeticion Request identifier initiated by string 18
KAVICentinel. It will be occupied by the
SIG-AMI to send the response after
processing the request.
NumeroMedidor Meter identifier from which string 6
reconnection is required
(official for CFE, comes in meter plate)
ListaTiposLectura List of reading types required by each List<enum>
meter

WebService wsSIGAMI
Method: ReconectarMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirDesconexiones xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaResultados>
<ResultadoDesconexionMedidor>
<Medidor>
<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>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<Lectura xsi:nil="true" />


<Lectura xsi:nil="true" />
</ListaLecturas>
</ResultadoDesconexionMedidor>
<ResultadoDesconexionMedidor>
<Medidor>
<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>

Description of the input parameters:


Parameter Description Type of data Longitude
IdPeticion Identifier of the reconnection request string 18
initiated by
KAVICentinel when using the method
ReconectarMedidores of web service
wsSIGAMI
NumeroMedidor Reconnected meter string 6
identifier
ResultadoReconexion Meter reconnection result enum
indicator
CodigoErrorReconexion Reason why the reconnection enum
could not be satisfactory
DescripcionErrorReconexion Detailed description of the error string 100
that prevented reconnection.
FechaInicioReconexion Start date and time of DateTime
meter reconnection
FechaFinReconexion End date and time of DateTime
meter reconnection
EstadoRelevador Status of how the meter relay is enum
for the
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

types of meters with remote


reconnection
EstadoMedidor Status of the meter in the SIG- enum
AMI
ListaLecturas List of readings requested by each List<Lectura>
meter

WebService: wsKAVICentinel
Method: RecibirReconexiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirDesconexionesResponse xmlns="http://www.cfe.gob.mx//">
<RecibirDesconexionesResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirDesconexionesResult>
</RecibirDesconexionesResponse>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

4. COMMANDS FOR EXTRACTION OF EVENTS FROM A METER.

KAVICentinel will use the method ObtenerEventosMedidor from web service


wsSIGAMI from SIG-AMI, which will confirm if the request was received
satisfactorily. Asynchronously, the SIG-AMI will return the result of events extracted
from the meter to the system KAVICentinel will use the method RecibirEventos from
the web service wsKAVICentinel.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<ObtenerEventosMedidor xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<medidorAConsultar >
<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>
</medidorAConsultar >
<fechaDesde>dateTime</fechaDesde>
<fechaHasta>dateTime</fechaHasta>
</ObtenerEventosMedidor>
</soap12:Body>
</soap12:Envelope>

Description of input parameters:


FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Parameter Description Type of data Longitude


idPeticion Request identifier initiated by string 18
KAVICentinel. Will be occupied by SIG-
AMI to send the response after
processing the request.
NumeroMedidor Meter identifier of which reading is string 6
required (official for CFE, comes on
meter plate)
ListaTiposLectura List of reading types required by each List<enum>
meter
fechaDesde Initial date of the event search period DateTime

fechaHasta End date of the event search period DateTime

WebService wsSIGAMI
Method: ObtenerEventosMedidor
Definition SOAP Response:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ObtenerEventosMedidorResponse xmlns="http://www.cfe.gob.mx//">
<ObtenerEventosMedidorResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</ObtenerEventosMedidorResult>
</ObtenerEventosMedidorResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received successfully or enum
an error occurred.
CodigoError Indicates the code of the error occurred enum
upon receipt of the request.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirEventos xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<resultadoExtraerEventosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<ResultadoExtraccionEventos>OK or
ERROR</ResultadoExtraccionEventos>
<CodigoErrorExtraccionEventos>Ninguno or MedidorNoEncontrado or
MedidorSinComunicacion or ErrorEnFirmware or TiempoDeEsperaAgotado or
LecturaMedidorFueraDeLimite or ErrorDePermisos or MedidorDuplicado or
MedidorSinRelevador or OtrosErrores</CodigoErrorExtraccionEventos>

<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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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>
</resultadoExtraerEventosMedidor>
</RecibirEventos>
</soap12:Body>
</soap12:Envelope>

Description of the input parameters:


Parameter Description Type of data Longitude
idPeticion Request identifier string 18
initiated by
KAVICentinel. Will be
occupied by SIG-AMI to
send the response after
processing the request.

NumeroMedidor Number of meter that string 6


comes in meter plate
ResultadoExtraccionEventos Result generated by enum
performing the extraction
of events from the meter.
CodigoErrorExtraccionEventos Error code occurred in enum
event extraction.

DescripcionErrorExtraccionEventos Description of the error string 100


occurred in the extraction
of events.

FechaInicioExtraccionEventos Start date on which the DateTime


SIG-AMI starts the event
extraction command
FechaFinExtraccionEventos End date on which the DateTime
SIG-AMI starts the event
extraction command

EstadoRelevador Status of how the meter enum


relay is located, for the
types of
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

meters with remote


disconnection
EstadoMedidor Status of the meter in the enum
SIG-AMI
ListaEventosMedidor List of events extracted List<EventoMedior>
from the meter.
ListaLecturas List of meter readings List<Lectura>

WebService: wsKAVICentinel
Method: RecibirEventos
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirEventosResponse xmlns="http://www.cfe.gob.mx//">
<RecibirEventosResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirEventosResult>
</RecibirEventosResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received successfully or enum
an error occurred.
CodigoError Indicates the code of the error occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

they should use the fields CodigoErrorExtraccionEventos and ResultadoExtraccionEventos,


DescripcionErrorExtraccionEventos.
2) Refer to point F. Considerations with sending emails.
3) The system must implement a mechanism to perform manual forwarding of such
requests

5. COMMANDS TO CONSULT DATA OF METERS

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<ConsultarDatosMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaMedidores>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
</listaMedidores>
</ConsultarDatosMedidores>
</soap12:Body>
</soap12:Envelope>

Description of input parameters:


Parameter Description Type of data Longitude
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

idPeticion Request identifier initiated by KAVICentinel. string 18


It will be occupied by the SIG-AMI to send
the response after processing the request.

NumeroMedidor Meter identifier of which it is required to string 6


consult data

WebService wsSIGAMI
Method: ConsultarDatosMedidores
Definition SOAP Response:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ConsultarDatosMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<ConsultarDatosMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</ConsultarDatosMedidoresResult>
</ConsultarDatosMedidoresResponse>
</soap12:Body>
</soap12:Envelope>

Description of response values


Value Description Type of data Longitude
Respuesta Indicates if the request was received enum
successfully or an error occurred.
CodigoError Indicates the code of the error enum
occurred upon receipt of the
request.

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

<?xml version="1.0" encoding="utf-8"?>


FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Description of the input parameters:


Parameter Description Type of data Longitude
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

idPeticion Request identifier string 18


initiated by
KAVICentinel
NumeroMedidor Meter number that comes string 6
on the meter board
CodigoMedidor Meter code string 4
LoteMedidor Batch of the meter string 4
Marca Meter brand string 20
Modelo Meter model string 20
VersionFirmware Firmware version of string 30
the meter

Latitud Latitude value of float


geographic coordinates in
decimal degrees of the
meter location
Longitud Length value of the float
geographic coordinates in
decimal degrees of the
meter location
EstadoRelevador Status of how the meter enum
relay is located, for the
types of meters with
remote disconnection

EstadoMedidor Status of the meter in the enum


SIG-AMI
FechaHoraRegistro Date and time the DateTime
meter was registered
in the GIS-AMI
database
ListaLecturas List of readings requested List<Lectura>
by each meter.

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:

POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirDatosMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<RecibirDatosMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirDatosMedidoresResult>
</RecibirDatosMedidoresResponse>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

</soap12:Body>
</soap12:Envelope>

Description of response values


Value Description Type of data Longitude
Respuesta Indicates if the request was received successfully or enum
an error occurred.
CodigoError Indicates the code of the error occurred enum
upon receipt of the request.

6. COMMANDS TO UPDATE DATA OF THE METERS IN THE DATABASE OF SIG-AMI.

KAVICentinel will use the method ActualizarDatosMedidores from 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
updates to the system KAVICentinel, using the method
RecibirConfirmacionActualizacionDatosMedidores from web service
wsKAVICentinel.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<ActualizarDatosMedidores xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaDatosMedidores>
<DatosParaActualizarMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>string</CodigoMedidor>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Description of input parameters


Parameter Description Type of data Longitude
idPeticion Request identifier initiated by string 18
KAVICentinel. It will be occupied by the
SIG-AMI to send the response after
processing the request.
NumeroMedidor Meter identifier of which reading is string 6
required (official for CFE, comes on
meter plate)
CodigoMedidor Meter Code that comes on the meter string 4
board
LoteMedidor Lot code that comes on the meter string 4
board
EstadoMedidor Status of the meter in the SIG-AMI enum
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Rpu Unique identifier of the CFE client, string 12


(permanent user registration)
Nombre Name of the CFE client that contracts string 30
the electric power service
Direccion CFE customer address string 30
Cuenta Identifier that contains the cycle and string 16
route data to which the contracted
electric energy service corresponds
Tarifa Identifier that contains the Tariff for the string 2
supply and sale of contracted electric
energy (officially fixed price)

NumeroHilos Identifier of the number of phases int


that the contracted electricity service
has installed
DemandaContratada Value of the demand contracted by float
the CFE client
EsBidireccional Indicates if the service meter is boolean
bidirectional
ReiniciarContadores Indicates if the meter counters boolean
should be reset

WebService wsSIGAMI
Method: ActualizarDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ActualizarDatosMedidoresResponse xmlns="http://www.cfe.gob.mx//">
<ActualizarDatosMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</ActualizarDatosMedidoresResult>
</ActualizarDatosMedidoresResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Respuesta Indicates if the request was received enum


successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirConfirmacionActualizacionDatosMedidores
xmlns="http://www.cfe.gob.mx//">
<idPeticion>string</idPeticion>
<listaConfirmaciones>
<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>
<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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of the input parameters:


Parameter Description Type of data Longitude
IdPeticion Identification of the read request string 18
initiated by
KAVICentinel when using the method
Read wsSIGAMI web service meters
NumeroMedidor Meter identifier from which the string 6
reading was obtained
ResultadoActualizacion Indicator of the result of the enum
meter data update
CodigoErrorActualizacion Reason why the update could not be enum
successful
DescripcionErrorActualizacion Detailed description of the error string 100
that prevented the update of the
meter data.
FechaActualizacion Date and time the meter data was DateTime
updated in the GIS-AMI database

WebService: wsKAVICentinel
Method: RecibirConfirmacionActualizacionDatosMedidores
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RecibirConfirmacionActualizacionDatosMedidoresResponse
xmlns="http://www.cfe.gob.mx//">
<RecibirConfirmacionActualizacionDatosMedidoresResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RecibirConfirmacionActualizacionDatosMedidoresResult>
</RecibirConfirmacionActualizacionDatosMedidoresResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Respuesta Indicates if the request was received enum


successfully or an error occurred.
CodigoError Indicates the error code occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

COMMAND TO REGISTER METER ALARMS:

The method RegistrarAlarmaMedidor will be used from web service


wsKAVICentinel from the SIG-AMI, which will confirm if the request was received
satisfactorily.

c. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI

d. COMMAND STRUCTURE

WebService: wsKAVICentinel
Method: RegistrarAlarmaMedidor
Definition SOAP Request:

POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RegistrarAlarmaMedidor xmlns="http://www.cfe.gob.mx//">
<alarmaMedidor>
<ListaMedidores>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
</ListaMedidores>
<Alarma>
<CodigoEventoCFE>int</CodigoEventoCFE>
<CodigoEventoSigAmi>string</CodigoEventoSigAmi>
<DescripcionEventoSigAmi>string</DescripcionEventoSigAmi>
<FechaEventoSigAmi>dateTime</FechaEventoSigAmi>
</Alarma>
</alarmaMedidor>
<idSigAmi>int</idSigAmi>
</RegistrarAlarmaMedidor>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of input parameters:


Parameter Description Type of data Longitude
NumeroMedidor Meter identifier string 6
CodigoEventoCFE SIG-AMI alarm code to the int
corresponding alarm catalog of
CFE.
CodigoEventoSigAmi Code of occurred alarm string 50
DescripcionEventoSigAmi Description of occurred alarm string 100
FechaEventoSigAmi Date of occurred alarm DateTime
idSigAmi SIG-AMI identifier that records the int
meter alarm (this identifier will be
configurable, assigned by CFE)

WebService: wsKAVICentinel
Method: RegistrarAlarmaMedidor
Definition SOAP Response:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RegistrarAlarmaMedidorResponse xmlns="http://www.cfe.gob.mx//">
<RegistrarAlarmaMedidorResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RegistrarAlarmaMedidorResult>
</RegistrarAlarmaMedidorResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received successfully or enum
an error occurred.
CodigoError Indicates the code of the error occurred enum
upon receipt of the request.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

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.

COMMAND TO REGISTER NEW METER.

The method RegistrarNuevoMedidor will be used from web service wsKAVICentinel


from KAVICentinel, which will confirm if the request was received satisfactorily.

e. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI

f. COMMAND STRUCTURE

WebService: wsKAVICentinel
Method: RegistrarNuevoMedidor
Definition SOAP Request:

POST /wsKAVICentinel/wsKAVICentinel.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RegistrarNuevoMedidor xmlns="http://www.cfe.gob.mx//">
<datosMedidor>
<Medidor>
<NumeroMedidor>string</NumeroMedidor>
</Medidor>
<CodigoMedidor>string</CodigoMedidor>
<LoteMedidor>string</LoteMedidor>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<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>

Description of input parameters:


Parameter Description Type of data Longitude
NumeroMedidor Meter identifier string 6
CodigoMedidor Meter code string 4
LoteMedidor Meter batch string 4
Marca Meter brand string 20
Modelo Meter model string 20
VersionFirmware Firmware version of the meter string 30

Latitud Latitude value of geographic float


coordinates in decimal degrees of the
meter location
Longitud Length value of the geographic float
coordinates in decimal degrees of the
meter location
EstadoRelevador Status of how the meter relay is enum
located for the types of meters with
remote disconnection
EstadoMedidor Status of the meter in the SIG-AMI enum
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

FechaHoraRegistro Date and time the meter was DateTime


registered in the GIS-AMI database

ListaLecturas List of readings requested by each List<Lectura>


meter
idSigAmi Identifier of the SIG-AMI that registers int
the new meter (this identifier will be
configurable, assigned by CFE)

WebService: wsKAVICentinel
Method: RegistrarNuevoMedidor
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<RegistrarNuevoMedidorResponse xmlns="http://www.cfe.gob.mx//">
<RegistrarNuevoMedidorResult>
<Respuesta>OK or ERROR</Respuesta>
<CodigoError>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoError>
</RegistrarNuevoMedidorResult>
</RegistrarNuevoMedidorResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of data Longitude
Respuesta Indicates if the request was received successfully or enum
an error occurred.
CodigoError Indicates the code of the error occurred enum
upon receipt of the request.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

3) The system must implement a mechanism to perform manual forwarding of


said requests.

7. COMMAND TO CONSULT THE STATUS OF THE PETITIONS MADE TO THE SIG-AMI


KAVICentinel will use the method ConsultarEstadoPeticiones from the web service
wsSIGAMI of the SIG-AMI, which will return the corresponding status for each request.

a. DIAGRAM
SOAP 1.2
KAVICentinel SIG-AMI

b. COMMAND STRUCTURE

WebService: wsSIGAMI
Method: ConsultarEstadoPeticiones
Definition SOAP Request:

POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ConsultarEstadoPeticiones xmlns="http://www.cfe.gob.mx//">
<listaPeticiones>
<Peticion>string</Peticion>
<Peticion>string</Peticion>
</listaPeticiones>
</ConsultarEstadoPeticiones>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of the input parameters:


Parameter Description Type of data Longitude
listaPeticiones Lista de peticiones a consultar el estado List<string>

WebService wsSIGAMI
Method: ConsultarEstadoPeticiones
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ConsultarEstadoPeticionesResponse xmlns="http://www.cfe.gob.mx//">
<ConsultarEstadoPeticionesResult>
<ResultadoConsultarEstadoPeticion>
<IdPeticion>string</IdPeticion>
<EstadoPeticion>EnProceso or Pausada or Abortada or
Completada or Desconocido</EstadoPeticion>
<PorcentajeAvance>int</PorcentajeAvance>
<CodigoErrorPeticion>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoErrorPeticion>
<DescripcionErrorPeticion>string</DescripcionErrorPeticion>
<FechaUltimoCambioEstado>dateTime</FechaUltimoCambioEstado>
</ResultadoConsultarEstadoPeticion>
<ResultadoConsultarEstadoPeticion>
<IdPeticion>string</IdPeticion>
<EstadoPeticion>EnProceso or Pausada or Abortada or
Completada or Desconocido</EstadoPeticion>
<PorcentajeAvance>int</PorcentajeAvance>
<CodigoErrorPeticion>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoErrorPeticion>
<DescripcionErrorPeticion>string</DescripcionErrorPeticion>
<FechaUltimoCambioEstado>dateTime</FechaUltimoCambioEstado>
</ResultadoConsultarEstadoPeticion>
</ConsultarEstadoPeticionesResult>
</ConsultarEstadoPeticionesResponse>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of the response values:


Value Description Type of Longitude
data
IdPeticion Request Identifier string 18
EstadoPeticion Current status of the request enum
PorcentajeAvance Current percentage of the petition's progress int
CodigoErrorPeticion Describe the error code for which a enum
request could not be satisfactory
DescripcionErrorPeticion Description of the error whereby a string 100
request could not be satisfactory
FechaUltimoCambioEstado Date of the last time the status change DateTime
date
8. COMMAND TO CONSULT THE STATUS OF SERVICES IN THE SIG-AMI AND KAVICENTINEL

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:

POST /wsSIGAMI/wsSIGAMI.asmx HTTP/1.1


Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ComprobarEstadoServicios xmlns="http://www.cfe.gob.mx//" />
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of input parameters


Parameter Description Type of data Longitude
N/A N/A N/A N/A

WebService wsSIGAMI
Method: ComprobarEstadoServicios
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ComprobarEstadoServiciosResponse xmlns="http://www.cfe.gob.mx//">
<ComprobarEstadoServiciosResult>
<EstadoServicios>Disponibles or ConProblemas</EstadoServicios>
<CodigoErrorPeticion>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoErrorPeticion>

<DescripcionProblemaEnServicios>string</DescripcionProblemaEnServicios>
</ComprobarEstadoServiciosResult>
</ComprobarEstadoServiciosResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of Longitude
data
EstadoServicios Request Identifier enum
DescripcionProblemaEnServicios Describe the problem for which string 200
services are not available

WebService: wsKAVICentinel
Method: ComprobarEstadoServicios
Definition SOAP Request:

POST /wsKAVIcentinel/wsKAVICentinel.asmx HTTP/1.1


Host: 10.4.57.48
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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">
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

<soap12:Body>
<ComprobarEstadoServicios xmlns="http://www.cfe.gob.mx/">
<idSigAmi>int</idSigAmi>
</ComprobarEstadoServicios>
</soap12:Body>
</soap12:Envelope>
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

Description of the input parameters:


Parameter Description Type of data Longitude
idSigAmi Identifier of the SIG-AMI that uses the int
service (this identifier will be
configurable, assigned by CFE)

WebService: wsKAVICeninel
Method: ComprobarEstadoServicios
Definition SOAP Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>


<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>
<ComprobarEstadoServiciosResponse xmlns="http://www.cfe.gob.mx//">
<ComprobarEstadoServiciosResult>
<EstadoServicios>Disponibles or ConProblemas</EstadoServicios>
<CodigoErrorPeticion>Ninguno or BaseDeDatosNoDisponible or
ErrorEscrituraEnDisco or MemoriaInsufuciente or
TamanioPeticionFueraLimite or LimitePeticionesAlcanzado or
RespaldoEnProceso or MantenimientoDelSistemaEnProceso or
OtrosErrores</CodigoErrorPeticion>

<DescripcionProblemaEnServicios>string</DescripcionProblemaEnServicios>
</ComprobarEstadoServiciosResult>
</ComprobarEstadoServiciosResponse>
</soap12:Body>
</soap12:Envelope>

Description of the response values:


Value Description Type of Longitude
data
EstadoServicios Request Identifier enum
DescripcionProblemaEnServicios Describe the problem for which string 200
services are not available
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

TEST PROTOCOL FOR INTERFACES BETWEEN KAVICentinel AND SIG-AMI.

1. Take readings by a meter or group of meters per scheduled task.


READING BY GROUP OF METERS (OFFLINE)
SICOM KAVI Centinel PIDIREGAS SIG-AMI

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

Archives with Send request Results with


meters' information Use wsSIGAMI, readings
method LeerMedidores
End with parameter
LecturaEnLinea = false
READING

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

2. Taking readings by meter or group of meters (settlements)


ONLINE READING OF A SETTLEMENT METER
SICOM KAVI Centinel PIDIREGAS SIG-AMI SICOSS

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

Send request. Register


Use wsSIGAMI, request S06
method
NO DesconectarMedidores
Meter permits
Send results
remote
disconnection? Use wsKAVICentinel,
Method
Use the RecibirDesconexiones. Database
YES response and
process the
Process data to data
build the
disconnection Database
request Request S06

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

Invoke CGI Sicoss


to generate S06 Receive
Pending result and
process
data

Process result

Database

End

3. Disconnection of a meter or group of meters.


FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

DISCONNECTING A METER OR GROUP OF METERS

SICOM KAVI Centinel PIDIREGAS SIG-AMI SICOSS

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

Invoke CGI SICOSS Invoke CGI SICOSS


to generate SCD to generate SCD
pending terminated

Receive result from


KAVICentinel and Process the result
update status in from SICOSS and send
BD SICOM to
update status
DISCONNECTION

Database of disconnection
HTTP

End
Database
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

4. Reconnection of a meter or group of meters.

RECONNECTION OF A METER OR GROUP OF METERS

SICOM KAVI Centinel PIDIREGAS SIG-AMI SICOSS

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

Process the data


to generate Receive the
archive with response and
information from process the Send results
the reconnection data Use wsKAVICentinel,
Method
Data base RecibirReconexiones
Archive with Send result
information from HTTP
meter for NO Satisfactory
disconnection YES
reconnection?

Invoke CGI Sicoss Invoke CGI Sicoss


Send archive to generate SC7 to generate SC7
through Pending Terminated
ftp to KAVICentinel

Receive
result

Process result
RECONEXION

Data base

End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

5. Update meter data (meter registration) [register new meter]

UPDATE METER DATA IN THE SIG-AMI DATA BASE OR REPORT METER TO KAVICENTINEL

SICOSS SICOM KAVI Centinel PIDIREGAS SIG-AMI

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

data conversion Process information


and register in BD
The applicant details
Is service
are processed and
telemeter?
proceed with the NO
installation Data update
request
Database
Base de SI
datos End

Process the data


to build the
Attention in update request Send request, use
field from meter in wsSIGAMI, method
KAVICentinel ActualilzarDatosMedidores
End

Successful Archives with


NO instillation? information
Use wsKAVICentinel,
from meter method
Receive register of RegistrarNuevoMedidor
End new meter and
SI
process the data
Send archives
The connection through
command ends and ftp to KAVICentinel
the meter data Information from
processes from the meter in field is
new service End received

Prepare information New telemeter meter is


and send to SICOM detected in the network
to register of the
as a new client
SIG-AMI
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

6. Update meter data (low and change meter)

CHANGE OF METERS

SICOSS SICOM KAVI Centinel PIDIREGAS SIG-AMI

Start

Receive data FTP


from changed meters Receive
Server update
Termination data
request
from change of
of meter data
meter request
Perform meter
movements and
validate if the
route is affected Process the
End request for conversion of data Start
change of meter update
and generate request
for SICOM NO

Telemeter Archive with information


from discharged meter
route? (EstadoMedidor = Baja)
SICOM request Generate result
and active meter
End
meter change data (EstadoMedidor = Activo)
YES

Process the data Result of update


to generate
Send request.
archive with
Use wsSIGAMI,
information from
method
meters
ActualizarDatosMedidores
Send request
HTTP
Archive with
information from
discharged meter
and active Receive the
meter response
Send results.
Use wsKAVICentinel, method
RecibirConfirmacionActualizacion
Datos Medidores
Database
RECONNECTION

Process response
Send archive through
ftp to KAVICentinel

End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

7. ALARM. Meter withdrawal.

WITHDRAWAL OF YOUR BASE METER


KAVI Centinel SIG-AMI SICOSS

Start

Receive Alarm
Report Read request
Generate event
meter: Retire the and begin
meter from its base search

Database
Database

Database Use ws:soap


Process data wsKAVICentinel Generate result
Method:
RegistrarAlarmaMedidor

Invoke socket-CGI

Existing previous order


(SM*, Q0*) with status
1, W, 2, 3
NO

Generate new
order (SMC)
SI

Delivery result
from order number

Receive Invoke URL and


result and send data to
process
KaviCentinel
data

Process result

End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

8. ALARM. High voltage.

HIGH VOLTAGE
KAVI Centinel SIG-AMI SICOSS

Start

Read request and


Receive alarm start search
report
Generate event
meter: High voltage
Database Database

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

Invoke socket-CGI Generate 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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

9. ALARM. Inverse flow

INVERSE ENERGY FLOW WITH RESPECT TO NORMAL ENERGY FLOW


KAVI Centinel SIG-AMI SICOSS

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

Receive Invoke URL and


result and send data to
process KaviCentinel
data

Process result

End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

10. ALARM. Open cabinet door.

OPEN CABINET DOOR


KAVI Centinel SIG-AMI SICOSS

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

11. ALARM. Fatal meter errors.

FATAL METER ERRORS


KAVI Centinel SIG-AMI SICOSS

Start

Read petition
Receive alarm and start
report search
Generate event meter:
Fatal meter erros

Database
Database

Process data. Database


Use ws:soap
wsKAVICentinel Previous existing
Method: order (SM3) con
RegistrarAlarmaMe status 1, W, 2, 3
didor NO

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

12. ALARM. Low battery.

LOW BATTERY
KAVI Centinel SIG-AMI SICOSS

Start

Read request and

Receive alarm Generate meter start


report event: Low battery search

Database
Database

Process data Database


Use ws:soap
wsKAVICentinel
Method:
RegistrarAlarmaMedidor

Invoke socket-CGI Previous existing


order (SM3) with
status 1, W, 2, 3 NO

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

13. ALARM. Reset counters.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

14. ALARM. Over-demand detection.

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

Receive Invoke URL and


result and send data to
process KaviCentinel
data

Process result

End
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

DESCRIPTION OF ENUMERABLE VALUES

ENUM VALUE NAME DESCRIPTION


TiposLectura ConsumoTotal Wh totals. In single-phase
or multi-phase meters with
technology to total
consumption.
ConsumoFase1 Wh consumed in phase 1 of
meter.
ConsumoFase2 Wh consumed in phase 2 of
the meter.
ConsumoFase3 Wh consumed in phase 3 of
the meter.
ConsumoDiurno Wh consumed from 08:00:01
to 23:59:59 hours.
ConsumoNocturno Wh consumed from 00:00:00
to 08:00:00 hours.
ConsumoEnergiaEntregada Wh delivered to the user.
ConsumoEnergiaRecibida Wh received by CFE.
DemandaMaxima Maximum demand registered
for the telemetered service. If
a meter is installed for each
phase, only a maximum
demand data must be sent.

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

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

LimitePeticionesAlcanzado The number of requests


received reached the
maximum allowed.
RespaldoEnProceso System backup is in process.

MantenimientoDelSistemaEnProceso The system is in the


maintenance phase.
ErrorEnAutentificacion The username and / or
password are incorrect.
OtrosErrores Any error not
considered.
CodigosErrorMedidor Ninguno No error
MedidorNoEncontrado The meter is not in the
database
MedidorSinComunicacion Unable to communicate with
the meter
ErrorEnFirmware The firmware version of the
meter prevents operations on
it.
TiempoDeEsperaAgotado The timeout limit expires
when executing an operation
on the meter.
LecturaMedidorFueraDeLimite The maximum number of days
to take as valid the reading in
Database was exceeded.

ErrorDePermisos Error logging into the meter to


execute any operation.

MedidorDuplicado Meter number duplicated in


database
MedidorSinRelevador Installed meter without
relay does not permit
,
disconnection or reconnection.
OtrosErrores Any other error not
considered.
EstadoRelevador Abierto The relay of the meter is open.

Cerrado The relay of the meter is


closed.
EstadoMedidor Activo The meter is active in the
system.
Inactivo The meter is in system idle
status.
Baja The meter is discharged from
the system because it was
removed in the field.
EstadoServicios Disponibles All system services are
available and ready to receive
requests.
FEDERAL ELECTRICITY COMMISSION
SUB-DIRECTION OF DISTRIBUTION

REVISIÓN: 6.2 REVIEW DATE: SEPTEMBER 25TH 2018

ConProblemas There are problems in one or


more services that prevents
receiving requests.
EstadosPeticion EnProceso The request consulted is in
execution.
Pausada The petition consulted is
paused.
Abortada The petition consulted was
aborted.
Completada The request consulted was
completed
Desconocido The status of the request is
unknown.

You might also like