# Criar e enviar uma cotação Saiba como criar, enviar e aceitar uma cotação. > Você pode usar cotações em uma *área restrita* (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, baixar ou aceitar cotações em modo de produção para faturas avulsas pela API ou Dashboard, faça upgrade para o [Invoicing Plus](https://stripe.com/invoicing/pricing). Veja qual é o plano [adequado para você](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. A cotação é uma forma de mostrar a clientes atuais ou em potencial os custos de um conjunto de produtos e serviços. As cotações mostram os custos de uma *fatura* (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) avulsa ou uma *assinatura* (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). Quando um cliente aceita a cotação, a Stripe cria automaticamente todas as faturas e assinaturas associadas. Muitos fluxos de trabalho de vendas usam essa ferramenta comum. ## Criar uma cotação Para criar uma cotação no Stripe Dashboard: 1. Acesse a [guia Faturamento](https://dashboard.stripe.com/billing). 1. Clique em **Ações rápidas** > **Criar cotação** (ou vá diretamente para o [editor de cotações](https://dashboard.stripe.com/test/quotes/create)). 1. Selecione **+ Adicionar novo cliente**. Insira o **Nome** e o **E-mail da conta** do seu cliente. Clique em **Adicionar cliente**. 1. Em **Itens**, adicione ou selecione um produto (também é possível adicionar um cupom). 1. Escolha uma data de validade. 1. (Opcional) Escreva uma observação e adicione um cabeçalho e um rodapé personalizados. Você pode definir o texto padrão futuro do cabeçalho e o rodapé no [modelo de cotação](https://dashboard.stripe.com/settings/billing/quote). 1. Para visualizar o PDF da cotação (que mostra o número da cotação gerada), clique em **Baixar prévia**. 1. Clique em **Finalizar cotação**. Após finalizar a cotação, envie-a ao seu cliente: 1. Para baixar a cotação, acesse a **página de detalhes de cotações** > **PDF da cotação**. 1. Use um endereço de e-mail externo para enviar o PDF ao seu cliente para análise. ## Marcar uma cotação como aceita Após seu cliente aceitar a cotação, cobre-o convertendo a cotação em uma fatura ou assinatura. Você só pode criar faturas avulsas se uma cotação tiver *somente* preços avulsos. Se uma cotação tiver pelo menos um preço recorrente, você só poderá convertê-la em assinatura. ### Converter uma cotação em uma fatura 1. Para marcar uma cotação como aceita e criar um rascunho de fatura, acesse **Converter em fatura** > **Detalhes das cotações**. 1. Use o [editor de faturas](https://dashboard.stripe.com/test/invoices/create) para modificar a fatura provisória, conforme necessário. 1. Envie a fatura por e-mail ou cobre o cliente automaticamente. ### Converter uma cotação em assinatura 1. No editor de cotações, escolha um cliente e crie ou selecione um produto com preço recorrente. 1. Insira os detalhes da cotação e escolha **Iniciar assinatura imediatamente** ou **Agendar uma data inicial da assinatura**. 1. Finalize a cotação. Isso marca a cotação como **Aceita**. 1. Acesse **Converter para assinatura** > **Detalhes das cotações**. 1. Insira ou modifique os detalhes da assinatura e clique em **Criar assinatura**. Se a assinatura for agendada para início imediato, a Stripe criará uma assinatura ativa e uma fatura provisória para o pagamento inicial. A Stripe finaliza automaticamente a fatura provisória em 1 hora. Caso contrário, a assinatura começará na data inicial agendada. Dependendo dos termos de pagamento da assinatura, a Stripe recebe os pagamentos cobrando a forma de pagamento cadastrada do cliente ou enviando a ele uma fatura. # 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. A cotação é uma forma de mostrar a clientes atuais ou em potencial os custos de um conjunto de produtos e serviços. As cotações mostram os custos de uma *fatura* (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) avulsa ou uma *assinatura* (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). Quando um cliente aceita a cotação, a Stripe cria automaticamente todas as faturas e assinaturas associadas. Muitos fluxos de trabalho de vendas usam essa ferramenta comum. ## Criar um cliente [Lado do servidor] > #### Use a API Accounts v2 para representar clientes > > A API Accounts v2 está geralmente disponível para usuários do Connect e em prévia pública para outros usuários da Stripe. Se faz parte da prévia de Accounts v2, é necessário [especificar uma versão de prévia](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) no seu código. > > Para solicitar acesso à prévia de Accounts v2, > > Para a maioria dos casos de uso, recomendamos [modelar seus clientes como objetos Accounts configuradas pelo cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), em vez de usar objetos [Customer](https://docs.stripe.com/api/customers.md). Para criar uma cotação, você precisa de um objeto que represente seu cliente (uma [conta](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) configurada pelo cliente ou um [cliente](https://docs.stripe.com/api/customers/object.md)) para anexar à cotação. Depois de criar um cliente, armazene o ID dele no seu banco de dados para usá-lo posteriormente na criação de uma cotação. ## Criar uma cotação [Lado do servidor] Para criar uma cotação, informe [customer_account](https://docs.stripe.com/api/quotes/create.md#create_quote-customer_account) ou [customer](https://docs.stripe.com/api/quotes/create.md#create_quote-customer) e [line_items](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items). Você pode usar preços para modelar as ofertas do seu negócio. Saiba como [configurar seu catálogo de produtos](https://docs.stripe.com/products-prices/overview.md) para usar preços com cotações. Você pode adicionar cada oferta da sua empresa à cotação como item de linha especificando o [preço](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-price) e a [quantidade](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-quantity). Por exemplo, se você quiser criar uma cotação para uma licença de software mensal que vem com uma tarifa de consulta avulsa para instalar o software, a cotação terá dois itens de linha: - O primeiro representa as cinco licenças do software, com custo unitário de US$ 100 por mês. - O segundo representa a tarifa de consultoria avulsa de US$ 1.000. As cotações são criadas com um status `draft`. Você pode modificá-las adicionando ou removendo [itens de linha](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 uma cotação [Lado do servidor] Quando estiver tudo pronto para enviar a cotação ao seu cliente, você pode mudá-la para o estado `open` ao [finalizar a cotação](https://docs.stripe.com/api/quotes/finalize.md). Como a cotação é para um cliente específico, é preciso vincular um `Customer object` a ela antes de fazer a transição para o novo estado. ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \ -u "<>:" ``` Após finalizar uma cotação, você pode baixar o PDF, que contém uma visão geral da cotação. Anexe-o a um e-mail e envie-o ao seu cliente. #### curl ```bash curl https://files.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/pdf \ -u <>: \ -G ``` Você também pode definir um [header](https://docs.stripe.com/api/quotes/create.md#create_quote-header), [footer](https://docs.stripe.com/api/quotes/create.md#create_quote-footer) e [description](https://docs.stripe.com/api/quotes/create.md#create_quote-memo) na sua cotação, que são exibidos no PDF. É possível especificar as configurações padrão para o `header`, `footer` e a `description` no [Modelo de cotação](https://dashboard.stripe.com/settings/billing/quote). Lembre-se de manter a cotação em um estado `open` enquanto o cliente a revisa. ## Marcar uma cotação como aceita [Lado do servidor] Após o cliente concordar com a cotação, mova-a para o estado `accepted`, que cria automaticamente uma fatura ou assinatura (dependendo de você ter adicionado ou não itens de linha com um preço recorrente). Quando você usa uma cotação para pagamentos avulsos, a Stripe cria uma fatura no estado `draft`. Você pode fazer alterações na sua fatura antes de [enviá-la ao cliente](https://docs.stripe.com/invoicing/integration.md). ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \ -u "<>:" ``` ## Optional: Converter uma cotação em assinatura [Lado do servidor] Para criar uma assinatura usando uma cotação, você precisa adicionar pelo menos um item de linha com um preço recorrente. Isso assegura que a cotação crie uma assinatura quando entrar no estado `accept`. Se o parâmetro [recurring](https://docs.stripe.com/api/quotes/object.md#quote_object-recurring) em uma cotação não for `null`, a Stripe criará uma assinatura ou programação de assinatura após o cliente aceitá-la. Para personalizar a assinatura, você pode especificar sua configuração usando [assinatura_data](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data). Por exemplo, você pode querer que a assinatura tenha um período de avaliação. Defina [trial_period_days](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-trial_period_days) para especificar quantos dias dura a avaliação. ```curl curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \ -u "<>:" \ -d "subscription_data[trial_period_days]=7" ``` Você pode recolher os [dados de pagamento](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout) do cliente com antecedência. Se o cliente não tiver uma forma de pagamento padrão cadastrada e você planeja cobrá-lo automaticamente, defina a cotação [collection_method](https://docs.stripe.com/api/quotes/create.md#create_quote-collection_method) como `charge_automatically`. A Stripe cria uma assinatura `active` com a primeira fatura em um estado `draft` definido como `auto_advance=true`. Finalizamos automaticamente a fatura após 1 hora, e o status da assinatura é atualizado conforme necessário. ### Criar uma programação de assinatura usando uma cotação Se você quiser que a assinatura inicie no futuro, crie uma [programação de assinatura](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md). Por exemplo, você pode querer que a assinatura inicie no primeiro dia do mês seguinte. Defina a [effective_date](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-effective_date) para especificar o início da programação da assinatura: ```curl curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \ -u "<>:" \ -d "subscription_data[effective_date]=1641013200" ```