Inicio - PowerGAS API

Clientes

Consulta de mis tarjetas Consulta de una tarjeta Consulta de consumos Consulta Estado de Cuenta o Factura Consulta de rendimientos Catálogo de vehículos Consulta de centros de costos

Información de tarjetas

Método

GET

Path

api.powergas.mx/Clientes/ConsultaTarjetas

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

TarjetasResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lTarjetas	List <InfoTarjetaResponse>	Contiene una lista con la información de las tarjetas.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lTarjetas":[{
			    "Folio":"1000000000000001",
			    "Saldo":10.00,
			    "Bloqueada":false,
			    "Activa":true,
			    "Politica":"Mi Política #1",
                "InfoVehiculo":"MODELO, MARCA, PLACAS123",
                "CentroCostos": "Centro de costos #1",
			    "OperacionExitosa":false,
			    "Mensaje":null,
			    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			   },
			   {
			    "Folio":"1000000000000002",
			    "Saldo":20.00,
			    "Bloqueada":true,
			    "Activa":true,
			    "Politica":"Mi Política #2",
			    "InfoVehiculo":"MODELO, MARCA, PLACAS789",
                "CentroCostos": null,
			    "OperacionExitosa":false,
			    "Mensaje":null,
			    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			   }
            ]
}

Información de mi tarjeta

Método

GET

Path

api.powergas.mx/Clientes/ConsultaTarjeta/{Folio}

Parámetros

Folio - Folio de la tarjeta

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

InfoTarjetaResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
Folio	string	Indica el folio de la tarjeta seleccionada.
Saldo	decimal	Saldo total de la tarjeta.
Bloqueada	bool	Indica el bloqueo de la tarjeta, si se encuentra bloqueada: true o desbloqueada: false.
Activa	bool	Indica el estatus de la tarjeta activa: true o desactiva: false.
Politica	string	Nombre de la politica asignada.
InfoVehiculo	string	Información del vehiculo asignado.

Ejemplo:

                                                    
            {
			  "Folio":"1000000000000001",
			  "Saldo":10.00,
			  "Bloqueada":false,
			  "Activa":true,
			  "Politica":"Mi Política #1",
              "InfoVehiculo":"MODELO, MARCA, PLACAS123",
              "CentroCostos": "Centro de costos #1",
			  "OperacionExitosa":true,
			  "Mensaje":"Operación exitosa.",
			  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			}

Información de consumos

Método

POST

Path

api.powergas.mx/Clientes/ConsultaConsumos

Parámetros

ConsumosRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha limite de la consulta.
combustibles	string	Tipos de ventas de combustibles que se van a consultar. 1: DIESEL, 2: MAGNA, 3: PREMIUM. Ejemplos: 1,2,3

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

ConsumosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lConsumos	List <InfoConsumoResponse>	Lista con los consumos encontrados.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lConsumos":[{
			    "Total":"1234.56",
			    "Litros":100.00,
                "PrecioLitro":12.35,
			    "Combustible":"DIESEL",
			    "Estacion":"Estación #1",
			    "FolioTarjeta":"1000000000000001",
                "InfoVehiculo":"MODELO, MARCA, PLACAS123",
			    "CentroCostos":"Centro de costos #1",			    
			    "FechaVenta":"2016-06-09T19:25:32.453987+00:00",
                "AutorizacionTelefonica":true
			   },
			   {
                "Total":"2345.67",
			    "Litros":200.00,
                "PrecioLitro":14.35,
			    "Combustible":"MAGNA",
			    "Estacion":"Estación #2",
			    "FolioTarjeta":"1000000000000002",
                "InfoVehiculo":"MODELO, MARCA, PLACAS123",
			    "CentroCostos":"Centro de costos #2",			    
			    "FechaVenta":"2016-06-09T19:25:32.453987+00:00",
                "AutorizacionTelefonica":false
			   }
            ]
}

Información de Estados de Cuenta y Facturas

Método

POST

Path

api.powergas.mx/Clientes/ConsultaCFDI

Parámetros

CFDRequest

Atributo	Tipo	Descripción
Serie	string	Serie del tipo de comprobante 'EC' - Estado de cuenta 'F' - Factura
Folio	int	Fecha limite de la consulta.

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

CFDResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
XML	string	Cadena con XML del comprobante.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "XML":"<note>
          <to>Client</to>
          <from>PowerGAS</from>
          <heading>Reminder</heading>
          <body>Don't forget your payment!</body>
        </note>"
}

Información de rendimientos

Método

POST

Path

api.powergas.mx/Clientes/ConsultaRendimientos

Parámetros

RendimientosRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha limite de la consulta.
centroCostos (Opcional)	string	Nombre del centro de costos.
noEconomico (Opcional)	string	Número económico.

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

RendimientosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lRend	List <InfoRendimiento>	Lista con los rendimientos encontrados.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lRend": [{
                "FolioTarjeta": "CTLS9875"
                "Vehiculo": "INTERNATIONAL, PROSTAR, "
                "NoEconomico": "112"
                "CentroCostos": "PLANAS "
                "FechaConsumo": "2016-06-21T00:00:00"
                "KmAnterior": 398427
                "KmActual": 399926
                "KmRecorridos": 1499
                "Litros": 500.04
                "Rendimiento": 3
            },
            {
                "FolioTarjeta": "CTLS9990"
                "Vehiculo": "INTERNATIONAL, PROSTAR, "
                "NoEconomico": "173"
                "CentroCostos": "PLANAS "
                "FechaConsumo": "2016-06-20T00:00:00"
                "KmAnterior": 34818
                "KmActual": 34818
                "KmRecorridos": 0
                "Litros": 800
                "Rendimiento": 0
            }]
}

Catálogo de vehículos

Método

GET

Path

api.powergas.mx/Clientes/Vehiculos

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

VehiculosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lVehiculos	List <Vehiculo>	Contiene una lista con la información de los vehiculos que se encuentran activos.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lVehiculos":[{
                "Marca": "VW"
                "Modelo": "VOLKSWAGEN"
                "Clase": "SEDAN"
                "Anio": "2016"
                "Placas": "ABC1234"
                "NoEconomico": "V001"
                "Kilometraje": "1000.00"
                "Tarjeta": "CTLS0000"
                "Conductor": "FRANCISCO, JESUS",
                "CentroCostos": "Centro de costos #1"
			   },
			   {
                "Marca": "CHEVROLET"
                "Modelo": "CHEVY"
                "Clase": "SEDAN"
                "Anio": "2016"
                "Placas": "ABC9876"
                "NoEconomico": ""
                "Kilometraje": "2000.00"
                "Tarjeta": ""
                "Conductor": null,
                "CentroCostos": null
			   }
            ]
}

Catálogo de centro de costos

Método

GET

Path

api.powergas.mx/Clientes/CentrosCostos

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

lCentroCostos

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lCentroCostos	List <CentroCostos>	Contiene una lista con la información de los centros de costos que se encuentran activos.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lVehiculos":[{
                "NombreCC": "VENTAS"
                "Descripcion": ""
                "EstadoCuentaIndividual": false
                "Activo": true
			   },
			   {
                "NombreCC": "ADMINISTRATIVO"
                "Descripcion": ""
                "EstadoCuentaIndividual": false
                "Activo": true
			   }
            ]
}

Clientes V2

Consulta de mis tarjetas Consulta de una tarjeta Consulta de consumos Consulta Estado de Cuenta o Factura Consulta de rendimientos Catálogo de vehículos Consulta de centros de costos Consulta Precios Transferencia de saldo Consulta saldo central

Información de tarjetas

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaTarjetas

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

TarjetasResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lTarjetas	List <InfoTarjetaResponse>	Contiene una lista con la información de las tarjetas.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lTarjetas":[{
			    "Folio":"1000000000000001",
			    "Saldo":10.00,
			    "Bloqueada":false,
			    "Activa":true,
			    "Politica":"Mi Política #1",
                "InfoVehiculo":"MODELO, MARCA, PLACAS123",
                "CentroCostos": "Centro de costos #1",
			    "OperacionExitosa":false,
			    "Mensaje":null,
			    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			   },
			   {
			    "Folio":"1000000000000002",
			    "Saldo":20.00,
			    "Bloqueada":true,
			    "Activa":true,
			    "Politica":"Mi Política #2",
			    "InfoVehiculo":"MODELO, MARCA, PLACAS789",
                "CentroCostos": null,
			    "OperacionExitosa":false,
			    "Mensaje":null,
			    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			   }
            ]
}

