Factuarea APIDevelopers
Contracte

Comptes de Stripe existents i regles de cobrament

Connecta un compte de Stripe que ja tens, decideix per compte quins cobraments es facturen i quins no, i consulta els cobraments que han quedat fora. Sis operacions noves, tres camps nous als comptes connectats i cinc motius nous a la safata.

7 d'octubre de 2026 — L'auto-facturació amb Stripe ja funciona amb el compte de Stripe que fas servir, i cada compte connectat pot dir quins cobraments es facturen i quins no. Consulta la guia d'auto-facturació amb Stripe per veure el flux complet.

  • Connectar un compte de Stripe existent — en connectar Stripe pots triar entre un compte que ja tens (instal·les la Stripe App de Factuarea i l'autoritzes, sense crear cap compte nou) i un compte nou, com fins ara. Sense una elecció, s'aplica el flux de compte nou. Consulta Connectar un compte de Stripe que ja tens.
  • Un compte, una empresa — un compte de Stripe només pot estar actiu en una empresa alhora. Connectar-ne un que és actiu en una altra empresa es rebutja amb 409 stripe_account_linked_elsewhere. Consulta Un compte, una empresa.
  • Regles de tractament per compte — regles ordenades que decideixen si un cobrament es factura (amb el seu propi concepte i tipus d'IVA) o no es factura, amb un motiu d'una llista tancada (indemnity_not_subject, multipurpose_voucher, invoiced_elsewhere). Decideix la primera regla que coincideix. Consulta Cobraments que no es facturen.
  • Cobraments no facturats — cada cobrament que deixa fora una regla queda registrat i es pot llistar. La seva devolució no crea rectificativa.
  • Concepte dels cobraments sense Checkout — la línia única de la factura pren el concepte de la regla, la descripció del PaymentIntent, el concepte per defecte del compte (default_line_concept) o, en últim lloc, el text genèric. Consulta Concepte dels cobraments sense Checkout.
  • Factures soltes de Stripe — les factures creades a mà a Stripe i les que surten d'un pressupost acceptat es facturen des d'invoice.paid amb les seves línies reals, i un cobrament arriba a una única factura arribi abans l'esdeveniment que arribi. Consulta Factures soltes de Stripe.
  • Set motius nous a la safata — excluded_by_charge_rule, handled_by_stripe_invoice, stripe_authorization_required, stripe_app_uninstalled, refund_of_non_invoiced_charge, stripe_invoice_without_amount (una factura creada a Stripe d'import zero o negatiu) i deauthorization_not_applicable (una desinstal·lació d'una connexió que el compte no fa servir), tots admesos pel filtre discard_reason. Consulta el catàleg de motius.
  • Sis tools MCP noves — list_stripe_charge_rules, create_stripe_charge_rule, update_stripe_charge_rule, delete_stripe_charge_rule, reorder_stripe_charge_rules i list_stripe_non_invoiced_charges, amb els mateixos scopes que les operacions de sota. Cap necessita idempotency_key.

Les regles de cobrament apliquen el tractament que configures. Factuarea no decideix si un cobrament està subjecte a IVA, així que confirma cada regla amb el teu assessor.

Operacions noves

Els scopes són els ja existents stripe_autoinvoicing:read i stripe_autoinvoicing:write; no se n'afegeix cap.

OperacióEndpointScope
Llistar les regles de tractament de cobramentsGET /v1/connected-accounts/{account}/charge-rulesstripe_autoinvoicing:read
Crear una regla de tractament de cobramentsPOST /v1/connected-accounts/{account}/charge-rulesstripe_autoinvoicing:write
Reordenar les regles de tractament de cobramentsPUT /v1/connected-accounts/{account}/charge-rules/orderstripe_autoinvoicing:write
Actualitzar una regla de tractament de cobramentsPUT /v1/connected-accounts/{account}/charge-rules/{rule}stripe_autoinvoicing:write
Eliminar una regla de tractament de cobramentsDELETE /v1/connected-accounts/{account}/charge-rules/{rule}stripe_autoinvoicing:write
Llistar els cobraments no facturatsGET /v1/connected-accounts/{account}/non-invoiced-chargesstripe_autoinvoicing:read

Quatre codis d'error nous, tots documentats amb la seva operació: charge_rule_not_found (404), charge_rule_invalid (422), charge_rule_limit_reached (422) i stripe_account_linked_elsewhere (409, en connectar un compte des de l'aplicació).

Operacions actualitzades

Les incorporacions són opcionals: una integració que no les envia ni les llegeix continua funcionant igual que abans.

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport