GET /billing/current-period

Devuelve un snapshot del consumo del período mensual actual con el monto proyectado a facturar al cierre. Pensado para dashboards de control de gasto.

GET /api/v1/fe/billing/current-period
Authorization: Bearer <JWT>

Scope requerido: billing:read

Response — `200 OK`

{
  "period": "2026-06",
  "periodStart": "2026-06-01T00:00:00.000Z",
  "periodEnd": "2026-07-01T00:00:00.000Z",
  "enabled": true,
  "subscriptionId": "sub_abc123",
  "unitPrice": 0.035,
  "currency": "USD",
  "pricingTier": "standard",
  "emissionsAccepted": 1247,
  "subtotal": 43.645,
  "lastUpdated": "2026-06-15T14:23:13Z"
}

Campo	Descripción
`period`	YYYY-MM del período en curso (UTC)
`periodStart`	Inicio del período (medianoche UTC del 1ro)
`periodEnd`	Fin exclusivo del período (medianoche UTC del 1ro del próximo mes)
`enabled`	`true` si el tenant tiene el API activo
`subscriptionId`	ID de la suscripción a la que se acumulan los cargos
`unitPrice`	Precio por emisión exitosa, congelado al inicio del período
`currency`	Moneda del `unitPrice` (típicamente USD)
`pricingTier`	Tier del tenant (`standard`, `volume`, `enterprise`)
`emissionsAccepted`	Cuántas emisiones aceptadas se han contabilizado este mes
`subtotal`	`emissionsAccepted × unitPrice` — proyección del cargo del mes
`lastUpdated`	Cuándo se calculó este snapshot

Casos especiales

Tenant no enabled

{
  "period": "2026-06",
  "periodStart": "2026-06-01T00:00:00.000Z",
  "periodEnd": "2026-07-01T00:00:00.000Z",
  "enabled": false,
  "subscriptionId": null,
  "unitPrice": null,
  "currency": "DOP",
  "pricingTier": "standard",
  "emissionsAccepted": 0,
  "subtotal": 0,
  "lastUpdated": "2026-06-15T14:23:13Z"
}

Si llamas esto y enabled: false, alguien deshabilitó el API. Reactívalo desde el panel de Digimart.

Mes sin emisiones todavía

{
  "period": "2026-06",
  "enabled": true,
  "subscriptionId": "sub_abc123",
  "unitPrice": null,
  "currency": "USD",
  "pricingTier": "standard",
  "emissionsAccepted": 0,
  "subtotal": 0,
  /* ... */
}

El unitPrice es null porque el snapshot de precio se congela lazy — solo cuando llega la primera emisión del mes. Antes de eso, el tier y el precio mostrado son los defaults configurados.

Frecuencia recomendada de polling

Frecuencia	Uso
30-60s	Dashboard real-time en el panel de admin
5 min	Alerta de presupuesto excedido
1 hora	Reporting interno / histórico

El subtotal se reconcilia contra DgiiLogs cada hora por un cron de safety net. Si ves discrepancias persistentes entre lo que cuentas tú vs lo que cuenta el endpoint, contáctanos.

¿Cuándo se cobra realmente?

El monto reportado por este endpoint es lo que se agregará a tu factura mensual de Digimart al cierre del período. NO recibes una factura separada por el API.

El día del nextBillingDate de tu suscripción Digimart:

Cerramos el período actual.
Sumamos subscription.price + todos los cargos del período (incluyendo los del FE API).
Cobramos via Azul a tu método de pago configurado.
La factura mensual muestra el desglose: línea de SaaS + línea(s) de FE API.

GET /usage Códigos de error