Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Criar contaLogin

Criar e enviar uma cotação

Saiba como criar, enviar e aceitar uma cotação.

Nota

Você pode usar cotações em uma área restrita. 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. Veja qual é o plano adequado para você.

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 avulsa ou uma assinatura. 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

Para criar uma cotação, passe um item de linha para cada produto ou serviço. Associe um objeto Customer à cotação para representar o cliente. Após criar o cliente, armazene o id no seu banco de dados para utilizá-lo mais tarde. Na próxima etapa, você usará o cliente para criar uma cotação.

Criar uma cotação
Lado do servidor

Para criar uma cotação, passe o Cliente e os Itens de linha. Você pode usar preços para modelar as ofertas fornecidas por sua empresa. Saiba como configurar seu catálogo de produtos 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 e a quantidade. 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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/quotes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_GBV60HKsE0mb5v \
  -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. 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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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.

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://files.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/pdf \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -G

Você também pode definir um header, footer e description 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. 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.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

OpcionalConverter 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 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 subscription_data. Por exemplo, você pode querer que a assinatura tenha um período de avaliação. Defina trial_period_days para especificar a duração da avaliação em dias.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "subscription_data[trial_period_days]"=7

Você pode coletar os dados de pagamento do seu cliente antecipadamente. Se o cliente não tiver uma payment_method registrada e você planejar cobrá-lo automaticamente, defina o collection_method da cotação 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. Por exemplo, você pode querer que a assinatura inicie no primeiro dia do mês seguinte. Defina a effective_date para especificar o início da programação da assinatura:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "subscription_data[effective_date]"=1641013200