Información de mi tarjeta

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaTarjeta/{Folio}

Parámetros

Folio - Folio de la tarjeta

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

InfoTarjetaResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
Folio	string	Indica el folio de la tarjeta seleccionada.
Saldo	decimal	Saldo total de la tarjeta.
Bloqueada	bool	Indica el bloqueo de la tarjeta, si se encuentra bloqueada: true o desbloqueada: false.
Activa	bool	Indica el estatus de la tarjeta activa: true o desactiva: false.
Politica	string	Nombre de la politica asignada.
InfoVehiculo	string	Información del vehiculo asignado.

Ejemplo:

                                                    
            {
			  "Folio":"1000000000000001",
			  "Saldo":10.00,
			  "Bloqueada":false,
			  "Activa":true,
			  "Politica":"Mi Política #1",
              "InfoVehiculo":"MODELO, MARCA, PLACAS123",
              "CentroCostos": "Centro de costos #1",
			  "OperacionExitosa":true,
			  "Mensaje":"Operación exitosa.",
			  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
			}

Información de consumos

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaConsumos

Parámetros

ConsumosRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha límite de la consulta.
combustibles	Array	Tipos de ventas de combustibles que se van a consultar. 1: DIESEL, 2: MAGNA, 3: PREMIUM. Ejemplos: [1,2,3]
autoconsumo	Bool	Incluir autoconsumos.

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

ConsumosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
ResponseValue	List <InfoConsumoResponse>	Lista con los consumos encontrados.

Ejemplo:

                                                        
{
    "ResponseValue": [
        {
            "FechaVenta": "2022-08-02T16:06:08.227",
            "FolioVenta": "TE-0000000001",
            "FolioTarjeta": "1000000000000001",
            "FolioTicketVolumetrico": "100001",
            "NoEconomico": "NoEconomico",
            "Marca": "Marca",
            "Modelo": "Modelo",
            "Placas": "Placas",
            "Conductor": "Nombre de conductor",
            "CentroCostos": "Centro de costos #1",
            "NoEstacion": 12345678,
            "Estacion": "Nombre de estacion",
            "Kilometraje": 0.000,
            "EstadoCuentaAsociado": "EC-0000000001",
            "Combustible": "PREMIUM",
            "Litros": 16.0000,
            "PrecioLitro": 23.6100,
            "Total": 377.7600,
            "AutorizacionTelefonica": false
        },
        {
            "FechaVenta": "2022-08-02T16:06:08.227",
            "FolioVenta": "TE-0000000002",
            "FolioTarjeta": "1000000000000001",
            "FolioTicketVolumetrico": "100002",
            "NoEconomico": "NoEconomico",
            "Marca": "Marca",
            "Modelo": "Modelo",
            "Placas": "Placas",
            "Conductor": "Nombre de conductor",
            "CentroCostos": "Centro de costos #2",
            "NoEstacion": 12345678,
            "Estacion": "Nombre de estacion",
            "Kilometraje": 0.000,
            "EstadoCuentaAsociado": "EC-0000000002",
            "Combustible": "PREMIUM",
            "Litros": 16.0000,
            "PrecioLitro": 23.6100,
            "Total": 377.7600,
            "AutorizacionTelefonica": false
        },
        {
            "FechaVenta": "2022-08-02T16:06:08.227",
            "FolioVenta": "CE-0000000001",
            "FolioTarjeta": "1000000000000003",
            "FolioTicketVolumetrico": "100003",
            "NoEconomico": "NoEconomico",
            "Marca": "Marca",
            "Modelo": "Modelo",
            "Placas": "Placas",
            "Conductor": null,
            "CentroCostos": "Centro de costos #2",
            "NoEstacion": 0,
            "Estacion": "Nombre de estacion",
            "Kilometraje": 0.000,
            "EstadoCuentaAsociado": null,
            "Combustible": "PREMIUM",
            "Litros": 16.0000,
            "PrecioLitro": 23.6100,
            "Total": 377.7600,
            "AutorizacionTelefonica": false
        }
            ],
            "OperacionExitosa": true,
            "Mensaje": "Operación exitosa.",
            "FechaConsulta": "2022-11-04T09:25:29.8937575-06:00"
}

