Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Ferramentas para desenvolvedores
Visão geral
Billing
    Visão geral
    Sobre as APIs do Billing
    Assinaturas
    Invoicing
    Cobrança por uso
    Connect e Billing
    Tax e Billing
    Cotações
      Como funcionam as cotações
      Criar uma cotação
      Renegociar uma cotação
    Recuperação de receitas
    Automações
    Scripts
    Reconhecimento de receitas
    Gerenciamento de clientes
    Direitos
    Teste sua integração
Tributos
Relatórios
Dados
Incorporação de startups
Página inicialReceitaBillingQuotes

Criar e enviar uma cotação

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

Copiar página

Observação

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
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
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
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
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

Esta página foi útil?
SimNão
Precisa de ajuda? Fale com o suporte.
Participe do nosso programa de acesso antecipado.
Confira nosso changelog.
Dúvidas? Fale com a equipe de vendas.
LLM? Read llms.txt.
Powered by Markdoc