Skip to content
Last updated

Los planes de facturación definen las tarifas y limites de uso de QRwey!. Este endpoint permite consultar los planes disponibles junto con la configuración del slider para el simulador de costos.

Obtener planes

Endpoint

GET /v1/qrs/budget/plans

Host (DEV):

https://api-dev.qrwey.com

Host (PROD):

https://api.qrwey.com

Headers requeridos

Authorization: Bearer {{access_token}}

Ejemplo de request (DEV)

curl -X GET "https://api-dev.qrwey.com/v1/qrs/budget/plans" \
  -H "Authorization: Bearer {{access_token}}"

Respuesta

{
  "plans": [
    {
      "budgetPlanId": "bp_4aca0361cfcd41c097663db44008fbb9",
      "name": "Plan Básico",
      "included": 100,
      "baseCost": 499.00,
      "full": 25.00,
      "light": 10.00,
      "overRate": 5.00
    },
    {
      "budgetPlanId": "bp_8b3f0a61cfcd41c097663db44008fcc1",
      "name": "Plan Pro",
      "included": 500,
      "baseCost": 990.00,
      "full": 20.00,
      "light": 8.00,
      "overRate": 3.50
    }
  ],
  "sliderConfig": {
    "quota": {
      "min": 0,
      "max": 5000,
      "step": 50,
      "defaultValue": 500
    },
    "rfcFull": {
      "min": 0,
      "max": 100,
      "step": 1,
      "defaultValue": 10
    },
    "rfcLight": {
      "min": 0,
      "max": 100,
      "step": 1,
      "defaultValue": 5
    }
  }
}

Campos de BudgetPlansResponse

CampoDescripción
plansLista de planes de facturación disponibles
sliderConfigConfiguración de rangos para el simulador de costos

Campos de cada plan (plans[])

CampoDescripción
budgetPlanIdIdentificador único del plan
nameNombre del plan
includedNúmero de facturas incluidas en el plan
baseCostCosto base mensual del plan
fullCosto por cada validación completa de RFC (CSF)
lightCosto por cada validación ligera de RFC
overRateCosto por cada CFDI adicional fuera del plan

Configuración del slider (sliderConfig)

Cada rango (quota, rfcFull, rfcLight) contiene:

CampoDescripción
minValor mínimo del rango
maxValor máximo del rango
stepIncremento del slider
defaultValueValor por defecto

Errores comunes

CódigoMotivo
401Token inválido o expirado

Consulta: Manejo de errores

Buenas prácticas

  • Consulta los planes disponibles para mostrar opciones al usuario en tu interfaz
  • Usa el sliderConfig para construir un simulador de costos interactivo
  • Evalúa la tarifa óptima con el endpoint de reportes del cliente para recomendar el mejor plan

¿Qué sigue?