Información de Estados de Cuenta y Facturas

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaCFDI

Parámetros

CFDRequest

Atributo	Tipo	Descripción
Serie	string	Serie del tipo de comprobante 'EC' - Estado de cuenta 'F' - Factura
Folio	int	Fecha limite de la consulta.

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

CFDResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
XML	string	Cadena con XML del comprobante.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "XML":"<note>
          <to>Client</to>
          <from>PowerGAS</from>
          <heading>Reminder</heading>
          <body>Don't forget your payment!</body>
        </note>"
}

Información de rendimientos

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaRendimientos

Parámetros

RendimientosRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha limite de la consulta.
centroCostos (Opcional)	string	Nombre del centro de costos.
noEconomico (Opcional)	string	Número económico.

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

RendimientosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lRend	List <InfoRendimiento>	Lista con los rendimientos encontrados.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lRend": [{
                "FolioTarjeta": "CTLS9875"
                "Vehiculo": "INTERNATIONAL, PROSTAR, "
                "NoEconomico": "112"
                "CentroCostos": "PLANAS "
                "FechaConsumo": "2016-06-21T00:00:00"
                "KmAnterior": 398427
                "KmActual": 399926
                "KmRecorridos": 1499
                "Litros": 500.04
                "Rendimiento": 3
            },
            {
                "FolioTarjeta": "CTLS9990"
                "Vehiculo": "INTERNATIONAL, PROSTAR, "
                "NoEconomico": "173"
                "CentroCostos": "PLANAS "
                "FechaConsumo": "2016-06-20T00:00:00"
                "KmAnterior": 34818
                "KmActual": 34818
                "KmRecorridos": 0
                "Litros": 800
                "Rendimiento": 0
            }]
}

Catálogo de vehículos

Método

GET

Path

api.powergas.mx/Cliente/V2/Vehiculos

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

VehiculosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lVehiculos	List <Vehiculo>	Contiene una lista con la información de los vehiculos que se encuentran activos.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lVehiculos":[{
                "Marca": "VW"
                "Modelo": "VOLKSWAGEN"
                "Clase": "SEDAN"
                "Anio": "2016"
                "Placas": "ABC1234"
                "NoEconomico": "V001"
                "Kilometraje": "1000.00"
                "Tarjeta": "CTLS0000"
                "Conductor": "FRANCISCO, JESUS",
                "CentroCostos": "Centro de costos #1"
			   },
			   {
                "Marca": "CHEVROLET"
                "Modelo": "CHEVY"
                "Clase": "SEDAN"
                "Anio": "2016"
                "Placas": "ABC9876"
                "NoEconomico": ""
                "Kilometraje": "2000.00"
                "Tarjeta": ""
                "Conductor": null,
                "CentroCostos": null
			   }
            ]
}

Catálogo de centro de costos

Método

GET

Path

api.powergas.mx/Cliente/V2/CentrosCostos

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

lCentroCostos

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lCentroCostos	List <CentroCostos>	Contiene una lista con la información de los centros de costos que se encuentran activos.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lVehiculos":[{
                "NombreCC": "VENTAS"
                "Descripcion": ""
                "EstadoCuentaIndividual": false
                "Activo": true
			   },
			   {
                "NombreCC": "ADMINISTRATIVO"
                "Descripcion": ""
                "EstadoCuentaIndividual": false
                "Activo": true
			   }
            ]
}

Consulta precios de combustibles

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaPrecios

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

ApiResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
ResponseValue	List <PreciosCombustiblesResponse>	Contiene una lista con información del tipo de combustible (1: DIESEL, 2: MAGNA, 3: PREMIUM), precio y ultima fecha de actualizacion.

Ejemplo:

                                                    
{
    "ResponseValue": [
        {
            "Combustible": 1,
            "Precio": 25.9900,
            "UltimaActualizacion": "2022-05-25T08:36:55.177"
        },
        {
            "Combustible": 2,
            "Precio": 25.9900,
            "UltimaActualizacion": "2022-09-05T13:16:04.587"
        },
        {
            "Combustible": 3,
            "Precio": 26.9900,
            "UltimaActualizacion": "2022-03-18T16:02:51.513"
        }
    ],
    "OperacionExitosa": true,
    "Mensaje": "Operación exitosa.",
    "FechaConsulta": "2022-11-04T09:59:32.3074143-06:00"
}

