Cómo funcionan los presupuestos
Descubre el ciclo de vida del presupuesto.
Nota
You can use quotes in a sandbox. To finalize, download, or accept quotes in live mode for one-time invoices through the API or Dashboard, you must upgrade to Invoicing Plus. See which plan is right for you.
Los presupuestos permiten ofrecer un precio estimado de los bienes o servicios solicitados y pueden facilitar la negociación antes de iniciar una suscripción o factura.
Diseñamos los estados de los presupuestos para que reflejen el flujo típico de cotización que sigue un agente de ventas, en el que se crea un presupuesto con ítems de factura que especifican los artículos que se van a comprar. Esto incluye la aplicación de cualquier descuento o impuesto, el envío del presupuesto a un posible cliente y el suministro de los servicios correspondientes tras su aceptación.
| Estado | Descripción | Acciones posibles |
|---|---|---|
draft | Estado inicial de todos los presupuestos (en esta etapa todavía puedes editar el presupuesto). | Finaliza el presupuesto pasándolo al estado open o cancélalo. |
open | Se finalizó el presupuesto y ahora está a la espera de la respuesta del cliente. En esta etapa, solo puedes modificar la fecha de vencimiento. | Marca el presupuesto como accepted o cancélalo. |
accepted | El cliente aceptó el presupuesto. Se generó una factura, una suscripción o un calendario de suscripciones a partir del presupuesto. | N/D |
canceled | El presupuesto está vencido o se canceló. Ya no puedes aceptarlo. | N/D |
Presupuestos cancelados
Cuando un cliente rechaza un presupuesto o no quieres que siga siendo válido, puedes cancelarlo. Los presupuestos cancelados ya no pueden aceptarse. Los presupuestos en estado draft o open se cancelan de forma automática cuando llega la fecha de vencimiento. Stripe genera un webhook quote..
Presupuestos aceptados
Una vez que el cliente acepta el presupuesto, puedes marcarlo como aceptado. Los presupuestos aceptados generan una factura, una suscripción o un calendario de suscripciones de forma automática, según haya o no precios recurrentes en el presupuesto o si la fecha de entrada en vigor del presupuesto es a futuro.
Transiciones del flujo de trabajo
Los presupuestos pueden alternar entre los siguientes estados:
| Estado | Punto de conexión de API | Webhook emitido | Estado final |
|---|---|---|---|
draft | POST /v1/quotes/:id/cancel | quote. | canceled |
draft | POST /v1/quotes/:id/finalize | quote. | open |
open | POST /v1/quotes/:id/cancel | quote. | canceled |
open | POST /v1/quotes/:id/accept | quote. | accepted |
Finalizar presupuestos en borrador
En un principio, los presupuestos se crean con el estado draft. En este estado, puedes editar el presupuesto y efectuar los cambios que sean necesarios. Una vez que está listo para enviarse al cliente, puedes finalizar el presupuesto, que cambiará al estado open mientras esperas una respuesta.
Al finalizar un presupuesto se le asigna un number. Este número consta de las siguientes cuatro partes: el prefijo QT, el prefijo de la factura del cliente, la secuencia del presupuesto y la secuencia de revisión. Por ejemplo, QT-68BB114-0001-1 es el primer presupuesto para un cliente en su primera revisión. Así, el número de presupuesto QT-68BB114-0001-2 refiere al mismo presupuesto, pero en su segunda revisión. El número QT-68BB114-0002-1 correspondería al segundo presupuesto para el cliente.
Puedes finalizar un presupuesto mediante la API, como se muestra en el siguiente ejemplo.
Aceptar un presupuesto
Solo puedes marcar un presupuesto como aceptado si está en estado open. Al hacerlo, el presupuesto pasa al estado accepted y se crea la factura, la suscripción o el calendario de suscripciones.
Si el presupuesto no tiene un precio recurrente en ninguno de sus ítems de factura, se crea un draft de la factura a partir del presupuesto con auto_ establecido en false. Puedes modificar la factura antes de finalizarla y enviarla al cliente para su pago.
Si el presupuesto tiene al menos un precio recurrente en un ítem de factura, se crea una suscripción o un calendario de suscripciones. Si la fecha de entrada en vigor del presupuesto es futura, se crea un calendario de suscripciones; de lo contrario, se crea una suscripción. La primera factura de la suscripción tendrá el estado de draft con auto_ establecido en true.
En el Dashboard, puedes marcar un presupuesto como aceptado con los botones Convertir en factura y Convertir en suscripción que se encuentran en la página de detalles del presupuesto. Puedes marcar un presupuesto como aceptado a través de la API, como se muestra en el siguiente ejemplo.
Cancelar un presupuesto
Puedes cancelar un presupuesto si su estado es draft o open. Cancela un presupuesto desde el Dashboard, en la página de detalles del presupuesto, o mediante la API, como se muestra en el siguiente ejemplo.
Descargar un presupuesto en PDF
El método en PDF funciona de manera diferente a la mayoría de los métodos del SDK que quizá suelas usar y que normalmente devuelven datos en formato JSON. En cambio, el método en PDF tiene un resultado único.
Devuelve directamente un flujo de datos que representa las secuencias de bytes de los datos entrantes.
Puesto en práctica, en lugar de esperar a que todo el conjunto de datos se cargue para que esté disponible, el flujo de bytes se puede leer en «fragmentos» o segmentos a medida que entran los flujos de datos.
Este método es especialmente útil para el manejo de muchos datos o el procesamiento de datos en tiempo real. Esto se debe a que puedes comenzar a procesar los datos entrantes antes de que se complete toda su carga.