# Crear y enviar un presupuesto Aprende a crear, enviar y aceptar un presupuesto. > Puedes usar comillas en un *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Para finalizar, descargar o aceptar presupuestos en modo activo para facturas únicas a través del API o Dashboard, debes actualizar a [Invoicing Plus](https://stripe.com/invoicing/pricing). Consulta qué plan es [adecuado para tí](https://support.stripe.com/questions/how-to-access-quotes). # Dashboard > This is a Dashboard for when testing-method is without-code. View the full page at https://docs.stripe.com/quotes/create?testing-method=without-code. Un presupuesto es una manera de mostrar a clientes actuales o potenciales los costos de un conjunto de productos o servicios. Los presupuestos muestran el costo de una *factura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) única o una *suscripción* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis). Cuando un cliente acepta el presupuesto, Stripe crea automáticamente todas las facturas y suscripciones relevantes. Muchos flujos de trabajo de ventas usan esta herramienta común. ## Crear un presupuesto Para crear un presupuesto en el Dashboard de Stripe: 1. Ve a la [pestaña Facturación](https://dashboard.stripe.com/billing). 1. Haz clic en **Acciones rápidas** > **Crear presupuesto** (o ve directamente al [editor de presupuestos](https://dashboard.stripe.com/test/quotes/create)). 1. Selecciona **+ Agregar nuevo cliente**. Completa, como mínimo, el **Nombre** y el **Correo electrónico de la cuenta** del cliente. Haz clic en **Agregar cliente**. 1. En la sección **Ítems**, agrega o selecciona un producto. (También puedes agregar un cupón). 1. Elige una fecha de vencimiento. 1. (Opcional) Escribe una nota y agrega un encabezado y un pie de página personalizados. Puedes establecer el texto predeterminado que aparecerá en el encabezado y pie de página de la [plantilla de presupuesto](https://dashboard.stripe.com/settings/billing/quote). 1. Para obtener una vista previa del PDF del presupuesto (que muestra el número de presupuesto generado) haz clic en **Descargar vista previa**. 1. Haz click en **Finalizar presupuesto**. Después de finalizar el presupuesto, envíaselo al cliente: 1. Para descargar el presupuesto, ve a la **Página de detalles del presupuesto** > **PDF del presupuesto**. 1. Usa una dirección de correo electrónico externa para enviar el PDF a tu cliente para que lo revise. ## Marcar un presupuesto como aceptado Después de que tu cliente acepte el presupuesto, podrás facturarle. Para hacerlo, convierte el presupuesto en una factura o suscripción. Solo puedes crear facturas puntuales si un presupuesto tiene *solamente* precios únicos. Si el presupuesto incluye al menos un precio recurrente, solo podrás convertirlo en una suscripción. ### Convertir un presupuesto en una factura 1. Para marcar un presupuesto como aceptado y crear un borrador de la factura, ve a **Convertir en factura** > **Detalles de los presupuestos**. 1. Para modificar el borrador de la factura, usa el [editor de facturas](https://dashboard.stripe.com/test/invoices/create). 1. Envía la factura por correo electrónico o cobra automáticamente al cliente. ### Convertir un presupuesto en una suscripción 1. En el editor de presupuestos, elige un cliente y crea o selecciona un producto con un precio recurrente. 1. Ingresa los detalles del presupuesto y elige si quieres **iniciar la suscripción de inmediato** o **programar la fecha de inicio de la suscripción**. 1. Finaliza el presupuesto. Al hacer esto, se marca como **Aceptado**. 1. Ve a **Convertir en suscripción** > **Detalles de los presupuestos**. 1. Ingresa o modifica los detalles de la suscripción. Luego, haz click en **Crear suscripción**. Si programas la suscripción para que comience al instante, Stripe crea una suscripción activa junto con un borrador de factura para el pago inicial. Stripe finaliza el borrador de la factura automáticamente en una hora. En caso contrario, la suscripción comienza en la fecha de inicio programada. Según las condiciones de pago de la suscripción, Stripe cobra el pago realizando el cargo en el método de pago del cliente en sus archivos o enviándole una factura. # API > This is a API for when testing-method is with-code. View the full page at https://docs.stripe.com/quotes/create?testing-method=with-code. Un presupuesto es una manera de mostrar a clientes actuales o potenciales los costos de un conjunto de productos o servicios. Los presupuestos muestran el costo de una *factura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) única o una *suscripción* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis). Cuando un cliente acepta el presupuesto, Stripe crea automáticamente todas las facturas y suscripciones relevantes. Muchos flujos de trabajo de ventas usan esta herramienta común. ## Crear un cliente [Lado del servidor] > #### Usa la API Accounts v2 para representar a los clientes > > La API Accounts v2 suele estar disponible para usuarios Connect y en versión preliminar pública para otros usuarios de Stripe. Si eres parte de la versión preliminar Accounts v2, debes especificar una [versión preliminar](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código. > > Para solicitar el acceso a la versión preliminar Accounts v2, > > Para la mayoría de los casos de uso, recomendamos [modelar a tus clientes como objetos Account configurados por el cliente](https://docs.stripe.com/connect/use-accounts-as-customers.md) en lugar de usar objetos [Customer](https://docs.stripe.com/api/customers.md). Para crear un presupuesto, necesitas un objeto que represente a tu cliente (ya sea un objeto [Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) configurado por el cliente o un objeto [Customer](https://docs.stripe.com/api/customers/object.md)) para adjuntarlo al presupuesto. Después de crear un cliente, debes guardar su ID en tu base de datos para poder usarlo más tarde para crear un presupuesto. ## Crear un presupuesto [Lado del servidor] Para crear un presupuesto, especifica lo siguiente: [customer_account](https://docs.stripe.com/api/quotes/create.md#create_quote-customer_account) o [customer](https://docs.stripe.com/api/quotes/create.md#create_quote-customer) y [line_items](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items). Puedes usar precios para modelar las ofertas que ofrece tu empresa. Aprende a [configurar tu catálogo de productos](https://docs.stripe.com/products-prices/overview.md) para usar precios con presupuestos. Puedes agregar cada oferta de tu empresa al presupuesto como una partida, especificando el [precio](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-price) y la [cantidad](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-quantity). Por ejemplo, si quisieras crear un presupuesto para una licencia de software mensual que tiene una comisión única de consulta por la instalación del software, el presupuesto contendría dos partidas: - El primer ítem de la factura refiere a cinco licencias por el costo de USD 100 al mes por licencia del software. - El segundo ítem de factura refiere a la comisión única de consulta por USD 1000. Un presupuesto recién creado está en estado `draft`. Puedes modificar los borradores de presupuestos agregando o eliminando [partidas](https://docs.stripe.com/api/quotes/update.md#update_quote-line_items). #### Accounts v2 ```curl curl https://api.stripe.com/v1/quotes \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "line_items[0][price]=price_CBb6IXqvTLXp3f" \ -d "line_items[0][quantity]=5" \ -d "line_items[1][price]=price_HGd7M3DV3IMXkC" ``` #### Customers v1 ```curl curl https://api.stripe.com/v1/quotes \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "line_items[0][price]=price_CBb6IXqvTLXp3f" \ -d "line_items[0][quantity]=5" \ -d "line_items[1][price]=price_HGd7M3DV3IMXkC" ``` ## Enviar un presupuesto [Lado del servidor] Cuando tengas todo listo para enviar el presupuesto al cliente, puedes cambiarlo a un estado `open` [finalizando el presupuesto](https://docs.stripe.com/api/quotes/finalize.md). Dado que el presupuesto es para un cliente en particular, debes asociarle un `Customer object` antes de que pueda cambiar de estado. ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \ -u "<>:" ``` Después de que se finaliza un presupuesto, puedes descargar el PDF, que contiene un resumen del presupuesto. Adjúntalo al correo electrónico y envíaselo al cliente. #### curl ```bash curl https://files.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/pdf \ -u <>: \ -G ``` También puedes establecer un [header](https://docs.stripe.com/api/quotes/create.md#create_quote-header), un [footer](https://docs.stripe.com/api/quotes/create.md#create_quote-footer) y una [description](https://docs.stripe.com/api/quotes/create.md#create_quote-memo) en el presupuesto, que se muestran en el PDF. Puedes especificar las opciones predeterminadas para el `header`, el `footer` y la `description` en la [configuración de la plantilla de presupuesto](https://dashboard.stripe.com/settings/billing/quote). Recuerda mantener el presupuesto en estado `open` mientras tu cliente lo revisa. ## Marcar un presupuesto como aceptado [Lado del servidor] Una vez que el cliente haya aceptado el presupuesto, puedes pasarlo al estado `accepted`, que crea automáticamente una factura o una suscripción (en función de si agregaste o no partidas con un precio recurrente). Cuando creas un presupuesto para pagos únicos, Stripe crea una factura en estado `draft`. Antes de [enviarla a tu cliente](https://docs.stripe.com/invoicing/integration.md), puedes modificarla. ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \ -u "<>:" ``` ## Optional: Convertir un presupuesto en una suscripción [Lado del servidor] Para crear una suscripción mediante un presupuesto, es necesario agregar al menos una partida con un precio recurrente. Esto garantiza que el presupuesto creará una suscripción cuando pase al estado `accept`. Si el parámetro [recurring](https://docs.stripe.com/api/quotes/object.md#quote_object-recurring) de un presupuesto no es `null`, Stripe crea una suscripción o un calendario de suscripciones después de que el cliente acepta el presupuesto. Para personalizar la suscripción, puedes especificar su configuración usando [subscription_data](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data). Por ejemplo, es posible que quieras que la suscripción tenga un período de prueba. Establece [trial_period_days](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-trial_period_days) para especificar cuántos días durará la prueba. ```curl curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \ -u "<>:" \ -d "subscription_data[trial_period_days]=7" ``` Puedes recopilar los [datos de pago](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout) de tu cliente con antelación. Si tu cliente no tiene un método de pago predeterminado en sus registros y planeas aceptar pagos de forma automática, establece la opción [collection_method](https://docs.stripe.com/api/quotes/create.md#create_quote-collection_method) del presupuesto en `charge_automatically`. Stripe crea una suscripción en estado `active` con la primera factura en estado `draft` establecida en `auto_advance=true`. La factura se finaliza de forma automática después de 1 hora y el estado de la suscripción se actualiza en consecuencia. ### Crear un calendario de suscripción a partir de un presupuesto Si quieres que tu suscripción comience en un día futuro, crea un [calendario de suscripciones](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Por ejemplo, tal vez quieras que la suscripción comience el primer día del mes siguiente. Establece [effective_date](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-effective_date) para especificar cuándo comienza el calendario de suscripciones: ```curl curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \ -u "<>:" \ -d "subscription_data[effective_date]=1641013200" ```