Avancement automatique des factures

À moins de désactiver manuellement cette fonction, les factures que vous créez dans le Dashboard sont automatiquement finalisées dès lors qu’elles quittent l’état de projet. En revanche, les factures créées à l’aide de l’API ne sont pas automatiquement finalisées. Vous devez activer l’encaissement automatique en définissant la propriété auto_advance de la facture sur true. Vous devez également configurer un endpoint de webhook afin de recevoir les événements associés. Lorsque vous définissez auto_advance sur false, il vous incombe de faire passer la facture d’un état à l’autre. Pour en savoir plus, consultez la rubrique Endpoints de webhook et finalisation des factures.

Mettre à jour l’avancement automatique

Vous pouvez faire basculer la propriété auto_advance des factures entre draft et open. L’avancement automatique et l’encaissement ne se produisent jamais sur les factures ayant l’attribut uncollectible, void ou paid. Pour ces factures, la propriété auto_advance est toujours définie sur false :

curl https://api.stripe.com/v1/invoices/id \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d auto_advance=false

Suspendre l’avancement automatique

Dans certains cas, vous pouvez vouloir empêcher Stripe de soumettre automatiquement vos factures à l’encaissement. Par exemple, si vous souhaitez :

• Utiliser votre propre logique métier pour gérer le cycle de vie d’une facture.
• Décidez au cas par cas s’il y a lieu d’envoyer des e-mails pour vos factures et à quel moment.

Dans ces deux cas, utilisez la propriété auto_advance pour désactiver le comportement d’avancement et d’encaissement automatique.

Comparaison des fonctionnalités de l’avancement automatique

Lorsque vous définissez auto_advance sur false, Stripe désactive la plupart des fonctions automatiques de Invoicing et vous laisse le soin de procéder au recouvrement. Les grandes différences à noter dans le comportement de l’encaissement automatique selon que auto_advance est défini sur true ou false sont les suivantes :

Légende

• = Peut être activé en fonction de vos paramètres.
• = Configurable dans vos paramètres.
• = Désactivé. La transition d’état de la facture n’est pas automatique.