Retenciones

Los importes retenidos en la fuente por el cliente, que pueden convertirse en crédito.

Comando	HTTP	Descripción
withholdings list	GET /v1/withholdings	Listar retenciones
withholdings get	GET /v1/withholdings/{id}	Obtener retención
withholdings convert-to-credit	POST /v1/withholdings/{id}/convert-to-credit	Convertir retención en crédito
withholdings convert-to-credits create	POST /v1/withholdings/convert-to-credits	Convertir retenciones pendientes en créditos (en lote)

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 retenciones
kobana billing withholdings list \
  --fields "id,public_id,external_id,organization_id,invoice_id"

# Obtener retención
kobana billing withholdings get --params '{"id": "WITHHOLDING_ID"}'

# Convertir retenciones pendientes en créditos (en lote)
kobana billing withholdings convert-to-credits create \
  --json '{"tax_type": "iss", "competence_year": 0, "competence_month": 0}'

# Convertir retención en crédito
kobana billing withholdings convert-to-credit \
  --params '{"id": "WITHHOLDING_ID"}' \
  --json '{"amount_cents": 100}'

Próximos pasos

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