Factuarea APIDevelopers
Contrato

Cuentas de Stripe existentes y reglas de cobro

Conecta una cuenta de Stripe que ya tienes, decide por cuenta qué cobros se facturan y cuáles no, y consulta los cobros que quedaron fuera. Seis operaciones nuevas, tres campos nuevos en las cuentas conectadas y cinco motivos nuevos en la bandeja.

7 de octubre de 2026 — La auto-facturación con Stripe ya funciona con la cuenta de Stripe que usas, y cada cuenta conectada puede decir qué cobros se facturan y cuáles no. Consulta la guía de auto-facturación con Stripe para ver el flujo completo.

  • Conectar una cuenta de Stripe existente — al conectar Stripe puedes elegir entre una cuenta que ya tienes (instalas la Stripe App de Factuarea y la autorizas, sin crear ninguna cuenta nueva) y una cuenta nueva, como hasta ahora. Sin una elección, se aplica el flujo de cuenta nueva. Consulta Conectar una cuenta de Stripe que ya tienes.
  • Una cuenta, una empresa — una cuenta de Stripe solo puede estar activa en una empresa a la vez. Conectar una que está activa en otra empresa se rechaza con 409 stripe_account_linked_elsewhere. Consulta Una cuenta, una empresa.
  • Reglas de tratamiento por cuenta — reglas ordenadas que deciden si un cobro se factura (con su propio concepto y tipo de IVA) o no se factura, con un motivo de una lista cerrada (indemnity_not_subject, multipurpose_voucher, invoiced_elsewhere). Decide la primera regla que coincide. Consulta Cobros que no se facturan.
  • Cobros no facturados — cada cobro que deja fuera una regla queda registrado y se puede listar. Su devolución no crea rectificativa.
  • Concepto de los cobros sin Checkout — la línea única de la factura toma el concepto de la regla, la descripción del PaymentIntent, el concepto por defecto de la cuenta (default_line_concept) o, en último lugar, el texto genérico. Consulta Concepto de los cobros sin Checkout.
  • Facturas sueltas de Stripe — las facturas creadas a mano en Stripe y las que salen de un presupuesto aceptado se facturan desde invoice.paid con sus líneas reales, y un cobro llega a una única factura llegue antes el evento que llegue. Consulta Facturas sueltas de Stripe.
  • Siete motivos nuevos en la bandeja — 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 en Stripe de importe cero o negativo) y deauthorization_not_applicable (una desinstalación de una conexión que la cuenta no usa), todos admitidos por el filtro discard_reason. Consulta el catálogo de motivos.
  • Seis tools MCP nuevas — list_stripe_charge_rules, create_stripe_charge_rule, update_stripe_charge_rule, delete_stripe_charge_rule, reorder_stripe_charge_rules y list_stripe_non_invoiced_charges, con los mismos scopes que las operaciones de abajo. Ninguna necesita idempotency_key.

Las reglas de cobro aplican el tratamiento que configuras. Factuarea no decide si un cobro está sujeto a IVA, así que confirma cada regla con tu asesor.

Operaciones nuevas

Los scopes son los ya existentes stripe_autoinvoicing:read y stripe_autoinvoicing:write; no se añade ninguno.

OperaciónEndpointScope
Listar las reglas de tratamiento de cobrosGET /v1/connected-accounts/{account}/charge-rulesstripe_autoinvoicing:read
Crear una regla de tratamiento de cobrosPOST /v1/connected-accounts/{account}/charge-rulesstripe_autoinvoicing:write
Reordenar las reglas de tratamiento de cobrosPUT /v1/connected-accounts/{account}/charge-rules/orderstripe_autoinvoicing:write
Actualizar una regla de tratamiento de cobrosPUT /v1/connected-accounts/{account}/charge-rules/{rule}stripe_autoinvoicing:write
Eliminar una regla de tratamiento de cobrosDELETE /v1/connected-accounts/{account}/charge-rules/{rule}stripe_autoinvoicing:write
Listar los cobros no facturadosGET /v1/connected-accounts/{account}/non-invoiced-chargesstripe_autoinvoicing:read

Cuatro códigos de error nuevos, todos documentados con su operación: charge_rule_not_found (404), charge_rule_invalid (422), charge_rule_limit_reached (422) y stripe_account_linked_elsewhere (409, al conectar una cuenta desde la aplicación).

Operaciones actualizadas

Las incorporaciones son opcionales: una integración que no las envía ni las lee sigue funcionando igual que antes.

En esta página

¿Te echamos una mano?Contactar con soporte