Transfiere saldo de cuenta central a tarjeta

Método

POST

Path

api.powergas.mx/Cliente/V2/TransferenciaSaldo

Permisos

Escritura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

ApiResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
ResponseValue	string	Regresa el folio del movimiento que se realizo.

Ejemplo:

                                                    
{
    "ResponseValue": "TCC-000000001",
    "OperacionExitosa": true,
    "Mensaje": "Transferencia realizada con éxito",
    "FechaConsulta": "2022-11-04T10:10:44.8597975-06:00"
}

Consulta saldo cuenta central

Método

GET

Path

api.powergas.mx/Cliente/V2/ConsultaSaldoCentral

Permisos

Lectura

Autorización

Usuario: Nombre de Usuario
Contraseña: API Key

Respuesta

ApiResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
ResponseValue	decimal	Regresa el saldo disponible en la cuenta central.

Ejemplo:

                                                    
{
    "ResponseValue": 12345.0001,
    "OperacionExitosa": true,
    "Mensaje": "Consulta realizada con éxito",
    "FechaConsulta": "2022-11-04T10:14:40.8331514-06:00"
}

Estaciones

Consulta de ordenes de pago Consulta de consumos

Información de Ordenes de Pago

Método

POST

Path

api.powergas.mx/Estaciones/ConsultaOPs

Parámetros

OPRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha limite de la consulta.

Autorización

Usuario: Número de estación
Contraseña: API Key

Respuesta

OPResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lOPs	List <InfoOPResponse>	Lista con las ordenes de pago encontradas.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lOPs":[{
            "FolioOP": "OP-0000000001"
            "PeriodoInicial": "2016-05-30T00:00:00"
            "PeriodoFinal": "2016-06-05T00:00:00"
            "TotalOperaciones": 275104.9
            "SubtotalComision": 3301.26
            "IVA": 928.2
            "TotalParticipacion": 6729.46
            "Transacciones": 546
            "Estacion": "MI ESTACIÓN ABC1234"
            "Estatus": "Generada"
        },
        {
            "FolioOP": "OP-0000000002"
            "PeriodoInicial": "2016-06-06T00:00:00"
            "PeriodoFinal": "2016-06-12T00:00:00"
            "TotalOperaciones": 268710.04
            "SubtotalComision": 3224.52
            "IVA": 515.92
            "TotalParticipacion": 3740.44
            "Transacciones": 533
            "Estacion": "MI ESTACIÓN ABC1234"
            "Estatus": "Generada"
        }]
}

Información de consumos

Método

POST

Path

api.powergas.mx/Estaciones/ConsultaConsumos

Parámetros

ConsumosRequest

Atributo	Tipo	Descripción
fechaInicio	DateTime	Fecha de inicio de la consulta.
fechaFinal	DateTime	Fecha limite de la consulta.
combustibles	string	Tipos de ventas de combustibles que se van a consultar. 1: DIESEL, 2: MAGNA, 3: PREMIUM. Ejemplos: 1,2,3

Autorización

Usuario: Número de cliente
Contraseña: API Key

Respuesta

ConsumosResponse

Atributo	Tipo	Descripción
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición.
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición.
lConsumos	List <InfoConsumoResponse>	Lista con los consumos encontrados.

Ejemplo:

                                                    
{
  "OperacionExitosa":true,
  "Mensaje":"Operación exitosa.",
  "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
  "lConsumos":[{
                "Total": 500,
                "Litros": 37.99,
                "Combustible": "MAGNA",
                "Estacion": "Mi Estación ABC123",
                "FechaVenta": "2016-06-11T21:06:42.537",
                "IdCliente": 1,
                "FolioTarjeta": "1000000000000001",
                "Terminal": null,
                "NoEstacion": 0000,
                "PrecioUnitario": 13.16,
                "FolioVenta": "TE-0000538263"
			   },
			   {
                "Total": 139.88,
                "Litros": 9.97,
                "Combustible": "PREMIUM",
                "Estacion": "Mi Estación ABC123",
                "FechaVenta": "2016-06-09T11:05:01.78",
                "IdCliente": 1,
                "FolioTarjeta": "1000000000000002",
                "Terminal": "282000001",
                "NoEstacion": 0000,
                "PrecioUnitario": 14.03,
                "FolioVenta": "TE-0000536381"
			   }
            ]}
}

