Propuestas

El presupuesto antes de la suscripción: publicar, enviar, generar PDF y aceptar. Aceptar es lo que convierte la propuesta en suscripción — y undo-accept lo deshace.

Comando	HTTP	Descripción
proposals list	GET /v1/proposals	Listar propuestas
proposals create	POST /v1/proposals	Crear propuesta
proposals get	GET /v1/proposals/{id}	Obtener propuesta
proposals update	PATCH /v1/proposals/{id}	Actualizar propuesta
proposals delete	DELETE /v1/proposals/{id}	Eliminar propuesta
proposals accept	POST /v1/proposals/{id}/accept	Aceptar propuesta
proposals cancel	POST /v1/proposals/{id}/cancel	Cancelar propuesta
proposals duplicate	POST /v1/proposals/{id}/duplicate	Duplicar propuesta
proposals generate-pdf	POST /v1/proposals/{id}/generate-pdf	Generar el PDF de la propuesta
proposals json	GET /v1/proposals/{id}/json	Obtener la instantánea JSON de la propuesta
proposals pricing	GET /v1/proposals/{id}/pricing	Obtener el cálculo de precio de la propuesta
proposals publish	POST /v1/proposals/{id}/publish	Publicar propuesta
proposals send	POST /v1/proposals/{id}/send	Enviar propuesta por correo
proposals undo-accept	POST /v1/proposals/{id}/undo-accept	Deshacer la aceptación de la propuesta
proposals unpublish	POST /v1/proposals/{id}/unpublish	Despublicar propuesta
proposals bulk-cancel create	POST /v1/proposals/bulk-cancel	Cancelar propuestas en lote
proposals bulk-delete create	POST /v1/proposals/bulk-delete	Eliminar propuestas en lote
proposals bulk-send create	POST /v1/proposals/bulk-send	Enviar propuestas en lote
proposals items get	GET /v1/proposals/{id}/items	Listar los ítems de la propuesta
proposals items create	POST /v1/proposals/{id}/items	Agregar ítem a la propuesta
proposals items update	PATCH /v1/proposals/{id}/items/{itemId}	Actualizar ítem de la propuesta
proposals items delete	DELETE /v1/proposals/{id}/items/{itemId}	Eliminar ítem de la propuesta
proposals stats list	GET /v1/proposals/stats	Obtener estadísticas de propuestas

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 propuestas
kobana billing proposals list \
  --fields "id,public_id,external_id,company_id,code"

# Obtener propuesta
kobana billing proposals get --params '{"id": "PROPOSAL_ID"}'

# Crear propuesta
kobana billing proposals create \
  --json '{"company_id": "COMPANY_ID", "title": "TITLE", "description": "DESCRIPTION"}'

# Actualizar propuesta
kobana billing proposals update \
  --params '{"id": "PROPOSAL_ID"}' \
  --json '{"company_id": "COMPANY_ID", "title": "TITLE", "description": "DESCRIPTION"}'

# Aceptar propuesta
kobana billing proposals accept \
  --params '{"id": "PROPOSAL_ID"}' \
  --json '{"cycle": "monthly"}'

# Eliminar propuesta
kobana billing proposals delete --params '{"id": "PROPOSAL_ID"}' --dry-run

Próximos pasos

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