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
409stripe_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.paidamb 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) ideauthorization_not_applicable(una desinstal·lació d'una connexió que el compte no fa servir), tots admesos pel filtrediscard_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_rulesilist_stripe_non_invoiced_charges, amb els mateixos scopes que les operacions de sota. Cap necessitaidempotency_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ó | Endpoint | Scope |
|---|---|---|
| Llistar les regles de tractament de cobraments | GET /v1/connected-accounts/{account}/charge-rules | stripe_autoinvoicing:read |
| Crear una regla de tractament de cobraments | POST /v1/connected-accounts/{account}/charge-rules | stripe_autoinvoicing:write |
| Reordenar les regles de tractament de cobraments | PUT /v1/connected-accounts/{account}/charge-rules/order | stripe_autoinvoicing:write |
| Actualitzar una regla de tractament de cobraments | PUT /v1/connected-accounts/{account}/charge-rules/{rule} | stripe_autoinvoicing:write |
| Eliminar una regla de tractament de cobraments | DELETE /v1/connected-accounts/{account}/charge-rules/{rule} | stripe_autoinvoicing:write |
| Llistar els cobraments no facturats | GET /v1/connected-accounts/{account}/non-invoiced-charges | stripe_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
- Comptes connectats — Llistar comptes connectats
i Obtenir un compte connectat
retornen tres camps nous:
connection_method(account_linksostripe_app),authorization_status(authorized,reauthorization_requiredorevoked) idefault_line_concept(nullsi no està definit). Actualitzar un compte connectat acceptadefault_line_concept(d'1 a 255 caràcters;nulll'esborra i ometre'l el deixa com està). Les tools MCP de comptes connectats retornen els mateixos camps. - Esdeveniments d'integració — el filtre
discard_reasonde Llistar esdeveniments d'integració admet els set motius nous, que també apareixen a Obtenir un esdeveniment d'integració.
Les incorporacions són opcionals: una integració que no les envia ni les llegeix continua funcionant igual que abans.