TPV Externa

Consulta el saldo y politicas de la tarjeta indicada Registra una venta Registra la última conexión de la terminal que realiza la solicitud Registra la última conexión de la terminal que realiza la solicitud Consulta una venta

Consulta el saldo y politicas de la tarjeta indicada

Método

GET

Path

api.powergas.mx/tpvexterna/v1/ConsultaSaldo

Parámetros

OperacionTarjetaRequest

Atributo	Tipo	Descripción
FolioTarjeta	string	Folio de tarjeta que se consultara
Nip	string	Nip de la tarjeta
IdCombustible	int	Tipo de combustible (1-Diesel, 2-Magna, 3-Premium)
PrecioCombustible	decimal	Precio de combustible

Autorización

Usuario: Número de serie de terminal
Contraseña: API Key

Respuesta

ConsultaSaldoResponse

Atributo	Tipo	Descripción
ESNo	int	Número de estación
ESNombre	string	Nombre de estación
ESNombreCorto	string	Nombre comercial de estación
IdCliente	int	Id cliente
Cliente	string	Nombre de cliente
FolioTarjeta	string	Número identificador de tarjeta o tag - El folio de la tarjeta es una sucesión numérica de 14 dígitos sin espacios ej.: 4441000000000000 - El folio del tag consta de un prefijo "CTLS" más una sucesión numérica de 5 dígitos numéricos sin espacios ej.: CTLS00000
Vehiculo	string	Datos de vehículos (Placas, Modelo, No. económico)
Kilometraje	decimal	Kilometraje
TotalDiario	decimal	Acumulado diario
TotalSemanal	decimal	Acumulado semanal
TotalMensual	decimal	Acumulado mensual
DiasCarga	int	Valor definido por Enumerador con atributo Flag, determina los días permitidos para cargar Lunes = 1 Martes = 2 Miércoles = 4 Jueves = 8 Viernes = 16 Sábado = 32 Domingo = 64 Todos = 127
HoraInicial	string	Horario inicial en el que se permite cargar combustible
HoraFinal	string	Horario final a partir del cual ya NO es posible cargar combustible
Combustibles	int	Valor definido por Enumerador con atributo Flag, determiona los Combustibles permitidos Diesel = 1 Magna = 2 Premium = 4
SaldoActual	decimal	Saldo actual en tarjeta
SaldoDisponible	decimal	Muestra el saldo disponible en MX Pesos/Litros
SinRestricciones	bool	Indica si existen políticas de restricción, en caso de existir y esta no se cumpla el campo OperacionExitosa sera false
LimitarPorMonto	bool	Indica si el saldo disponible se mostrara en MX Pesos o su equivalencia en litros
ValidarConductor	bool	Indica si el dato Conductor es obligatorio y debe validarse al momento de realizar una venta
ValidarPlacas	bool	Indica si el dato Placas es obligatorio y debe validarse al momento de realizar una venta
ValidarKm	bool	Indica si el dato Km es obligatorio y debe validarse al momento de realizar una venta
ValidarNoEco	bool	Indica si el dato No. Economico es obligatorio y debe validarse al momento de realizar una venta
EstacionAutorizada	bool	Indica si se validara la Estacion y se comprobara si el usuario tiene permitico cargar en ella
InfoVisible	short	Mostrar información
CapturaPrecio	bool	Último precio de combustible capturado
OperacionExitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Definición del error en caso que la solicitud no se finalice con éxito, de lo contrario el mensaje estará vacío
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición

Ejemplo:

                                                    
{
    "ESNo":12345,
    "ESNombre":"Nombre de estacion",
    "ESNombreCorto":"Nombre comercial de estacion",
    "IdCliente":12345,
    "Cliente":"Cliente",
    "FolioTarjeta":12345678901234,
    "Vehiculo":"Datos del vehiculo",
    "Kilometraje":9999.99,
    "TotalDiario":100.00,
    "TotalSemanal":500.00,
    "TotalMensual":2000.00,
    "DiasCarga":7,
    "HoraInicial":"00:00",
    "HoraFinal":"12:59",
    "Combustibles":1,
    "SaldoActual":1000.00,
    "SaldoDisponible":1000.00,
    "SinRestricciones":true,
    "LimitarPorMonto":true,
    "ValidarConductor":true,
    "ValidarPlacas":true,
    "ValidarKm":true,
    "ValidarNoEco":true,
    "EstacionAutorizada":true,
    "InfoVisible":1,
    "CapturaPrecio":true,
    "OperacionExitosa":true,
    "Mensaje":"Operación exitosa.",
    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00"
}

