Suscripciones

El contrato vivo entre un cliente y un plan: activar, pausar, reanudar, cambiar de plan y cancelar. create-invoice fuerza una factura fuera del ciclo.

Comando	HTTP	Descripción
subscriptions list	GET /v1/subscriptions	Listar suscripciones
subscriptions create	POST /v1/subscriptions	Crear suscripción
subscriptions get	GET /v1/subscriptions/{id}	Obtener suscripción
subscriptions update	PATCH /v1/subscriptions/{id}	Actualizar suscripción
subscriptions delete	DELETE /v1/subscriptions/{id}	Cancelar y quitar suscripción (soft delete)
subscriptions activate	POST /v1/subscriptions/{id}/activate	Activar suscripción en borrador/confirmada
subscriptions cancel	POST /v1/subscriptions/{id}/cancel	Cancelar suscripción
subscriptions change-plan	POST /v1/subscriptions/{id}/change-plan	Cambiar el plan de la suscripción
subscriptions create-invoice	POST /v1/subscriptions/{id}/create-invoice	Generar una factura suelta para la suscripción
subscriptions items	GET /v1/subscriptions/{id}/items	Listar los ítems de la suscripción
subscriptions pause	POST /v1/subscriptions/{id}/pause	Pausar suscripción
subscriptions resume	POST /v1/subscriptions/{id}/resume	Reanudar suscripción pausada
subscriptions revert-to-confirmed	POST /v1/subscriptions/{id}/revert-to-confirmed	Revertir la suscripción al estado confirmado
subscriptions sync-plan-items	POST /v1/subscriptions/{id}/sync-plan-items	Resincronizar ítems con el plan actual

Ejemplos

--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar suscripciones
kobana billing subscriptions list \
  --fields "id,public_id,external_id,billing_account_id,company_id"

# Obtener suscripción
kobana billing subscriptions get --params '{"id": "SUBSCRIPTION_ID"}'

# Crear suscripción
kobana billing subscriptions create \
  --json '{"billing_account_id": "BILLING_ACCOUNT_ID"}'

# Actualizar suscripción
kobana billing subscriptions update \
  --params '{"id": "SUBSCRIPTION_ID"}' \
  --json '{"external_id": "EXTERNAL_ID", "plan_id": "PLAN_ID", "billing_cycle": "monthly"}'

# Activar suscripción en borrador/confirmada
kobana billing subscriptions activate --params '{"id": "SUBSCRIPTION_ID"}'

# Cancelar y quitar suscripción (soft delete)
kobana billing subscriptions delete \
  --params '{"id": "SUBSCRIPTION_ID"}' \
  --dry-run

Próximos pasos

• Cambios de suscripción
• Introspección de schema — todos los parámetros que este recurso acepta.