Consulta de Tarifas

Descripción

El endpoint GET /tarifas permite consultar el listado de tarifas disponibles para el canal autenticado. Es un endpoint de solo lectura que proporciona información actualizada sobre las tarifas configuradas.

Endpoint

Headers requeridos

Headers opcionales

Autenticación

Obtener token JWT

Primero debes obtener un token JWT autenticándote:

curl -X POST https://oezimzeqmtmncuipqgwd.supabase.co/functions/v1/initiateauthcommand \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tu_usuario@ejemplo.com",
    "password": "tu_contraseña"
  }'

Respuesta:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}

Ejemplos de uso

1. Consulta básica de tarifas

Obtener las tarifas del canal por defecto:

curl -X GET https://pre-webhooks.imaginaenergia.com/tarifas \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Respuesta (200 OK):

{
  "request_id": 12345,
  "tarifas": [
    {
      "id_tarifa": 10350,
      "nombre": "Tarifa Base 2.0TD",
      "tipo": "residencial",
      "descripcion": "Tarifa básica para uso residencial",
      "precio_energia_p1": 0.145,
      "precio_energia_p2": 0.132,
      "precio_energia_p3": 0.098,
      "precio_potencia_p1": 0.105,
      "precio_potencia_p2": 0.065,
      "activa": true
    },
    {
      "id_tarifa": 10351,
      "nombre": "Tarifa Premium 2.0TD",
      "tipo": "residencial",
      "descripcion": "Tarifa premium con ventajas adicionales",
      "precio_energia_p1": 0.138,
      "precio_energia_p2": 0.125,
      "precio_energia_p3": 0.092,
      "precio_potencia_p1": 0.098,
      "precio_potencia_p2": 0.058,
      "activa": true
    }
  ]
}

2. Consulta con impersonación de canal

Si tienes permisos de impersonación, puedes consultar tarifas de otros canales:

curl -X GET https://pre-webhooks.imaginaenergia.com/tarifas \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "X-Canal: 550e8400-e29b-41d4-a716-446655440000"

3. Ejemplo en Python

import requests

url = "https://pre-webhooks.imaginaenergia.com/tarifas"
token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

headers = {
    "Authorization": f"Bearer {token}"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(f"Request ID: {data['request_id']}")
    print(f"Tarifas: {len(data['tarifas'])}")
    
    for tarifa in data['tarifas']:
        print(f"- {tarifa['nombre']} (ID: {tarifa['id_tarifa']})")
else:
    print(f"Error: {response.status_code}")
    print(response.json())

Estructura de la respuesta

Respuesta exitosa (200 OK)

Estructura de cada tarifa

Manejo de errores

Códigos de respuesta HTTP

Ejemplos de errores

Error 401 - Autenticación fallida

{
  "error": "Authentication failed"
}

Solución: Verificar que el token JWT sea válido y no haya expirado.

Error 403 - Sin permisos

{
  "error": "Forbidden: No tiene permisos para impersonar este canal",
  "request_id": 12345
}

Solución: Verificar permisos de impersonación y UUID del header X-Canal.

Error 500 - Error de servidor

{
  "error": "Error de servidor, por favor contacte con serviciosistemas@imaginaenergia.com",
  "request_id": 12345
}

Solución: Contactar con soporte incluyendo el request_id.

Auditoría y seguimiento

Todas las peticiones al endpoint se registran automáticamente en la base de datos con:

• ID único de la petición (request_id)
• Usuario que realizó la petición (del token JWT)
• Canal consultado (directo o impersonado)
• Timestamp de la petición
• Resultado completo de la consulta
• Código de estado HTTP

Integración con otros endpoints

El id_tarifa obtenido se utiliza en:

Flujo recomendado

1. Consultar tarifas disponibles → GET /tarifas
2. Presentar tarifas al usuario o sistema
3. Seleccionar tarifa apropiada
4. Usar id_tarifa en la contratación

Preguntas frecuentes

¿Necesito enviar parámetros en el body?

No, es un endpoint GET que no requiere body. La información se obtiene del token JWT y opcionalmente del header X-Canal.

¿Las tarifas cambian frecuentemente?

Las tarifas son configuradas por el administrador. Se recomienda consultar el endpoint cuando sea necesario en lugar de cachear por períodos largos.

¿Qué hago con el request_id?

Es útil para seguimiento de auditoría, reportar incidencias a soporte y análisis de uso del API.

¿Puedo consultar tarifas de múltiples canales a la vez?

No, cada petición consulta un único canal. Para múltiples canales, realiza peticiones separadas con diferentes valores de X-Canal.

Soporte