Clientes

Quién es cobrado, sus usuarios de portal y el extracto consolidado. recalculate-mrr recalcula el ingreso recurrente del cliente.

Comando	HTTP	Descripción
customers list	GET /v1/customers	Listar clientes
customers create	POST /v1/customers	Crear cliente
customers get	GET /v1/customers/{id}	Obtener cliente
customers update	PATCH /v1/customers/{id}	Actualizar cliente
customers delete	DELETE /v1/customers/{id}	Quitar cliente (soft delete)
customers recalculate-mrr	POST /v1/customers/{id}/recalculate-mrr	Recalcular el MRR del cliente
customers statement get	GET /v1/customers/{id}/statement	Listar el extracto financiero del cliente
customers statement sync create	POST /v1/customers/{id}/statement/sync	Reconstruir el extracto a partir del historial
customers users get	GET /v1/customers/{id}/users	Listar los usuarios del portal del cliente
customers users create	POST /v1/customers/{id}/users	Invitar usuario del portal
customers users update	PATCH /v1/customers/{id}/users/{user_id}	Actualizar usuario del portal
customers users delete	DELETE /v1/customers/{id}/users/{user_id}	Quitar usuario del portal
customers users email-preview	GET /v1/customers/{id}/users/{user_id}/email-preview	Previsualizar el correo del usuario del portal
customers users resend	POST /v1/customers/{id}/users/{user_id}/resend	Reenviar correo de invitación o verificación
customers users invite create	POST /v1/customers/{id}/users/invite	Invitar usuario del portal (verbo)

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 clientes
kobana billing customers list \
  --fields "id,public_id,external_id,name,nickname"

# Obtener cliente
kobana billing customers get --params '{"id": "CUSTOMER_ID"}'

# Crear cliente
kobana billing customers create --json '{"name": "NAME"}'

# Actualizar cliente
kobana billing customers update \
  --params '{"id": "CUSTOMER_ID"}' \
  --json '{"name": "NAME", "external_id": "EXTERNAL_ID", "nickname": "NICKNAME"}'

# Recalcular el MRR del cliente
kobana billing customers recalculate-mrr --params '{"id": "CUSTOMER_ID"}'

# Quitar cliente (soft delete)
kobana billing customers delete --params '{"id": "CUSTOMER_ID"}' --dry-run

Próximos pasos

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