Registra una venta

Método

POST

Path

api.powergas.mx/tpvexterna/v1/RegistraVenta

Parámetros

RegistraVentaRequest

Atributo	Tipo	Descripción
IdCombustible	int	Tipo de combustible (1-Diesel, 2-Magna, 3-Premium).
Precio	decimal	Precio de combustible.
Total	decimal	Total de la venta.
Kilometraje	decimal	Kilometraje del vehiculo.
NoConductor	int	Numero de conductor.
NipConductor	string	Nip de condutor.
Placas	string	Placas del vehiculo.
NoEconomico	string	Numero economico del vehiculo.
FolioEstacion	string	Folio de estacion que realizo la venta.
Reintento	bool	Reintento.

Autorización

Usuario: Número de serie de terminal
Contraseña: API Key

Respuesta

VentaResponse

Atributo	Tipo	Descripción
ESNo	int	Número de estación
ESNombre	string	Nombre
ESNombreCorto	string	Nombre comercial
IdCliente	int	Id cliente
Cliente	string	Cliente
FolioTarjeta	string	Folio de tarjeta
Vehiculo	string	Datos de vehículos (Placas, Modelo, No. económico)
SaldoActual	decimal	Saldo actual
KmActual	decimal	Kilometraje actual
KmAnterior	decimal	Kilometraje anterior
Rendimiento	decimal	Rendimiento de combustible
IdCombustible	int	Combustibles (1-Diesel, 2-Magna, 3-Premium)
Precio	decimal	Precio de combustible
Litros	decimal	Litros vendidos
Total	decimal	Costo total
FolioVenta	string	Folio de venta
FolioEstacion	string	Filio de estación
FechaVenta	DateTime	Fecha de venta
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición

Ejemplo:

                                                    
{
    "ESNo":12345,
    "ESNombre":"Nombre de estacion",
    "ESNombreCorto":"Nombre comercial de estacion",
    "IdCliente":12345,
    "Cliente":"Cliente",
    "FolioTarjeta":12345678901234,
    "Vehiculo":"Datos del vehiculo",
    "SaldoActual":1000.00,
    "KmActual":9999.99,
    "KmAnterior":8888.88,
    "Rendimiento":10
    "IdCombustible":1
    "Precio":20.00
    "Litros":100
    "Total":2000.00
    "FolioVenta":"FolioVenta"
    "FolioEstacion":"FolioEstacion"
    "FechaVenta":"2016-06-09T19:25:32.453987+00:00"
    "OperacionExitosa":true,
    "Mensaje":"Operación exitosa.",
    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
}

Registra la última conexión de la terminal que realiza la solicitud

Método

GET

Path

api.powergas.mx/tpvexterna/v1/Hearthbeat

Autorización

Usuario: Número de serie de terminal
Contraseña: API Key

Respuesta

HearthbeatResponse

Atributo	Tipo	Descripción
ESNo	int	Número de estación
ESNombre	string	Nombre
ESNombreCorto	string	Nombre comercial
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición

Ejemplo:

                                                    
{
    "ESNo":12345,
    "ESNombre":"Nombre de estacion",
    "ESNombreCorto":"Nombre comercial de estacion",
    "OperacionExitosa":true,
    "Mensaje":"Operación exitosa.",
    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
}

Registra la última conexión de la terminal que realiza la solicitud

Método

POST

Path

api.powergas.mx/tpvexterna/v1/Hearthbeat

Parámetros

HearthbeatRequest

Atributo	Tipo	Descripción
Modelo	string	Modelo de TPV.
SerieTPV	string	Número de serie de TPV.
Version	string	Version.
FechaActual	string	Fecha actual.
SIM	string	SIM.
SerieSIM	string	Número de serie de SIM.
Ethernet	string	Ethernet.

Autorización

Usuario: Número de serie de terminal
Contraseña: API Key

