# Como o faturamento funciona Saiba mais sobre as etapas do ciclo de vida de uma fatura. As faturas fornecem uma lista detalhada de mercadorias e serviços prestados, que inclui o custo, a quantidade e os impostos. Você pode enviar faturas aos clientes para recolher o pagamento ou pode criar uma fatura e cobrar automaticamente a forma de pagamento salva do cliente. *Subscriptions* (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) geram faturas automaticamente para cada ciclo de cobrança. Saiba mais sobre o ciclo de [vida da faturas para assinaturas](https://docs.stripe.com/billing/invoices/subscription.md#sub-invoice-lifecycle). Quando cria uma fatura, você pode selecionar um [cliente](https://docs.stripe.com/invoicing/customer.md) e [produto](https://docs.stripe.com/invoicing/products-prices.md) existentes ou criar e salvar novos. Também é possível criar produtos de compra avulsa que só existem na fatura atual. Você pode usar o [Dashboard](https://docs.stripe.com/invoicing/dashboard.md) and the [API](https://docs.stripe.com/api/invoices.md) para criar, editar e gerenciar faturas. ## Ciclo de vida da fatura Depois de serem criadas manualmente ou como parte de uma assinatura, as faturas passam por diferentes status à medida que são criadas e processadas. A Stripe chama isso de fluxo de trabalho de cobrança automática. O ciclo de vida básico das faturas é assim: 1. Uma fatura recém-criada tem o status `draft`. 1. A Stripe [finaliza uma fatura](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized) quando ela está pronta para ser paga, alterando seu status para `open`. Não é possível alterar a maioria dos detalhes de uma fatura finalizada. 1. A Stripe pode aguardar o cliente pagar a fatura ou tentar pagá-la automaticamente usando a forma de pagamento padrão do cliente. - Se o pagamento for bem-sucedido, a Stripe atualiza o status da fatura para `paid`. - Se o pagamento falhar ou a fatura não for totalmente paga, a fatura permanecerá `open`. 1. Como opção, você pode alterar o status de uma fatura não paga para `void` ou `uncollectible`. 1. Você também pode alterar o status de uma fatura paga de volta para aberto ao [cancelando os pagamentos ](https://docs.stripe.com/invoicing/apply-payments.md) associados à mesma. Você pode [configurar a Stripe para enviar e-mails ao cliente](https://docs.stripe.com/invoicing/send-email.md) em diferentes estágios do ciclo de vida da fatura, como quando uma fatura é finalizada ou quando o pagamento automático falha. ## Status da fatura As faturas podem ter um dos seguintes status. As ações que você pode realizar em uma fatura dependem do status. | Status | Descrição | Ações possíveis | | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [draft](https://docs.stripe.com/invoicing/overview.md#draft) | A fatura não está pronta para uso. Todas as faturas começam com o status `draft`. | - Edite qualquer parte da fatura. - Quando a fatura estiver pronta para uso, finalize-a alterando seu status para `open`. - Se a fatura não estiver associada a uma assinatura, [exclua](https://docs.stripe.com/invoicing/overview.md#deleted). | | [open](https://docs.stripe.com/invoicing/overview.md#open) | A fatura está finalizada e aguarda pagamento. | - Envie a fatura a um cliente para pagamento. - Altere [somente alguns elementos da fatura](https://docs.stripe.com/invoicing/invoice-edits.md). Para fazer alterações mais significativas, crie uma nova fatura e anule a antiga. - Altere o status da fatura para `paid`, `void` ou `uncollectible`. - [Edite](https://docs.stripe.com/invoicing/invoice-edits.md) a fatura. | | [paid](https://docs.stripe.com/invoicing/overview.md#paid) | Esta fatura está paga. | - Altere o status da fatura para `aberta`. - Retirar pagamentos da fatura. | | [void](https://docs.stripe.com/invoicing/overview.md#void) | Esta fatura foi cancelada. | - Nenhuma ação adicional. | | [uncollectible](https://docs.stripe.com/invoicing/overview.md#uncollectible) | O cliente provavelmente não pagará a fatura. Normalmente, você a trata como dívida incobrável no seu processo contábil. | - Altere o status da fatura para `void` ou `paid`. | ### Faturas provisórias Você pode atualizar quase todos os detalhes de uma fatura `draft`. Você também pode excluí-la, a menos que esteja associada a uma assinatura. Quando uma fatura `draft` está pronta para ser enviada para pagamento, você a finaliza alterando seu status para `open`. Você pode excluir uma fatura `draft`. Não é possível recuperar uma fatura excluída. #### Dashboard 1. Acesse a [página de faturas](https://dashboard.stripe.com/test/invoices). 1. Clique no menu de navegação (⋯) ao lado da fatura. 1. Clique em **Excluir rascunho**. #### API Se você excluir uma fatura usando a API e tiver configurado endpoints de [webhook](https://docs.stripe.com/webhooks.md), a Stripe enviará um evento `invoice.deleted`. ```curl curl -X DELETE https://api.stripe.com/v1/invoices/id \ -u "<>:" ``` ### Faturas abertas A fatura foi finalizada e ainda tem um saldo restante. Se o valor devido for inferior ao [valor mínimo cobrável](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts), a fatura muda automaticamente para o status `paid` e a Stripe debita o valor do [saldo de crédito do cliente](https://docs.stripe.com/billing/customer/balance.md). No Dashboard, as faturas com status `open` podem exibir um emblema diferente, como `Past due`ou `Retrying`. Em alguns cenários, você pode passar o cursor sobre o emblema para ver uma dica de ferramenta explicativa. Se uma fatura aberta sem assinatura estiver aguardando um pagamento iniciado, mas ainda pendente, ela mostrará o emblema `Pending` na lista de faturas. No entanto, sua página de detalhes mostra o emblema `Open`. Você pode atualizar apenas alguns elementos de uma fatura aberta, como a observação ou os metadados. Para fazer alterações mais significativas, você deve [revisar a fatura](https://docs.stripe.com/invoicing/invoice-edits.md) substituindo-a por uma nova. Não é possível excluir uma fatura finalizada. Para cancelá-la, altere o status para `void`. ### Faturas pagas O cliente pagou a fatura. Esse status é terminal, o que significa que o status da fatura não pode mais mudar. #### Dashboard Para tentar pagar uma fatura no Dashboard, abra a [página de detalhes da fatura](https://docs.stripe.com/invoicing/dashboard/manage-invoices.md#invoice-details-page) e clique em **Cobrar cliente**. #### API O exemplo a seguir mostra como fazer a transição de uma fatura para um estado `paid` usando o endpoint [Pay](https://docs.stripe.com/api/invoices/pay.md). Se tiver configurado endpoints de [webhook](https://docs.stripe.com/webhooks.md), você receberá um evento `invoice.payment_failed` ou `invoice.paid`, dependendo do resultado da tentativa de pagamento. ```curl curl -X POST https://api.stripe.com/v1/invoices/id/pay \ -u "<>:" ``` Você recebe o evento `invoice.payment_succeeded` somente quando um PaymentIntent relacionado à fatura for criado e concluído com êxito. A Stripe envia o evento `invoice.paid` quando uma fatura muda para `paid`. Uma fatura pode mudar para `paid` sem um PaymentIntent associado bem-sucedido se: - Está relacionado a uma avaliação ou assinatura gratuita - Tem um `amount_due` coberto por um [saldo de crédito do cliente](https://docs.stripe.com/billing/customer/balance.md) ou abaixo do [valor mínimo de cobrança](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) - Está marcado como [paid_out_of_band](https://docs.stripe.com/api/invoices/pay.md#pay_invoice-paid_out_of_band) Nesses casos, você recebe o evento `invoice.paid`, mas nenhum evento`invoice.payment_succeeded`. #### Faturas fora de banda Se um cliente pagar uma fatura fora de banda (fora da Stripe), você pode alterar manualmente o [status](https://docs.stripe.com/invoicing/overview.md#invoice-statuses) para `paid` no Dashboard ou na API. #### Dashboard Você pode marcar manualmente uma fatura aberta como paga no Dashboard. Na página de detalhes da fatura, clique no menu de navegação (⋯) e selecione **Alterar status da fatura**. Na caixa de diálogo **Alterar status da fatura**, selecione **Paga**. #### API Para marcar manualmente uma fatura aberta como paga na API, use o parâmetro [paid_out_of_band](https://docs.stripe.com/api/invoices/pay.md#pay_invoice-paid_out_of_band) quando enviar uma solicitação ao endpoint [Pagar](https://docs.stripe.com/api/invoices/pay.md). ### Anular faturas Anular uma fatura é uma ação conceitualmente similar a excluí-la ou cancelá-la. No entanto, a anulação de uma fatura preserva uma comprovação documental contábil, permitindo que você procure a fatura pelo número. Para fins de relatório, uma fatura anulada tem valor zero e não pode ser paga. Esse status é terminal, o que significa que o status da fatura não pode mais mudar. Depois que você anula uma fatura, a [página da fatura hospedada](https://docs.stripe.com/invoicing/hosted-invoice-page.md) ainda fica acessível e exibe uma mensagem indicando que a fatura foi anulada. Você só pode anular uma fatura com status `open` ou `uncollectible`. > Consulte os regulamentos locais para determinar se e como uma fatura pode ser alterada, cancelada ou anulada na jurisdição em que você faz negócios. Pode ser necessário [emitir outra fatura](https://docs.stripe.com/invoicing/integration.md#create-invoice-code) ou [nota de crédito](https://docs.stripe.com/invoicing/integration/programmatic-credit-notes.md). A Stripe recomenda que você consulte um advogado para receber orientações específicas para sua empresa. #### Dashboard Para anular uma fatura pelo Dashboard: 1. Acesse a página **Detalhes da fatura**. 1. Clique no menu de navegação (⋯) e selecione **Alterar status da fatura**. 1. Na caixa de diálogo exibida, selecione **Anular**. #### API Para anular uma fatura pela API: ```curl curl -X POST https://api.stripe.com/v1/invoices/id/void \ -u "<>:" ``` Se você configurou endpoints de [webhook](https://docs.stripe.com/webhooks.md), receberá um evento `invoice.voided` quando uma fatura passar para o status `void`. ### Faturas incobráveis Às vezes, seus clientes não conseguem pagar as contas pendentes. Por exemplo, suponha que você forneça US$ 1.000 em serviços ao seu cliente, mas ele já declarou falência e não tem ativos para pagar a fatura. Por isso, você decide dar baixa na fatura como provavelmente impagável. Neste caso, você pode atualizar o status da fatura para `uncollectible`. Isso permite que você controle o valor devido para fins de relatório no processo de contabilização de dívidas incobráveis. #### Dashboard Você pode marcar uma fatura aberta como incobrável no Dashboard. Na página de detalhes da fatura, clique no menu de navegação (⋯) e selecione **Alterar status da fatura**. Na caixa de diálogo **Alterar status da fatura**, selecione **Incobrável**. #### API Para marcar uma fatura aberta como incobrável usando a API, use o endpoint [Marcar como incobrável](https://docs.stripe.com/api/invoices/mark_uncollectible.md) como mostrado no exemplo a seguir: ```curl curl -X POST https://api.stripe.com/v1/invoices/id/mark_uncollectible \ -u "<>:" ``` Se você configurou endpoints de [webhook](https://docs.stripe.com/webhooks.md), receberá um evento `invoice.marked_uncollectible` quando uma fatura passar para o status `uncollectible`. ## See also - [Usar o Dashboard](https://docs.stripe.com/invoicing/dashboard.md) - [Integrar com a API](https://docs.stripe.com/invoicing/integration.md) - [Transições de status e finalização](https://docs.stripe.com/invoicing/integration/workflow-transitions.md)