Respuesta

HearthbeatResponse

Atributo	Tipo	Descripción
ESNo	int	Número de estación
ESNombre	string	Nombre
ESNombreCorto	string	Nombre comercial
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición

Ejemplo:

                                                    
{
    "ESNo":12345,
    "ESNombre":"Nombre de estacion",
    "ESNombreCorto":"Nombre comercial de estacion",
    "OperacionExitosa":true,
    "Mensaje":"Operación exitosa.",
    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
}

Consulta una venta

Método

POST

Path

api.powergas.mx/tpvexterna/v1/ConsultaVenta

Parámetros

ConsultaVentaRequest

Atributo	Tipo	Descripción
FolioVenta	string	Folio de venta.
Nip	string	Nip de tarjeta.

Autorización

Usuario: Número de serie de terminal
Contraseña: API Key

Respuesta

VentaResponse

Atributo	Tipo	Descripción
ESNo	int	Número de estación
ESNombre	string	Nombre
ESNombreCorto	string	Nombre comercial
IdCliente	int	Id cliente
Cliente	string	Cliente
FolioTarjeta	string	Folio de tarjeta
Vehiculo	string	Datos de vehículos (Placas, Modelo, No. económico)
SaldoActual	decimal	Saldo actual
KmActual	decimal	Kilometraje actual
KmAnterior	decimal	Kilometraje anterior
Rendimiento	decimal	Rendimiento
IdCombustible	int	Combustibles (1-Diesel, 2-Magna, 3-Premium)
Precio	decimal	Precio de combustible
Litros	decimal	Litros vendidos
Total	decimal	Costo total
FolioVenta	string	Folio de venta
FolioEstacion	string	Folio de estacion
FechaVenta	DateTime	Fecha de venta
Operación exitosa	bool	Indica el estatus de la petición. Exitosa: true/false
Mensaje	string	Indica el mensaje de éxito o error en la petición
FechaConsulta	DateTime	Indica la fecha y hora en que se realizó la petición

Ejemplo:

                                                    
{
    "ESNo":12345,
    "ESNombre":"Nombre de estacion",
    "ESNombreCorto":"Nombre comercial de estacion",
    "IdCliente":12345,
    "Cliente":"Cliente",
    "FolioTarjeta":12345678901234,
    "Vehiculo":"Datos del vehiculo",
    "SaldoActual":1000.00,
    "KmActual":9999.99,
    "KmAnterior":8888.88,
    "Rendimiento":10
    "IdCombustible":1
    "Precio":20.00
    "Litros":100
    "Total":2000.00
    "FolioVenta":"FolioVenta"
    "FolioEstacion":"FolioEstacion"
    "FechaVenta":"2016-06-09T19:25:32.453987+00:00"
    "OperacionExitosa":true,
    "Mensaje":"Operación exitosa.",
    "FechaConsulta":"2016-06-09T19:25:32.453987+00:00",
}

Bienvenido al API de PowerGAS

Clientes

Información de tarjetas

Ejemplo:

Información de mi tarjeta

Ejemplo:

Información de consumos

Ejemplo:

Información de Estados de Cuenta y Facturas

Ejemplo:

Información de rendimientos

Ejemplo:

Catálogo de vehículos

Ejemplo:

Catálogo de centro de costos

Ejemplo:

Clientes V2

Información de tarjetas

Ejemplo:

Información de mi tarjeta

Ejemplo:

Información de consumos

Ejemplo:

Información de Estados de Cuenta y Facturas

Ejemplo:

Información de rendimientos

Ejemplo:

Catálogo de vehículos

Ejemplo:

Catálogo de centro de costos

Ejemplo:

Consulta precios de combustibles

Ejemplo:

Transfiere saldo de cuenta central a tarjeta

Ejemplo:

Consulta saldo cuenta central

Ejemplo:

Estaciones

Información de Ordenes de Pago

Ejemplo:

Información de consumos

Ejemplo:

TPV Externa

Consulta el saldo y politicas de la tarjeta indicada

Ejemplo:

Registra una venta

Ejemplo:

Registra la última conexión de la terminal que realiza la solicitud

Ejemplo:

Registra la última conexión de la terminal que realiza la solicitud

Ejemplo:

Consulta una venta

Ejemplo: